Awesome

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.