@freakzlike/i18n-extract

Minimalistic and low dependency translation key extractor.

Searchs for usage of $t and writes keys to JSON files.

Input from source code

$t('some_key')

Output to translation file

{
  "some_key": "__MISSING_TRANSLATION__"
}

Requirements

• Node.js >= 18.15.0

Might as well work with lower Node.js versions. Developed and tested on 18.15.0.

Execute

Extracts translations from source files and writes translation files:

i18n-extract ./i18n-extract.config.cjs

Extract translations from source files and checks for untranslated messages. Can be used in CI and does not write the translation files.

i18n-check ./i18n-extract.config.cjs

Config

// i18n-extract.config.cjs
module.exports = {
  input: [
    'src/**/*.vue',
    'src/**/*.ts',
    // Don't extract from tests
    '!**/__tests__/**'
  ],
  // Output path with placeholders
  // Example: locales/de/common.json
  output: 'locales/{{lng}}/{{ns}}.json',
  languages: ['de', 'en-GB'],
  // Optional: Default namespace if none given in translation
  defaultNamespace: 'common',
  // Optional: Namespaces
  namespaces: ['common', 'other'],
  // Optional: Default value for new translations
  defaultValue: '__MISSING_TRANSLATION__',
  // Optional: Regex to extract transations from source code
  parseRegex: /\B\$t\s*\(\s*['"]([\w/: ._-]+)['"]/g
}