用途:把 Docusaurus 文档(MD/MDX 与 i18n JSON)翻译为目标语言,同时保留语法、结构和 Docusaurus 专有组件。
主要能力:按清单(manifest.json)跟踪翻译状态;用术语表保证术语一致;通过提取、重组、校验脚本辅助流程;支持单文件、章节批量、JSON 文件、断点续译和新内容同步等模式。
使用方式:先确认目标语言与范围,读取清单、术语表和翻译规则;对每个 MD/MDX 文件执行:检查清单 → 提取(python scripts/translate_md.py extract <source.md> <segments.json> --lang <code>)→ 人工翻译 → 重组(python scripts/translate_md.py reassemble <source.md> <translated.json> <output.md>)→ 校验(python scripts/translate_md.py validate <source.md> <output.md>)→ 更新清单。JSON 文件需翻译 message 值,保留 description 英文及占位符。前置依赖:pip install markdown-it-py。
适用场景:Docusaurus 站点的多语言文档本地化,尤其是需要保持 MDX 组件与 i18n 结构完整的项目。
限制:实际翻译由使用者完成,脚本仅为辅助;输出必须是目标语言真实文本,不得保留英文或占位符;无法高质量翻译时应停止并告知用户。具体收费、平台支持等信息暂未提供。