自动翻译
如何使用 General Translation 命令行工具(CLI)自动翻译项目
npx gtx-cli@latest概览
General Translation 的 CLI(命令行界面)工具(gtx-cli)可将你的项目自动翻译为任意受支持的语言。
它为你的项目提供对gt-next和gt-react的一流支持,能够扫描项目中的可翻译内容、执行翻译,并生成翻译数据的 JSON 文件。
该 CLI 工具也可用于为第三方 i18n 库(如next-intl或i18next)生成翻译。
最后,CLI 工具可用于翻译 JSON、Markdown、MDX、JS 和 TS 文件。
使用 translate 命令需要生产环境 API key。前往 generaltranslation.com 免费获取!
你需要了解两个主要命令:init 和 translate。
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 文件。仅在独立使用该库时使用。 |
本指南如何?