白皮书 / 长文示例

摘要

本示例展示 long_doc 类型的核心特性：摘要、无限可迭代的章节（每章含标题、正文和可选的引用块）、以及带下一步行动的结论。此类型适合技术白皮书、深度分析报告和长篇文档。

• 章节数量不限，每章独立渲染
• 内置引用块样式（左边框 + 品牌色）
• 结论包含 checklist 式的下一步行动

设计令牌系统

Momo Paper 的设计令牌定义在 _base.html.j2 的 :root 块中，包括颜色（--ink、--brand、--accent 等）、字体（serif/sans/mono 三套）、间距和圆角。所有子模板通过 Jinja2 继承机制自动获得这些令牌。

这种设计的核心优势是：一次定义，全局生效。修改 --brand 的值，所有 30 个模板的品牌色都会同步更新。

路由规则

document_type 字段是路由的核心：用户在 JSON 中声明文档类型，引擎在 DEFAULT_TEMPLATE_MAP 中查找对应的 Jinja2 模板。这种映射关系是 1:1 的——一种类型对应一个模板。

如果需要自定义，可以传入 --template 参数显式指定模板文件名，或通过 --template-dir 指定自定义模板目录。

JSON Schema 校验

每种文档类型都有对应的 JSON Schema 文件（存放在 schemas/ 目录中），定义了 sections 的结构、必需字段和数据类型。Schema 确保了输入数据的一致性，让 AI agent 生成的结构化 JSON 在渲染前就能被验证。

结论

long_doc 是 Momo Paper 中通用性最强的类型之一。它的可迭代章节结构让它适应各种长度的内容——从 3 节的简短报告到 20 节的详细白皮书。

• 尝试用 momo init -t long_doc 生成骨架
• 在 JSON 中为每个章节添加 heading 和 body
• 可选添加 quote 对象来高亮重要观点