sync update from LAN repo (source dhk-1 @ 3b1ec5b4)

This commit is contained in:
gozeros committed 2026-11-05 10:56:34 +08:00
1 parent da6521b6cb
commit 264e2200d6
995 files changed
+148105 -13399

No files matched your search

@@ -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 时才加载对应媒体。
- 内容数组有上限,校验脚本报错时以报错字段为准。