翻译
Docsbook 使用十五种语言代码发布您的文档。您无需编写、存储或维护翻译文件：只需启用一种语言，Docsbook 就会直接根据您代码库中已有的 Markdown 翻译页面，为每种语言发布独立的 URL 路径，并在提交更改页面时重新翻译该页面。
机器翻译的文档通常是一种负担——代码标识符被错误翻译、术语在不同页面之间不断漂移、源文档更新后翻译悄然过时，以及本应扩大搜索覆盖范围的本地化 URL 反而损害您的搜索表现。本节余下内容将介绍 Docsbook 的流水线如何分别处理这些问题，以及它目前仍无法处理的部分。
开通一种语言能带来什么#
三件具体的事情，全部都可以自行验证。
一组独立的 URL，使用该语言的查询可以匹配到其中的页面。 每种语言对应一个独立的 URL 路径，以静态 HTML 渲染，列在站点地图中，并拥有自己的 hreflang 条目。无论英文页面的排名多高，都无法匹配西班牙语查询；而西班牙语页面可以。Google 自己的指导意见是，翻译后的页面是让你有资格触达该受众的方式——这不是重复内容问题——而 Docsbook 按页面而不是按站点构建 hreflang 集群，因此它发布的集群是 Google 会接受的形式。相关机制，以及不谨慎操作时导致失败的方式，请参阅翻译质量与 SEO。
使用读者语言进行的站内搜索。 页面翻译后，译文会以该语言代码编入全文搜索索引，而不仅仅是英文原文。使用德语搜索的读者会匹配到德语页面。
助手可以用该语言引用的文档。 爬虫读取的同一份静态 HTML，也是 AI 助手检索的内容。翻译将GEO 覆盖范围扩展到你开通的语言，因为现在已经有了可供引用的该语言页面。
成本#
工作量。启用一种语言只需勾选复选框并确认对话框。无需导出步骤、无需 .po 文件、无需密钥，也无需供应商账户。之后要修改某个具体句子，只需在“翻译”面板中编辑，或调用 upload_translation — 请参阅修正流程。
费用。翻译会消耗项目的 AI 余额；向读者提供已经翻译的页面则不会产生任何费用。页面会按内容哈希拆分为多个部分，因此编辑一个段落只会重新翻译该部分，其余内容则从缓存中复用。Docsbook 会在你确认运行前给出报价，并在余额用尽时停止，而不会超额消费。自动翻译和翻译工作流工具属于付费方案的一部分 — 请参阅定价。
注意力。这是大多数团队最容易低估的成本。技术文案的机器翻译已经足够好，可以发布，但还不够好到可以完全不管：术语漂移和领域术语被过度翻译是有记录的失败模式，而 Google 的垃圾内容政策将未经审核的机器翻译视为对网站的风险，而不是一种中性行为。翻译质量与 SEO说明了 Docsbook 衡量什么、不衡量什么，以及你应当审核哪些内容。
本节内容#
限制与待解问题#
- 十五个语言代码，仅此而已。
en、es、fr、de、pt、it、ru、zh、ja、ko、ar、hi、tr、pl、nl。其中一个是项目自身的源语言，永远不会作为翻译目标——因此，英语项目有十四个目标语言。区域变体（pt-BR与pt-PT、zh-Hans与zh-Hant）不是单独的选项。 - Docsbook 不发布翻译质量评分。 您的页面没有 BLEU、COMET 或人工评分数据，本文档也不对此作出声称。产品衡量的是覆盖率和新鲜度——每种语言有多少页面，以及其中有多少是从源内容的当前版本翻译而来。请根据翻译质量与 SEO中的证据，自行判断“翻译得很好”。
- 自动翻译是一项付费功能，其相关的语言配置也是如此。 免费项目可以看到这些设置，并在连接时自动检测其源语言，但无法更改启用的语言或源语言，无法设置翻译模式，也无法运行翻译任务。请参阅定价。
- 该流水线会翻译您代码仓库中的 Markdown 页面。 它不是 UI 字符串本地化系统，也不会翻译 OpenAPI 规范中的字段描述。