gem-hunter

rollup-plugin-i18n-auto

优点

// 源码 example.js
const test = '你好'

// 经过工具转化后，源码变成
import i18n from '/src/i18n/index.js'

const test = i18n.global.t('0')

// 生成了一份JSON文件，里面的内容是：
{
  "0": "你好"
}

// 生成了指定国家的语言包，也是JSON文件，里面内容是：
{
  "0": "Hello"
}

// 还能生成一份映射文件
{
  "example.js": {
    "0": {
      "value": "你好",
      "count": 1
    }
  }
}

demo

Install

npm i rollup-plugin-i18n-auto

yarn add rollup-plugin-i18n-auto

pnpm add rollup-plugin-i18n-auto

Usage

// vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
// 引入该工具包
import i18nAuto from 'rollup-plugin-i18n-auto'

export default defineConfig({
  plugins: [
    vue(),
    // 这里是一个最简单的配置情况，针对所有的js 和vue文件，找出其中的中文，进行替换成i18n.global.t('xxx')的形式。
    // 同时会在代码中添加 import i18n from '/src/i18n/index.js'
    // 并且自动生成了本地词条的JSON配置文件，并且自动进行了翻译成英文配置文件
    i18nAuto({
      include: ['**.js', '**.vue'], // 针对什么文件进行国际化词条
      i18nCallee: 'i18n.global.t', // 对需要进行国际化的词条进行转换的函数名
      dependency: { // 对需要进行国际化的词条进行转换的函数的引入依赖
        name: 'i18n',
        value: '/src/i18n/index.js'
      },
      translate: {
        on: true, // 开启自动翻译
        secretId: 'your secretId', // 若开启自动翻译，需要腾讯机器翻译的你的用户secretId
        secretKey: 'your secretKey' // // 若开启自动翻译，需要腾讯机器翻译的你的用户secretKey
      }
    })
  ],
})

注意

仅自动翻译

i18nAuto({
  include: ['**.js'], // 针对什么文件进行国际化词条
  output: {
    generate: false // 不生成代码词条配置文件
  },
  transform: false, // 不转译源码
  translate: {
    on: true, // 开启自动翻译
    secretId: 'your secretId', // 若开启自动翻译，需要腾讯机器翻译的你的用户secretId
    secretKey: 'your secretKey' // // 若开启自动翻译，需要腾讯机器翻译的你的用户secretKey
  }
})

仅自动生成词条配置文件

i18nAuto({
  mode: 'serve', // 开发环境中就必须得写serve，否则可不写或写build
  include: ['**.js'], // 针对什么文件进行国际化词条
  output: {
    generate: true // 生成代码词条配置文件，默认为true，不写也可以
  },
  transform: false // 不转译源码
})

仅自动转换源码

i18nAuto({
  include: ['**.js'], // 针对什么文件进行国际化词条
  exclude: ['src/i18n/index.js'], // 排除某个文件，一般国际化依赖的文件需要排除掉的，即下方的dependency.value
  output: {
    generate: false // 生成代码词条配置文件，默认为true，不写也可以
  },
  i18nCallee: 'i18n.global.t', // 例子
  dependency: {  // 例子
    name: 'i18n',
    value: '/src/i18n/index.js'
  },
  transform: true // 转译源码，不写也可以，默认是true
})

// 源码
const test = '你好'

// 经过工具转化后
import i18n from '/src/i18n/index.js'

const test = i18n.global.t('0')

// 0 是 '你好' 的 key {"0": "你好"}

仅生成映射文件

i18nAuto({
  mode: 'serve', // 开发环境中就必须得写serve，否则可不写或写build
  include: ['**.js'], // 针对什么文件进行国际化词条
  output: {
    generate: false // 生成代码词条配置文件，默认为true，不写也可以
  },
  transform: false, // 转译源码，不写也可以，默认是true
  sourceMap: true // 生成映射文件
})

各种组合情况

配置表