博客翻译,SEO 优化的博客翻译
将现有博客文章翻译成一种或多种目标语言。与普通翻译不同,此技能生成的是 SEO 优化、可发布的精良内容,包含本地化关键词、元标签和文化正确的格式。
关键参考
按需加载:
references/translation-rules.md,格式保留、每个区域的数字/日期/货币格式、引号处理、质量标准。references/cultural-adaptation.md,每个区域的文化概况(DACH、法语区、西班牙语区、日语、自定义)。此文件与blog-localize共享(请勿重复)。
工作流程
阶段 1:输入解析
- 读取源文件(markdown、MDX 或 HTML)。
- 自动检测源语言。优先级顺序:
- 前置元数据中的
lang字段。 - HTML 的
lang属性。 - 内容分析(文字脚本、常见停用词)。
- 前置元数据中的
- 从
--to参数中以逗号分隔的 ISO 639-1 代码(de,fr,es,ja,pt-BR)解析目标语言。如果缺少--to,则询问用户一次:“我应该翻译成哪些语言?提供 ISO 639-1 代码(例如 de, fr, es, ja, pt-BR)。” - 验证每个代码。拒绝无效代码并给出建议(
jp变为“你是不是想问ja代表日语?”)。如果目标语言与源语言相同,则跳过并给出提示。
阶段 2:内容分析
提取可翻译的文本:
- 前置元数据:
title、description、tags、author(仅当可翻译时,例如角色标签,而非人名)。 - 所有标题(H1、H2、H3)。
- 正文段落。
- 图片
alt文本和<figcaption>内容。 - 图表
<text>和<tspan>内容;保留所有 SVG 属性(x、y、font-size、fill、transform)。 - 常见问题问答。
- 引用胶囊文本。
- 关键要点或总结框。
- 行动号召(CTA)文本。
- 内部链接区域的锚文本。
保持不变:
- Markdown 和 HTML 结构、标签、属性。
- 图片 URL、链接 URL、前置元数据键。
- 代码块(仅在有意义时翻译内联注释)。
- 内部链接区域标记(
[INTERNAL-LINK: ...])。 - 引用中的源组织名称(Gartner、McKinsey 等)。
- 人名。
- Schema JSON-LD 块(仅翻译面向用户的字符串值)。
识别阶段 3 的主要和次要关键词。
阶段 3:关键词本地化
对于每种目标语言:
- 决定源关键词在目标市场是否为既定术语。如果是(例如,“Content Marketing”在德语中保持不变),则保留。
- 如果本地等效词具有真实搜索行为,则替换为本地词。
- 对次要关键词应用相同逻辑。
- 记录映射。翻译代理使用它来一致地更新标题、元描述和 H2 标题。
阶段 4:翻译
针对每种目标语言启动 blog-translator 代理(通过任务),并携带:
- 源内容。
- 阶段 3 的关键词本地化映射。
- 目标语言代码。
- 指向
references/translation-rules.md的指针,以及如果目标区域有对应配置文件,则指向references/cultural-adaptation.md中的文化概况。
当翻译成多种语言时,并行运行代理。
代理返回与输入格式完全相同的翻译后文章。
阶段 5:后处理
对于每个翻译版本:
- 添加或更新语言前置元数据:
lang: "de" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "wie-man-ki-slop-vermeidet" - 验证结构完整性:
- 与原文具有相同数量的 H2 和 H3 部分。
- 所有图片都存在且带有翻译后的 alt 文本。
- 所有 SVG 图表都存在且带有翻译后的文本标签(长度调整:DE +30%、FR +15%、JA -20%,其他见
references/translation-rules.md)。 - 常见问题数量匹配。
- 每个 H2 部分都存在引用胶囊。
- 保存翻译文件:
当从translations/ {lang}/{localized-slug}.{ext}blog-multilingual调用时,改为保存到multilingual/{lang}/{localized-slug}.{ext}。
阶段 6:翻译质量检查
在报告完成前,检查输出中是否有机器翻译痕迹:
- 字面翻译的习语(英语习语直译,未调整)。
- 不自然的语序(SOV 翻译为 SVO 到非 SVO 语言,反之亦然)。
- 混合语言的句子(除既定借词外)。
- 数字、日期或货币字符串仍为源格式。
- 前置元数据字符串仍为源语言。
内联标记每个问题(文件路径、行号、修复建议)。翻译代理应在交付前重新处理任何被标记的段落。
阶段 7:交付
## 翻译完成:[原标题]
### 源
- 语言:[源语言]
- 文件:[源文件路径]
### 翻译
| 语言 | 文件 | 关键词调整 | 状态 |
|------|------|------------|------|
| de | translations/de/{slug}.md | [N] | 正常 |
| fr | translations/fr/{slug}.md | [N] | 正常 |
### 质量检查
- 结构完整性:通过/失败(按语言)
- 元标签本地化:通过/失败(按语言)
- 数字、日期、货币按区域格式化:通过/失败
- 关键词本地化:[N] 个关键词调整
- 机器翻译痕迹标记:[N](见上方备注)
### 下一步
- 运行 `/blog localize <file> --locale <code>` 进行深度文化适应。
- 运行 `/blog locale-audit translations/` 验证完整性。
- 使用 `/blog multilingual` 在一个命令中完成写作、翻译、本地化和 hreflang。
错误处理
| 场景 | 操作 |
|---|---|
| 不支持的语言代码 | 建议正确的 ISO 639-1 代码 |
| 源语言与目标语言相同 | 跳过并提示“源语言已经是 [lang]” |
| 文件未找到 | 报告错误并建议正确路径 |
| 翻译代理超时 | 重试一次,然后报告部分结果 |
| 二进制或非文本文件 | 报告错误并建议正确的文件 |
交叉引用
- 下一步(文化深度):
/blog localize <file> --locale <code> - 对所有语言版本进行质量检查:
/blog locale-audit <directory> - 一键管道:
/blog multilingual <topic> --languages <codes>