Angular merge JSON translations

This builder helps merge the messages.json file, after running extract-i18n, into target files using specified locales taking care to delete removed keys and add new ones.

Getting Started

Install the builder

In the Angular workspace root folder, run this command to install the builder:

npm install ngx-merge-json-translations --save-dev

Add the builder to your project

{
  "projects": {
    "[PROJECT_NAME]": {
      "merge-json-translations": {
        "builder": "ngx-merge-json-translations:merge-json-translations",
        "options": {
          "locales": [
            "en-GB"
          ],
          "source": "src/i18n",
          "destination": "src/i18n",
          "sourceFile": "messages.json",
          "indent": '\t'
        }
      }
    }
  }
}

Run it

To generare the json files run:

ng run [PROJECT_NAME]:merge-json-translations

Options

In your angular.json, you can configure your options with the following:

Name	Default	Description
locales	[]	An array of locales that will be used to generate or update target files, i.e. ["en-GB", "fr"]
source	src/i18n	The directory from which to find your source file, normally src/i18n
destination	src/i18n	The directory to which the target files will be added or updated
sourceFile	messages.json	The filename of the source file that the builder will look for in the source directory
indent	'\t'	The indentation to use for the resulting JSON. Options are any string or number. Default is tabbed.

Please note, if your sourceFile is named messages.json, then your translation files will use the same file stem i.e. messages.en-GB.json.

Can be used directly after calling ng-extract-i18n. For example, add a property in your scripts section in package.json named extract-merge and set the value to ng extract-i18n && ng run [PROJECT_NAME]:merge-json-translations. Then in your terminal, use npm run extract-merge to sequentially generate your messages.json file and then merge it into your translation files.