Blog Post Localizer

Front Matter 规则

• 保持与作为结构基线的源文章相同的 front matter 字段集合和整体顺序。
• 在需要时翻译 title、description 以及其它面向读者的文本字段。
• 除非现有目标语种文件已经明确体现出仓库需要语言特化值，否则保持非语言型字段不变。
• 保留布尔值、日期、slug、图片文件名和功能开关，除非同目录其它语种文章明确体现出有意的语言差异。

多源参考规则

• 当存在多个非目标语种文件时，编辑前先全部阅读。
• 把它们视为同一篇文章的平行见证，而不是彼此独立的文章。
• 在处理歧义时，优先采用多个源语言共同表达的内容。
• 如果某个源版本更完整、另一个更流畅，可以综合使用，以产出更忠实的目标语种文章。
• 如果多个源版本在内容上存在实质冲突，先停下来询问用户哪个语种版本应作为权威来源。

保真检查清单

在写出最终文件前，确认以下事项：

• 目标文件仍位于同一个文章目录内。
• markdown 结构与源文章逐节对应。
• 每个 shortcode 和 HTML 块都仍然存在，且除可见文本翻译外，其参数保持不变。
• 每个本地资源引用仍然指向同一个文件名。
• front matter 仍包含预期字段和对格式敏感的值。

项目说明

在这个仓库里，如果文章位于 content/posts/ 下，编辑前先阅读 references/project-conventions.md。