跳到主要内容

翻译

备注

从 v1.20.0 开始，translate 命令已从 @logto/cli 中移除，并作为独立的 @logto/translate 包在 Logto monorepo 中维护。请参考 translate CLI 获取更多详情。

使用 CLI 管理 i18n 翻译。这些命令适用于想要为 Logto 做出贡献的开发者。如果你只是想使用自定义翻译的 日志 (Logto)，请参考 本指南。

同步键​

假设我们对 phrases 包的 en 文件夹中的翻译键进行了一些更改。我们想将这些更改同步到 pt-BR 文件夹。运行以下命令以同步翻译键和文件结构：

pnpm cli translate sync-keys --target pt-BR

此命令将从源语言文件夹（默认情况下为 en）读取所有翻译键，并将其同步到目标语言文件夹（在此示例中为 pt-BR）。

  • 如果目标语言文件夹不存在，将自动创建；
  • 如果目标语言文件夹已存在，将更新新键并删除过时的键。

对于每个翻译键：

  • 如果目标中缺少某个键，将添加该键并附上注释以指示该短语未翻译（标记为 /** UNTRANSLATED */）；
  • 如果基线中缺少某个键，将从目标中删除该键；
  • 如果基线和目标中都存在某个键，将使用目标的值。

要同步 phrases 包中所有语言的键，运行以下命令：

pnpm cli translate sync-keys --target all

因此，我们可以专注于更新源语言文件夹中的翻译键，而其他语言的翻译键将自动更新。

信息

此命令默认对 phrases 包执行。你可以通过 --package 选项指定包名。例如，使用 --package phrases-experience 同步 phrases-experience 包的键。

同步键后，我们可以使用 ChatGPT API 翻译这些键。

使用 ChatGPT 翻译键​

运行以下命令以使用 ChatGPT 翻译键：

pnpm cli translate sync

此命令将翻译 phrases 和 phrases-experience 包中所有未翻译的键（标记为 /** UNTRANSLATED */）。注意，运行此命令需要环境变量 OPENAI_API_KEY。