module-translater

module-translater

介绍

用于全局提取项目中文多语言，i8n 国际化翻译脚本。

安装

npm install module-translater --save-dev [-g]

命令参数

translater <env>  options

Arguments:
  env                        指定环境:dev(开发)/test(测试)/prod(生产),默认为开发环境

Options:
  -d, --dir <dir>            指定需翻译的文件夹
  -s, --suffix <value>       指定需翻译的文件名后缀
  -e, --excludes <value...>  指定不需要翻译的文件,可指定多个
  -o, --output <file>        指定输出翻译写入的文件路径,默认为跟目录下,支持js、json, 默认locals.json
  --strict                   是否严格模式, 严格模式只提取$t()内的中文,否则提取全局中文

• env参数详解：
  • dev 是只生成翻译文件，
  • test 是会为每个翻译文件生成后缀前加.lang 的文件，以便查看翻译后对照，
  • prod 则会直接替换翻译原文件，用于生成部署(可放在打包命令之前执行)。

自定义翻译字典

在项目跟目录创建translater.json文件，添加自定义翻译对照，遇到包含中文则会使用指定的 key 作为键 如：

{
  "com_yes": "是",
  "com_no": "否",
  "com_success": "成功",
  "com_fail": "失败",
  "com_enable": "启用",
  "com_disable": "禁用",
  "com_confirm": "确定",
  "com_cancel": "取消",
  "com_add": "新增",
  "com_edit": "编辑",
  "com_modify": "修改",
  "com_delete": "删除",
  "com_save": "保存",
  "com_handle": "操作",
  "com_action": "操作"
}

备注：适用于高频率出现需要的翻译的中文，防止生成过多重复多语言，因为默认 key 为文件名_[中文拼音]，故不同文件相同中文会生成不同的 key。

执行翻译

全局安装

translater --help  // 帮助文档

translater dev --dir src --suffix .vue --excludes test.vue app.vue -o locals/local.json --strict  // 执行翻译

本地安装 （在项目package.json中添加）

  "scripts": {
    "translater": "translater dev -dir src -suffix .vue",
    "translater:test": "translater test --dir src --suffix .vue --strict",
    "translater:prod": "translater prod --dir src --suffix .vue --strict"
  },