Files

2.7 KiB
Raw Permalink Blame History

读卖新闻中文页面 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。

{
  "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: 地址。运行时再次校验协议并转义文本,外链使用安全的新窗口属性。