The @ni/xliff-to-json-converter library converts XLIFF translation files to Angular's JSON format so that they can be loaded at runtime in Angular apps.

1. Install in your Angular app's devDependencies:

   npm install -D @ni/xliff-to-json-converter
   

2. Add scripts to your app's package.json to convert translated XLIFF files to JSON.

   "scripts": {
       "i18n:convert": "npm run i18n:convert:de && npm run i18n:convert:ja && npm run i18n:convert:zh",
       "i18n:convert:de": "xliff-to-json-converter --source src/locales/messages.de.xlf --destination src/locales/messages.de.json",
       "i18n:convert:ja": "xliff-to-json-converter --source src/locales/messages.ja.xlf --destination src/locales/messages.ja.json",
       "i18n:convert:zh": "xliff-to-json-converter --source src/locales/messages.zh.xlf --destination src/locales/messages.zh.json",
   },

3. Ensure those converted files are generated at build time and not checked in to source.

NI employees can see more info about our recommended Angular localization toolchain in the NI internal wiki.

See CONTRIBUTING.md for instructions to make changes to the library.

This library is forked from talque/xliff-to-angular-json with additions including auto-testing, linting, and some small functionality changes. Thanks to its main contributor vbraun for the starting point!