261 篇文档、6 种语言、1 个维护者：frontmatter 是唯一的真相来源
来源：dev.to — 2026-07-24
📋 概述
作者独自维护着一个 PHP 框架 NENE2，其文档有 261 篇英文指南，每篇翻译为 5 种语言（日语、法语、中文、德语、葡萄牙语），共计 1566 个文件。核心管理策略：YAML frontmatter 是唯一真相来源，所有索引从磁盘文件自动重新生成，索引漂移变成 CI 构建失败而非手工维护的负担。
🔑 核心要点
- 261 篇英语指南 × 6 种语言 = 1566 个文件，由 1 人维护
- 核心原则：禁止手工编辑索引——所有索引从磁盘文件自动重新生成
- 每篇英文指南的 YAML frontmatter 包含 title、category、tags、difficulty、related、ft 六个字段
- category 固定为 7 个预定义分类，违规则 CI 失败
- 翻译同步机制：frontmatter 不变，正文翻译——分类和标签保持跨语言一致
- 将索引漂移转化为 CI 红灯而非手工核对——文档工程化的最佳实践
💡 金句
6 篇文档时这不重要。261 篇 × 6 种语言时这就是致命的。所以我定下的规则很简单：禁止手工编辑任何索引。每个索引都从磁盘文件重新生成。
👍 0
👎 0
← 返回 Dev.to 首页