1.0.5 • Published 5 months ago
seasun-translate v1.0.5
Seasun Translate
多语言翻译工具(Seasun Translate, SST)是一个基于百度翻译 API 的命令行工具,用于自动将中文 JSON 文件翻译成多种语言。专为多语言项目设计。
特性
- 🚀 支持一键翻译中文 JSON 文件到多种语言
- 🌍 默认支持繁体中文、英文、日文、韩文
- ⚙️ 可配置的翻译目标语言和文件名
- 🔑 支持百度翻译 API 密钥配置
- 💾 支持全局配置文件
- 🎯 保持 JSON 结构不变,只翻译值
演示
安装
npm install -g seasun-translate
快速开始
- 初始化配置文件:
sst --init
- 编辑配置文件(
sst.config.js
),填入你的百度翻译 API 密钥:
module.exports = {
baiduTranslate: {
appId: '你的百度翻译APP_ID',
secretKey: '你的百度翻译密钥'
},
// ... 其他配置
};
准备好你的中文 JSON 文件(默认名称:
zh-CN.json
)运行翻译命令:
sst
配置文件说明
配置文件支持以下选项:
module.exports = {
// 百度翻译 API 配置
baiduTranslate: {
appId: '你的百度翻译APP_ID',
secretKey: '你的百度翻译密钥',
apiUrl: 'https://fanyi-api.baidu.com/api/trans/vip/translate'
},
// 支持的目标语言配置
targetLanguages: {
'zh-TW': {
name: '繁体中文',
code: 'cht',
fileName: 'zh-TW.json'
},
'en': {
name: '英文',
code: 'en',
fileName: 'en-US.json'
},
'ja': {
name: '日文',
code: 'jp',
fileName: 'ja-JP.json'
},
'ko': {
name: '韩文',
code: 'kor',
fileName: 'ko-KR.json'
}
},
// 源语言文件配置
sourceLanguage: {
fileName: 'zh-CN.json',
code: 'zh'
}
};
命令行选项
--init
: 在当前目录初始化配置文件--config <path>
: 指定配置文件路径
配置文件查找顺序
- 命令行参数指定的路径(如果使用了
--config
选项) - 当前目录下的
sst.config.js
- 用户主目录下的
.sst.config.js
注意事项
- 请确保你的百度翻译 API 密钥有足够的额度
- 建议将配置文件添加到
.gitignore
中 - 翻译请求会自动加入 100ms 的延迟,以避免触发 API 限制
常见问题
Q: 如何修改目标语言?
A: 在配置文件的 targetLanguages
中添加或修改目标语言配置。
Q: 如何修改源文件名?
A: 在配置文件的 sourceLanguage.fileName
中修改。
贡献指南
欢迎提交 Issue 和 Pull Request。
许可证
MIT License