i18n-auto-translation 的安装和配置教程

项目基础介绍

i18n-auto-translation 是一个开源项目，它可以帮助用户自动翻译 i18n 格式的 JSON 文件到目标语言。这个项目主要用 TypeScript（94.4%）和 JavaScript（5.6%）编写。

项目使用的关键技术和框架

该项目主要使用了以下技术和框架：

• TypeScript/JavaScript：项目的编程语言。
• Yargs：用于解析命令行参数。
• Axios：用于发起 HTTP 请求。
• glob：用于匹配文件路径。
• @google-cloud/translate：Google Cloud Translation API 的官方库。
• 其他：还包括 deep-object-diff、just-extend、html-entities、yocto-spinner 等库。

准备工作

在开始安装之前，请确保您的系统中已经安装了以下环境和工具：

• Node.js：确保您的 Node.js 版本至少为 12.0.0。
• npm：Node.js 的包管理器。

安装步骤

1. 克隆项目

   打开命令行工具，运行以下命令克隆项目：

   git clone https://github.com/while1618/i18n-auto-translation.git
   

2. 安装依赖

   进入项目目录，安装所需的 npm 包：

   cd i18n-auto-translation
   npm install
   

3. 配置项目

   根据您的需求配置项目的配置文件。通常情况下，您可能需要配置翻译 API 提供商的密钥。在项目的 src/translate/providers 目录中，您可以为不同的翻译 API 提供商创建类，并实现相应的 callTranslateAPI 方法。

4. 使用项目

   使用以下命令开始翻译您的 i18n JSON 文件：

   npx i18n-auto-translation -k SUBSCRIPTION_KEY -d PROJECT_DIR -t DESIRED_LANGUAGE
   

   其中 -k 指定您的 API 密钥，-d 指定项目目录，-t 指定目标语言。

请注意，在执行翻译前，您需要根据项目支持的翻译 API 提供商获取相应的 API 密钥，并替换命令中的 SUBSCRIPTION_KEY、PROJECT_DIR 和 DESIRED_LANGUAGE 为实际的值。

按照以上步骤，您应该能够成功安装并配置 i18n-auto-translation 项目，开始自动翻译您的 JSON 文件了。