unplugin-sheet-i18n

unplugin-sheet-i18n

unplugin-sheet-i18n enables doing your i18n in a [spread]sheet for a better collaborative experience with non-coders and maintainability.

Features

• Supports CSV, DSV, Excel/Spreadsheets (XLS[XMB], ODT), powered by SheetJS and papaparse
• File-to-file convert: en.csv -> en.json
• File-to-multiple convert: i18n.csv -> en.json, vi.json, fr.json,...
• Output merging: i18n_a.csv + i18n_b.csv -> en.json
• File generation: i18n_files.csv -> cloud_en.json, cloud_fr.json, template_en.html, template_fr.html
• And more!

Usage

>See a few examples usage here<

Install package:

# npm
npm install unplugin-sheet-i18n

# yarn
yarn add unplugin-sheet-i18n

# pnpm (recommended)
pnpm install unplugin-sheet-i18n

Setup:

Vite

// vite.config.ts
import SheetI18n from 'unplugin-sheet-i18n/vite'

export default defineConfig({
  plugins: [
    SheetI18n({ /* options */ }),
  ],
})

Rollup

// rollup.config.js
import SheetI18n from 'unplugin-sheet-i18n/rollup'

export default {
  plugins: [
    SheetI18n({ /* options */ }),
  ],
}

Webpack

// webpack.config.js
module.exports = {
  /* ... */
  plugins: [
    require('unplugin-sheet-i18n/webpack')({ /* options */ })
  ]
}

Nuxt

// nuxt.config.js
export default defineNuxtConfig({
  modules: [
    ['unplugin-sheet-i18n/nuxt', { /* options */ }],
  ],
})

This module works for both Nuxt 2 and Nuxt Vite

Vue CLI

// vue.config.js
module.exports = {
  configureWebpack: {
    plugins: [
      require('unplugin-sheet-i18n/webpack')({ /* options */ }),
    ],
  },
}

esbuild

// esbuild.config.js
import { build } from 'esbuild'
import SheetI18n from 'unplugin-sheet-i18n/esbuild'

build({
  plugins: [SheetI18n()],
})

Options:

See Options

Roadmap

• Add example repos
• Add tests

License

MIT License © 2023 NamesMT

Changelog

v0.4.3

compare changes

📖 Documentation

• Update README and Options's type document (04b1e1e)

❤️ Contributors

• NamesMT (@NamesMT)