@mingleats/ng-extract-i18n-merge

Angular extract i18n and merge

This extends Angular CLI to improve the i18n extraction and merge workflow. New/removed translations are added/removed from the target translation files. Additionally, translation files are normalized (pretty print, sorted by id) so that diffs are easy to read (and translations in PRs might actually get reviewd ;-) ).

Install

Prerequisites: i18n setup with defined target locales in angular.json - as documented here.

ng add ng-extract-i18n-merge

Usage

ng run [PROJECT_ID]:extract-i18n-merge
# or (if you confirmed to adding an npm command):
npm run extract-i18n-merge 

Configuration

In your angular.json you'll find a new target extract-i18n-merge that can be configured with the following options:

Name	Default	Description
format	Inferred from current setup by ng add	Any of xlf, xlif, xliff, xlf2, xliff2
outputPath	Inferred from current setup by ng add	Path to folder containing all (source and target) translation files.
targetFiles	Inferred from current setup by ng add	Filenames (relative to outputPath of all target translation files (e.g. ["messages.fr.xlf", "messages.de.xlf"]
removeIdsWithPrefix	[]	List of prefix strings. All translation units with matching id attribute are removed. Useful for excluding duplicate library translations.
fuzzyMatch	true	Whether translation units without matching IDs are fuzzy matched by source text.
resetTranslationState	true	Reset the translation state to new/initial for new/changed units.
collapseWhitespace	true	Collapsing of multiple whitespaces and trimming when comparing translations sources.
includeContext	false	Whether to include the context information (like notes) in the translation files. This is useful for sending the target translation files to translation agencies/services.

Contribute

Feedback and PRs always welcome :-)