自动翻译

如何使用 General Translation 命令行工具(CLI)自动翻译项目

npx gtx-cli@latest

概览

General Translation 的 CLI(命令行界面)工具(gtx-cli)可将你的项目自动翻译为任意受支持的语言

它为你的项目提供对gt-nextgt-react的一流支持,能够扫描项目中的可翻译内容、执行翻译,并生成翻译数据的 JSON 文件。

该 CLI 工具也可用于为第三方 i18n 库(如next-intli18next)生成翻译。

最后,CLI 工具可用于翻译 JSON、Markdown、MDX、JS 和 TS 文件。

使用 translate 命令需要生产环境 API key。前往 generaltranslation.com 免费获取!


你需要了解两个主要命令:inittranslate

  • init 命令用于设置你的项目。它提供逐步向导, 将为你的项目配置国际化,包括:
  • 设置插件和 React 提供器(providers)
    • 生成 API 密钥
    • 配置项目的语言环境(locales)和文件结构
  • translate 命令用于添加到你的 CI/CD 流水线中。 它用于扫描你的项目以查找需要翻译的内容。 然后将内容上传到 CDN(内容分发网络)或添加到应用的 bundle 中以在运行时使用。

入门

请根据你的项目所使用的 i18n 库,选择以下教程之一:

使用

命令说明
npx gtx-cli init运行 GT 安装向导。
npx gtx-cli configure配置项目的 GT 设置。
npx gtx-cli translate通过 GT API 翻译你的项目。
npx gtx-cli auth为项目生成 API key 和项目 ID。
npx gtx-cli generate生成新的翻译数据 JSON 文件。仅在独立使用该库时使用。

本指南如何?

本页目录