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,28 @@
# 白宫官网页面 JSON 契约
顶层必须完整包含 `site`、`navigation`、`hero`、`notice`、`updates`、`priorities`、`administration`、`calendar`、`participation`、`footer`。弹窗按十个模块分别编辑,应用时重新校验完整文档。
## 通用规则
- `site.language` 固定为 `zh-CN`。
- 所有标题、标签、摘要、按钮、日期、活动、机构名和页脚等读者可见文案必须使用简体中文;英文来源先翻译后再写入 JSON。
- JSON 键名以及 `id`、`href`、`visual`、`theme` 等技术值按契约保留英文,不要翻译或改名。
- 所有标题、标签、摘要和日期为字符串;关键展示字段不能为空。
- 列表有数量上限,同一业务列表中的 `id` 必须唯一。
- `href` 只允许以 `#` 开头的页面内锚点。
- JSON 文本不能包含 HTML、脚本、直接 iframe 或可执行代码。`hero` 以及具有 `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。
## 模块
- `site`:机构名称、办公室名称、页面标题、描述、语言、`theme`(`light`/`dark`/`auto`)和跳转正文文案。
- `navigation`:左右主导航、菜单/搜索/主题按钮文案;全屏菜单含说明、CTA 和 1–4 个链接列;搜索含标题、占位和结果文案。
- `hero`:主视觉标签、两行标题、摘要、主要 CTA、直播 CTA、简报卡、滚动提示和直播弹窗;`visual` 固定为 `executive-house`。
- `notice`:公告标签、标题、日期和锚点。
- `updates.items`:1–8 条官方动态,`visual` 为 `hall`、`mobility`、`science`、`statement`、`action`;首条自动采用主卡布局。
- `priorities.items`:1–6 个优先事项,每项含标题、摘要和点击后展示的详情。
- `administration`:标题、引语、说明、签名、1–6 个链接和 `portrait` 视觉。
- `calendar.months`:1–6 个月份;每月含 1–8 个日期、月份缩写、标题、说明和标签。
- `participation.cards`:1–6 个公众参与入口,`visual` 为 `visit`、`letter`、`service`;另含订阅标题、说明、占位、按钮和成功提示。
- `footer.columns`:1–4 个链接列,每列 1–8 个锚点;另有机构说明、版权和法律文案。
JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。`assets/default-data.json` 是全中文结构示例和概念内容,不是事实来源。