翻译你的 Markdown 文档

只需一条命令，即可在几分钟内翻译文档中的所有 Markdown 文件，并完整保留格式

开始使用

content/docs/en-US/platform/locadex/quickstart.md

  1. ---
  2. title: Quickstart
  3. description: Use Locadex, the AI agent which connects your codebase, translations, and content sources. It’s the fastest way to run General Translation's full-stack localization.
  4. ---
  6. Locadex is the General Translation AI agent which connects your codebase, translations, and content sources.
  8. After setup, Locadex can configure your project and automatically translate it into the languages you choose.
  10. Locadex currently supports **Next.js**, **Mintlify**, **Fern**, and **Docusaurus** projects, along with React applications built with Vite, Gatsby, Redwood, React Router, TanStack Start, Bazel, esbuild, Rollup, Rolldown, or webpack.
  12. ## How Locadex works [#locadex-works]
  14. Locadex works inside your GitHub repository and automatically opens or updates PRs with generated changes. Three automation templates keep your localization up to date:
  16. - **Generate code** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
  17. - **Generate translations and push** translates source content into every target language and updates translation files.
  18. - **Keep locales in sync** updates project files when languages are added or removed.

npx gt translatees, fr, ja

只需几步，即可将文档翻译成任意语言

只需两条命令，无需修改代码，也无需手动配置

  1. 运行初始化设置向导

    在文档代码仓库中运行 npx gt init，选择 Markdown 作为文件格式，然后选择目标语言。

  2. 指定文件位置

    向导会在 gt.config.json 中为你的 .md 文件添加一个 glob 模式，并为每种语言设置一个 [locale] 文件夹。无需修改代码。

  3. 翻译并上线

    运行 npx gt translate，CLI 就会为每个文件生成翻译副本，并保留所有 Markdown 语法和格式。提交翻译后的文件，并随文档站点一起发布。

如何确保每次部署时译文都是最新的？

文字稿

In Montreal, your French page shows the line you added this week in English. Your build script runs next build alone, so the line was never translated. General Translation keeps translations current when your CI runs npx gt translate before the build. Create an API key for CI with the file, context and translation queue permissions. Store it and your project ID as secrets in your CI provider. Add npx gt translate to your build script, before the build command. Run that build on every push to main, for example with a GitHub Actions workflow. Each build then ships current translations in Spanish, Japanese and French.

深受全球顶尖企业信赖

General Translation 打造完整的本地化技术栈，带来顺畅的开发体验

  • 仪表板、落地页和 iOS 支持 11+ 个区域设置

  • 支持网站和文档的 14+ 种区域设置

  • 支持平台和文档的 47+ 种区域设置

  • 支持网站、iOS 和 Android 的 2+ 种区域设置

  • 支持网站和 GTM 的 7+ 种区域设置

  • 开源国际化库
  • 上下文感知翻译
  • 团队审校平台
  • 内容集成
  • Locadex Agent

充分结合上下文，呈现母语级译文

深入理解您的产品，参照整个文档站点核验，提供最高质量的译文

上下文贯穿每个层面

译文遵循您的表达方式和风格规则，准确把握产品的上下文与逻辑。

所有页面保持一致

每个页面都会经过校对，与源文逐一对照，并检查是否与其他页面保持一致。

与团队一起审校和编辑

每一行都可在仪表板中编辑，支持多语言并排对照、历史记录和评论。

持续翻译，紧跟每次更新

在构建文档前运行 npx gt translate，每次运行只翻译有变更的内容，让每次部署都包含所有语言版本

  1. 推送文档更改
  2. 构建时运行 CLInpx gt translate
  3. 仅翻译有变动的内容
  4. 所有语言版本均已部署

连接并本地化您的全套产品

General Translation 将您的代码、内容、译文和审校工作整合到同一平台

文档

常见问题

翻译文档和将文档本地化是一回事吗？

不完全相同。翻译是将内容从一种语言转换为另一种语言。本地化则是软件翻译相关工作的统称，旨在针对各个区域设置适配整个产品。其中包括国际化（i18n），即通过处理路由、导航、日期、货币、复数形式及其他地区惯例，让网站支持多个区域设置。

General Translation 负责本地化与翻译的初始化设置，并提供持续维护。

有关完整的本地化初始化设置，请参阅 Markdown 本地化。

直接用 AI API 翻译文档不就行了吗？

如果只是做一次翻译，可以。但要每周都交付各种语言的可靠文档，就需要围绕模型建立一整套系统。

你的页面不只是文本。MDX 组件、导入语句和代码块必须原样保留，frontmatter 的键不能变，{#configure-client} 这样的标题 ID 也必须保留在对应标题上，以免深层链接失效。

你的文档是一个站点，而不是单个页面。每种语言都需要对应的导航版本，区域设置代码必须符合平台要求，而“workspace”在第 1 页和第 400 页的译法必须一致（在你的应用中也一样，我们也支持应用本地化）。

你的文档每周都在更新。每次更新都应只翻译有改动的内容，保留审校人员的手动修改，并随构建一同提交到代码仓库。日后添加新语言也不应影响已有语言。

团队成员都需要掌握情况并能进行管理：逐行对照源文本与译文，查看历史记录和评论，管理角色，并为每种语言设置语气规则。

General Translation 提供端到端支持，包办上述所有工作。我们为客户处理数以千计的本地化 PRs，让他们能专注于打造深受全球用户喜爱的产品。

我们的译者和审校人员可以编辑译文吗？

可以。审校人员可以在翻译页面并排对照不同语言，直接编辑任意一行，并添加标签、备注和评论。席位数量不限，整个团队都可以参与。

初始化设置需要多长时间？

只需几分钟，无需迁移。运行 npx gt init，选择语言，再运行 npx gt translate，即可开始大规模翻译（Ramp 仅用几分钟就翻译了 40,000 个键，涉及数百万词）。你也可以点击“为智能体进行初始化设置”按钮，将初始化设置交给编程智能体完成。

支持哪些语言？

General Translation 支持 120 多种区域设置，均可选用，包括 pt-BR 和 zh-Hant 等地区变体，以及阿拉伯语和希伯来语等从右向左书写的语言。在 gt.config.json 中列出所需的区域设置，之后可随时添加。请参阅支持的语言区域。

文档变更时，译文会同步更新吗？

会，译文会持续更新。在 CI 中构建文档前运行 npx gt translate。它仅翻译源内容有变更的部分，并保留你的本地修改，确保每次发布时，所有语言版本都能与源内容的变更同步上线。

译文会符合我们的语言风格和术语规范吗？

General Translation 支持通过自定义提示词设定语气和风格，并通过词汇表统一产品名称和关键术语的用法。所有翻译都会一致地应用这些上下文信息，涵盖应用、网站、文档、幻灯片和设计文件。

翻译会破坏我的 Markdown 格式吗？

不会。CLI 会在每个翻译后的文件中保留所有 Markdown 语法和格式，{#id} 等显式标题 ID 也会保留在对应的标题上。

费用是多少？

按用量计费，不收取席位费，无需订阅。Starter 方案的平台费为 $0，项目、用户和语言数量不限，并提供免费起始额度。完整费率请参阅定价页面。

翻译你的 Markdown 文档，让全球读者都能阅读

免费开始使用，无需支付月费

开始使用预约演示