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,52 @@
# 读卖新闻中文页面 JSON 契约
顶层只允许以下十个对象:
`site`、`navigation`、`breaking`、`lead`、`edition`、`features`、`news`、`opinion`、`media`、`footer`。
## 中文内容规则
- `site.language` 固定为 `zh-CN`。
- 品牌罗马字 `YOMIURI ONLINE` 可以保留;其余报头、栏目、标题、摘要、作者、按钮、日期、天气、纸面、视频和页脚文案必须使用简体中文。
- JSON 键名及 `id`、`href`、`visual` 等技术值保持英文;数字、时间、温度、比分和页码可以保持数据格式。
## 模块说明
- `site`:品牌、日期天气、页面信息、字号和订阅文案。
- `navigation`:顶栏、主分类、全屏菜单、搜索和登录弹窗。
- `breaking`:速报主消息及 1–6 条展开新闻。
- `lead`:主头条、1–4 条副头条和 3–8 条新着新闻。
- `edition`:数字报入口和 2–8 个纸面页面。
- `features`:主专题、2–6 条专题卡片和 2–8 条连载。
- `news`:2–6 个分类,每类包含一个主报道和 1–6 条列表新闻。
- `opinion`:社论、专栏、生活教育和文化连载。
- `media`:1–6 个视频与订阅表单。
- `footer`:品牌说明、2–6 个链接列、版权和法律文案。
## 通用限制
- 文本必须是纯文本,不得包含 HTML 或 `javascript:`。远程地址只能放在受校验的 `media` URL 字段中。
- 所有 `href` 必须以 `#` 开头;同一业务数组中的 `id` 必须唯一。
- 页面不加载远程字体、脚本或接口;没有 `media` 时视觉由模板内置 CSS 图形生成。
- JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。
## 可替换媒体
凡是带 `visual` 的内容对象,都可以额外增加一个可选 `media` 对象。省略时继续渲染内置 `visual`。
```json
{
"visual": "transit-hub",
"media": {
"type": "image",
"mediaUrl": "https://example.com/news.jpg",
"alt": "报道现场",
"pageUrl": "https://example.com/story"
}
}
```
- 图片:`{"type":"image","mediaUrl":"https://...","alt":"中文说明","pageUrl":"https://..."}`。`pageUrl` 可选。
- 视频:`{"type":"video","mediaUrl":"https://.../clip.mp4","posterUrl":"https://.../poster.jpg","alt":"中文说明"}`。`posterUrl` 可选。
- 网页:`{"type":"webpage","pageUrl":"https://...","title":"中文标题","description":"中文说明","mediaUrl":"https://.../preview.jpg","embed":false}`。`mediaUrl` 是可选预览图;`embed: true` 会尝试沙箱 iframe,目标网站若禁止嵌入则仍可点击新窗口打开。
- 远程地址只允许 `http://` 或 `https://`;图片和视频也允许对应类型的 `data:` 地址。运行时再次校验协议并转义文本,外链使用安全的新窗口属性。