sync update from LAN repo (source master @ ca48c4ec)
This commit is contained in:
1 parent
8bc8b0e082
commit
ea9dcff9c0
873 files changed
+107866
-14011
No files matched your search
+30
@@ -0,0 +1,30 @@
|
||||
# 马尼拉时报页面 JSON 契约
|
||||
|
||||
顶层只允许以下十个对象,任何模块都不能删除:
|
||||
|
||||
`site`、`navigation`、`ticker`、`lead`、`pulse`、`regions`、`opinion`、`sections`、`media`、`footer`。
|
||||
|
||||
## 模块说明
|
||||
|
||||
- `site`:`brandPrefix/brandAccent/kicker/tagline/dateLabel/editionLabel/pageTitle/description/language/skipLabel/theme/weather[]`。`theme` 为 `light|dark|auto`;天气项含唯一 `id`、`city/temp/condition`。
|
||||
- `navigation`:`menuLabel/searchLabel/themeLightLabel/themeDarkLabel/utilityLeft[]/utilityRight[]/primary[]/drawer/search`。所有链接只允许 `#锚点`。
|
||||
- `ticker`:`label/text/time/href`。
|
||||
- `lead`:`datelineLeft/datelineRight/main/sideStories[]/feeds[]`。头条和侧栏含 `id/kicker/title/summary/byline/time/visual`;feed 含唯一 `id`、`label` 和新闻项。
|
||||
- `pulse`:`label/title/items[]`,指标项含唯一 `id`、`label/value/change/direction`,`direction` 为 `up|down|flat`。
|
||||
- `regions`:`eyebrow/title/moreLabel/moreHref/tabs[]`。每个标签含唯一 `id`、`label`、`feature` 和 `items[]`。
|
||||
- `opinion`:`eyebrow/title/summary/columns[]`,专栏含唯一 `id`、`initial/name/title/summary`。
|
||||
- `sections`:`business/sports/market`。商业卡片使用 `market|factory|shipping`;体育视觉使用 `basketball|running|volleyball`。
|
||||
- `media`:`watch/edition/newsletter`。视频视觉使用 `studio|islands|city-night`;数字报页含唯一 `id`、`label/headline/text`。
|
||||
- `footer`:`description/columns[]/copyright/legal`。
|
||||
|
||||
## 通用限制
|
||||
|
||||
- `site.language` 固定为 `zh-CN`。
|
||||
- 所有报头、栏目、标题、摘要、作者、按钮、日期、地区、活动和页脚等读者可见文案必须使用简体中文;英文或菲律宾语来源先翻译后再写入 JSON。
|
||||
- JSON 键名以及 `id`、`href`、`visual`、`direction`、`theme` 等技术值按契约保留英文,不要翻译或改名;数字、时间、百分比和货币值可以保持数据格式。
|
||||
- 文本必须是纯文本,不得包含 HTML 或 `javascript:`。具有 `visual` 的对象可增加 `media` 替换视觉:图片 `{type:"image", mediaUrl, alt?, pageUrl?}`;视频 `{type:"video", mediaUrl, posterUrl?, alt?, pageUrl?}`;网页 `{type:"webpage", pageUrl, title, description?, mediaUrl?, embed?}`。仅这些媒体 URL 字段允许 `http(s)`,图片/视频也允许对应的 `data:` URL。
|
||||
- 所有 `href` 必须以 `#` 开头。
|
||||
- 同一数组中的 `id` 必须唯一。
|
||||
- 页面不加载远程字体、脚本或接口;默认视觉由模板内置 CSS 图形生成,只有明确提供受校验媒体 URL 时才加载对应媒体。
|
||||
- 内容数组有上限,校验脚本报错时以报错字段为准。
|
||||
|
||||
Reference in new issue
Block a user