next-intl

自动翻译你的next-intl项目(<5分钟)

概述

本教程将向你展示如何自动管理你的next-intl项目中的翻译文件。

我们将遵循以下4个步骤:

添加你的环境变量

安装gtx-cli

使用gtx-cli init命令初始化你的项目

提示: 使用<T> 组件可以避免使用翻译文件的麻烦。


步骤1:添加你的环境变量

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

.env
GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

步骤2:安装gtx-cli

在你的项目中安装gtx-cli工具。

npm i --save-dev gtx-cli

步骤3:使用gtx-cli init命令初始化你的项目

运行gtx-cli init命令来配置你的项目。

npx gtx-cli init

步骤4:将gtx-cli translate命令添加到你的构建过程中

在构建命令之前,将gtx-cli translate命令添加到你的构建或CI过程中,以自动为你的项目添加翻译。

package.json
{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <your build command>"
  }
}

这将为你的所有语言环境生成翻译并将它们保存到你的项目中。 如果你想将这些文件提交到你的代码库,你可以在提交之前运行此命令。

完成了!现在,每当你的项目发生变化时,你的项目将自动更新所有翻译JSON文件。


注意事项

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

下一步

  • 查看CLI工具的使用指南
  • 如果你想在开发中看到实时翻译(类似热重载),请查看<T> 组件

在本页面