# 阅读格式 1.0.0

一个文章包包含 `index.html`、`source.md`、`meta.json`，发布前另加 `review.json`。导入现有 HTML 时保留 `original.html`。文件夹名与元信息 `id` 一致，使用小写英文、数字和短横线，地址为 `/articles/<id>/`。

元信息：`id`、`title`、`summary`、`tags`、`updatedAt`（带时区的 ISO 8601 时间）、`templateVersion`（当前 `1.0.0`）。以原文语言为主，不要求双语。更新时间填写实际修改时间，不伪造来源日期。

## 阅读外观

- 白底、深蓝文字、正文最大宽度约 760px。中文系统字体，18px 正文，1.9 行高；手机 16px。
- 一篇一个 h1；正文从 h2 开始，h3 表示小节。章节自动生成目录，桌面右侧显示，手机可折叠。
- 标题下显示摘要、标签、更新时间。引用保留原链接，来源集中在文章末尾。
- 代码用 pre/code，长行局部滚动；表格也只在自身容器内滚动。图片加说明与替代文本。
- 公式优先内联 MathML；需要数学渲染库时打包依赖，检查离线可用。不得只贴不能显示的 LaTeX 文本冒充渲染结果。
- 交互放在 `.interactive` 容器，给出简短操作提示。保留可访问标签、键盘操作、响应式尺寸和原有计算逻辑。

## 独立文件约定

模板中的 `{{ARTICLE_CSS}}`、`{{ARTICLE_JS}}`、`{{CONTENT}}`、`{{META_JSON}}` 等槽位由组装脚本填充。交付的 `index.html` 中不能残留槽位；它应能通过浏览器直接打开。外部网站引用可以保留为普通链接，但页面资源不能依赖外部 URL。禁止 iframe 远程嵌入、表单上送与文章内网络请求；需要服务端连接的交互先说明，另行设计。

私有站点的文章响应会隔离脚本来源并限制网络请求。使用本地存储、远程 API 或外部字体的原页面，需要改为自包含实现并验证。