i18n-cli 项目常见问题解决方案

i18n-cli 项目常见问题解决方案

i18n-cli A CLI tool that utilizes the OpenAI API to translate JSON-based locale files 项目地址: https://gitcode.com/gh_mirrors/i1/i18n-cli

1. 项目基础介绍和主要编程语言

i18n-cli 是一个开源命令行界面（CLI）工具，它利用 OpenAI API 来翻译基于 JSON 格式的本地化文件。这个项目可以帮助开发者轻松地将本地化文件从一种语言翻译成另一种语言，从而支持多语言应用程序的快速开发。

项目主要使用的编程语言是 Go。

2. 新手使用时需特别注意的3个问题及解决步骤

问题一：如何安装 i18n-cli

问题描述： 新手在使用前不知道如何正确安装 i18n-cli。

解决步骤：

1. 确保已安装 Go 环境。
2. 打开终端（命令行），执行以下命令来安装 i18n-cli：

   go install github.com/pandodao/i18n-cli@latest
   

3. 安装完成后，可以通过输入 i18n-cli 命令来检查是否正确安装。

问题二：如何设置 OpenAI API 密钥

问题描述： 使用 i18n-cli 进行翻译时，需要设置 OpenAI API 密钥，但新手不清楚如何操作。

解决步骤：

1. 在终端中，设置环境变量 OPENAI_API_KEY，将你的 OpenAI API 密钥作为值。例如：

   export OPENAI_API_KEY=YOUR_API_KEY
   

   请将 YOUR_API_KEY 替换为你的实际 API 密钥。

2. 确保在执行 i18n-cli 命令前已经设置了该环境变量。

问题三：如何进行翻译

问题描述： 新手不知道如何使用 i18n-cli 进行翻译。

解决步骤：

1. 准备好你的 JSON 格式的本地化文件。

2. 在终端中，执行以下命令来启动翻译过程：

   i18n-cli translate --dir /locales --source /locales/en-US.json --independent /locales/independent.json
   

   其中，--dir 指定本地化文件所在的目录，--source 指定源语言文件，--independent 指定独立语言文件。

3. i18n-cli 会读取包含本地化文件的目录，从 OpenAI 获取翻译，然后将翻译后的内容写回相同的文件。

注意：如果需要翻译特定的值，可以在字符串前添加 " " 来标记。如果要从文件中删除某个键/值对并生成新的翻译，可以直接从 JSON 文件中删除该键/值对。

i18n-cli A CLI tool that utilizes the OpenAI API to translate JSON-based locale files 项目地址: https://gitcode.com/gh_mirrors/i1/i18n-cli