json-translator

项目介绍：json-translator

json-translator 是一个免费的 AI 工具，专门用于翻译 JSON 和 YAML 文件或 JSON 对象。它的主要目标是让用户以简单且免费的方式将数据文件翻译成不同的语言。

主要功能

json-translator 提供多种翻译模块支持，让用户可以根据不同需求选择合适的翻译服务。以下是支持的翻译模块：

• Google Translate 和 Google Translate 2：无需付费即可使用。
• Microsoft Bing Translate：同样提供免费服务。
• Libre Translate 和 Argos Translate：也不需要额外费用。
• DeepL Translate：需要 API 密钥（DEEPL_API_KEY），可以选择使用 API URL。
• gpt 系列（包括 gpt-4o、gpt-3.5-turbo、gpt-4 和 gpt-4o-mini）：需要 OPENAI_API_KEY。

安装方法

用户可以通过 npm 安装 json-translator ：

npm i @parvineyvazov/json-translator

如需全局使用 CLI 功能，可以执行以下命令：

npm i -g @parvineyvazov/json-translator

CLI 使用方法

用户可以使用命令行界面 (CLI) 来进行文件翻译。使用很简单，只需输入以下命令：

jsontt <your/path/to/file.json>

替代 JSON 文件的路径也可使用 YAML 文件：

jsontt <your/path/to/file.yaml/yml>

示例命令：

• 使用 Google Translate 翻译 JSON 文件：

jsontt <your/path/to/file.json> --module google --from en --to ar fr zh-CN

• 指定输出文件名：

jsontt <your/path/to/file.json> --module google --from en --to ar fr zh-CN --name myFiles

包使用方法

除了 CLI，json-translator 还支持在代码中调用。用户可以在 JavaScript 或 TypeScript 项目中引入此库，从而在程序内进行翻译。以下是一些基本用法的示例：

翻译单词或句子：

const translator = require('@parvineyvazov/json-translator');

const my_str = await translator.translateWord(
  'Home sweet home!',
  translator.languages.English,
  translator.languages.Chinese_Simplified
);

翻译 JSON 对象：

const en_lang = {
  login: {
    title: 'Login {{name}}',
    email: 'Please, enter your email',
  }
};

let es_lang = await translator.translateObject(
  en_lang,
  translator.languages.English,
  translator.languages.Spanish
);

翻译 JSON 文件：

let path = 'C:/files/en.json';
await translator.translateFile(path, translator.languages.English, [
  translator.languages.German,
]);

特点与优势

• 全面的翻译模块支持：包括多种流行翻译服务及高级别语言模型。
• 支持深层对象翻译：即支持复杂嵌套的 JSON 结构。
• 多语言同步翻译：用户可以一次性将数据翻译为多种语言。
• 自动忽略特定模式：如 URLs 或用特定格式标记的占位符，确保内容不会被误翻译。

项目发展计划

json-translator 计划在未来推出浏览器支持、更多的翻译模块，以及额外增强的功能保障和用户体验优化。

这个项目采用 MIT 许可开源，欢迎开发者通过 GitHub 贡献代码或反馈建议，帮助改善和丰富项目功能。