> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/gitbook-agent/translations.md).
# 翻译
{% hint style="info" %}
仅 [组织管理员](/docs/documentation/zh/xie-zuo/member-management/roles.md#admin) 可以创建和访问翻译，因为这是 [一项计费功能](#pricing).
{% endhint %}
自动翻译可以让你以最少的人工操作，轻松让文档保持多语言同步更新。你可以将某个章节创建为另一章节的翻译，其余部分交给 GitBook Agent 处理。
## 翻译如何运作
* **创建一个翻译章节：** 将一个新章节设置为现有章节的翻译。选择你的源章节和目标语言。
* **持续更新：** 每当你修改源内容时，翻译工作流只会运行于 **已更改的页面**.
* **自动同步：** 在更改合并后，翻译工作流 **会自动运行** 并与其源内容同步，因此你的翻译章节始终反映最新更新。
{% hint style="info" %}
自动翻译章节中的页面 slug 可能会更改，除非页面具有固定 slug。为了让各语言的 URL 保持稳定，请在翻译前设置固定 slug。要更新 slug，请参见 [我如何更改 URL 中的 slug？](https://app.gitbook.com/s/Ua3kTfM3iWAoECzM0u90/published-documentation/custom-domains/how-can-i-change-the-slug-in-the-url)
{% endhint %}
## 设置自动翻译
要将一个章节翻译成新语言，请返回你的组织 **主页** 并点击 **翻译** 在侧边栏中，然后点击 **创建翻译**.
在 **创建翻译** 弹窗，选择一个：
* **源** —— 你想要翻译的章节
* **从** 语言
* **收件人** 语言
点击 **创建** 以开始翻译工作流。这些选项将用于将你的章节翻译为组织中的一个重复的、已翻译的章节。
该 **翻译** 该页面还列出你已配置的翻译工作流，包括其状态、源、运行情况，以及已翻译的页面和字数。每当源内容更新时，工作流都会重新运行。
### 高级配置
点击 **显示高级说明** 中的 **创建翻译** 弹窗来配置这些选项。
**自定义 AI 指令：** 添加高级指令来引导 AI 的语气、风格或其他偏好。这有助于确保你的翻译符合品牌或受众。
{% hint style="info" %}
在翻译工作流中添加自定义指令会很有帮助，但在某些情况下会受到限制。
自定义指令不能用于在翻译后的章节中创建新元素、添加额外文本或更改源内容结构。
{% endhint %}
**术语表支持：** 定义术语表以控制特定术语的翻译方式。这能让所有受支持语言的术语保持一致。
你的术语表词条必须与要控制的源语言措辞一致。GitBook 会在翻译运行期间应用它们，以保持术语一致。
例如，如果你的源语言是英语，而你的术语表包含 `SSO` → `SSO` 并 `Git Sync` → `Git Sync`，那么像“Set up SSO with Git Sync”这样的句子在翻译结果中会保留这些术语不变。
{% hint style="warning" %}
**更改你的术语表将触发内容的完整重新翻译**。目前没有变通方法：我们无法可靠地检测哪些页面可能包含术语表关键词，因此最稳妥的做法是重新翻译所有页面。因此，更新术语表可能会耗费大量时间和成本。
{% endhint %}
## 为变体添加翻译
创建翻译后，你将能够将其作为 [变体](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-structure/variants.md)添加到已发布的文档站点。这将允许用户在查看主文档站点时在右上角切换语言。
{% hint style="info" %}
为了给你的用户提供最佳体验，你可以在设置变体时设置其默认语言。
在设置变体时添加翻译章节的语言是最佳实践。
{% endhint %}
要为翻译设置一个新变体，请从以下位置打开结构编辑器 **站点结构**，在 **常规** 位于站点侧边栏中。
## 定价
翻译是付费附加功能。我们会按照你主订阅相同的月度或年度周期计费。
* 月费：每月 25 美元，每月最多 50,000 个翻译字
* 年费：每年 250 美元，每月最多 50,000 个翻译字
* 每额外 1,000 个词 0.20 美元
每月额度会在每月初重置。0.20 美元的费率适用于每增加的 1,000 个词，包括年度订阅。
“月度”描述的是费率和字数额度，并不是计费周期。
在你的首次翻译中，每个词都会计入账单。之后，只有 **页面** 包含新词或更新词的部分才会收费。例如，如果你之后编辑文档，只有包含新词的页面才会计入你的字数上限——整个文档不会重新计费。
{% hint style="warning" %}
在处理多个包含大页面的翻译时要小心，因为翻译字数包含任何发生更改的页面中的所有词——这意味着如果大页面中只更改了少量词，整页都会重新翻译。
{% endhint %}
## 常见问题
为什么使用自动翻译？
* **轻松实现多语言文档：** 无需手动翻译即可触达全球受众。
* **智能更新：** 只有更改过的页面会被重新翻译，从而节省时间和资源。
* **完全掌控：** 通过高级指令和术语表管理来自定义翻译。
我可以编辑翻译吗？
你目前无法编辑翻译。
由于翻译是对源内容的纯转换，我们无法将翻译结果中可能做出的编辑与新的翻译进行协调。
为了解决这个问题，我们建议如下流程：
* 使用术语表定义你希望 AI 使用的特定翻译
* 使用自定义指令对输出进行迭代
我需要创建多少个翻译？
你只应创建 **每种语言一个翻译工作流** 用于任何给定源内容。创建多个工作流会在你的组织中产生额外且重复的成本。
目前有哪些限制？
* 翻译不会自动本地化你变体中的 UI 元素。打开 **Customize**，在 **工具** 在站点侧边栏中，以 [本地化界面](/docs/documentation/zh/guan-li-ni-de-zhan-dian/customization/extra-configuration.md#localize-user-interface) 用于 [特定变体](/docs/documentation/zh/guan-li-ni-de-zhan-dian/customization.md#customizing-sites-with-multiple-sections-or-variants).
* 这包括用户输入的自定义内容，例如公告横幅。
* 翻译无法向页面添加额外内容——例如提示或说明该页面由 AI 翻译的横幅。可以考虑在翻译章节中添加一个额外页面来说明这一点，或者在你的站点变体中添加 [公告横幅](/docs/documentation/zh/guan-li-ni-de-zhan-dian/customization/layout-and-structure.md#announcement-premium-and-ultimate) 。
* 更改术语表会触发所有页面的完整重新翻译，这可能会增加处理时间和成本。目前没有基于术语表使用情况进行部分重新翻译的方案。
如果你需要入门帮助，或想了解更多关于配置自动翻译的信息， [请联系我们的支持团队](broken://pages/04cf2dcac6d338e981b70bca3ec8785a595da022).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/zh/gitbook-agent/translations.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.