Files

2.7 KiB
Raw Permalink Blame History

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