@relayfy/angular-builders

Builders

merge-i18n

Merge-i18n is an extension of the extract-i18n command. It can be used separately or run extract-i18n as a pre-command.

Compatibility: Supports both the new @angular/build package and the legacy @angular-devkit/build-angular package. The builder auto-detects which build system your project uses.

Installation

npm i @relayfy/angular-builders

Setup

angular.json

{
  ...
  "projects": {
    ...
    "demo": {
      ...
      "i18n": {
        "sourceLocale": "en-US",
        "locales": {
          "de-CH": "src/locale/translations.de-CH.xlf",
          "fr-CH": "src/locale/translations.fr-CH.xlf"
        }
      },
      ...
      "architect": {
        ...
        "extract-i18n": {
+          "builder": "@relayfy/angular-builders:merge-i18n",
-          "builder": "@angular-devkit/build-angular:extract-i18n",
          "options": {
            "buildTarget": "demo:build",
            "format": "xlf",
-            "outFile": "src/locale/translations.en-US.xlf",
+            "outFile": "src/locale/translations.en-US.xlf"
          }
        },
        ...
      }
    }
  }
}

Note: The i18nBuilder option is optional. The builder auto-detects whether to use @angular/build:extract-i18n (new build system) or @angular-devkit/build-angular:extract-i18n (legacy) based on which packages are available in your project.

Options | Option | Default | Description | | ------------- | ------------- | ------------- | | buildTarget | undefined | inherit from extract-i18n: A browser builder target to extract i18n messages in the format of project:target[:configuration]. You can also pass in more than one configuration name as a comma-separated list. Example: project:target:production,staging. | | format | xlf | inherit from extract-i18n: Output format for the generated file. | | progress | true | inherit from extract-i18n: By default, extract-i18n is executed before merge-i18n. You can prevent this with preventExtractI18n = true. | | outputPath | undefined | inherit from extract-i18n: Path where output will be placed. | | outFile | undefined | inherit from extract-i18n: Name of the file to output. | | i18nBuilder | Auto-detected | The i18n builder to execute before merge. Supports @angular/build:extract-i18n (new) and @angular-devkit/build-angular:extract-i18n (legacy). If not specified, automatically detects which builder to use based on available packages. |

Limits

Currently only the xlf and xlf2 format is supported. Others will follow.