管理语言环境

概述

本文档提供了在您的 Next.js 应用程序中使用 gt-next 管理语言环境的指导。 我们将逐步介绍如何配置您想要支持的语言环境列表，然后触发翻译的生成。

此库使用 BCP-47 标准 来定义语言环境。 查看当前支持的语言环境列表 这里。

配置语言环境

有两种方法可以更改生产环境的语言环境：

1. CLI 工具
2. gt.config.json 文件（推荐）

为了执行翻译，您必须将翻译命令添加到您的构建脚本中：

{
  "scripts": {
    "build": "npx gtx-cli translate && next build"
  }
}

这将根据您的配置生成必要的翻译，并将其存储在云端或本地文件系统中。

使用 CLI 工具管理语言环境

管理语言环境的最简单方法是通过使用 --locales 标志在 npx gtx-cli translate 命令中指定它们。

{
  "scripts": {
    "build": "npx gtx-cli translate --locales en-US zh jp && <YOUR_BUILD_COMMAND>"
  }
}

这将为中文（zh）和日文（jp）生成翻译。

使用 gt.config.json（推荐）

管理语言环境的更强大方法是使用 gt.config.json 文件。 您可以使用 locales 属性指定您想支持的语言环境列表。

{
  "locales": ["zh", "jp"],
}

白名单语言环境

作为一个可选功能，您可以添加一个白名单语言环境列表。 这可以通过仪表板下的项目语言环境页面访问。 如果您启用此功能，任何尝试使用非白名单语言环境调用 npx translate 的操作都将失败。

注意事项

• 您可以通过仪表板、gt.config.json 文件或 CLI 工具来管理语言环境。
• 使用 gt.config.json 或 CLI 工具管理语言环境将禁用仪表板中的 管理语言环境 功能。

下一步

• 了解 Locale Strings 参考中的语言环境语法。