概览

本教程将演示在使用 gt-next 或 gt-react 时，如何自动管理项目的翻译文件。

我们将按以下 4 个步骤进行：

步骤 1：添加环境变量

将生产环境的 API key 和项目 ID 添加到环境变量中。 这对于使用 gtx-cli 工具是必需的。 这些信息可在 General Translation 仪表板 获取。

GT_API_KEY=<你的 API 密钥>
GT_PROJECT_ID=<你的项目 ID>

步骤 2：使用 npx gtx-cli configure 命令配置项目

运行 gtx-cli configure 命令以配置项目。

npx gtx-cli configure

步骤 3：将 gtx-cli translate 命令加入构建流程

在执行构建命令之前，将 gtx-cli translate 命令加入你的构建或 CI 流程，以自动把翻译注入到项目中。

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <你的构建命令>"
  }
}

这将为你所有的 locale 生成翻译，并将其保存到项目中。 如果你想把这些文件提交到代码仓库，可以在提交前先运行此命令。

完成！现在，每当项目发生变更时，系统都会自动更新所有翻译用的 JSON 文件。

注意事项

• 你可以使用 gtx-cli translate 命令将译文自动添加到项目中。
• 如果你想提交翻译文件，也可以在提交之前运行 gtx-cli translate 命令。
• 若要配置译文的输出路径，请参阅配置文档。

后续步骤

• 查看该 CLI 工具的使用指南。