xlf-stash
v0.1.1
Published
CLI helper for merging .xlf translation files (esp. in Angular apps)
Downloads
13
Maintainers
Readme
xlf-stash
Helper script for merging translations in .xlf files, intended (but not limited!) for use in Angular projects.
Rationale and detailed "how to": https://leibrug.pl/xlf-stash
Installation
npm install -g xlf-stashAlternatively, prepend with npx to run without adding global command, like so:
npx xlf-stash ...Usage
"Stash" translation units
The following will take all <target> tags that have state="x-new" (note the x- prefix!) from your XLF files and copy them to temporary JSON files that make the "stash".
xlf-stash"Pop" translation units
The following will take stashed translations from JSON files and put them back to XLF files, respective to id of <trans-unit>s they were copied from. The restored <target>s will be set to state="translated", and temporary files deleted.
xlf-stash pop"Apply" translation units
Same as "Pop", but keep state="x-new" in the restored <target>s, as well as temporary files.
xlf-stash apply"Clear" stash
Delete temporary files.
xlf-stash clearSyntax
xlf-stash [command] [--path=<path>] [--languages=<languages>]Where:
| Item | Description | Default |
| ----------- | -------------------------------------------------------------------------- | ---------------------------------------------- |
| command | What to do with translations or stash, possible: pop, apply or clear | Nothing (will "Stash") |
| path | Path to directory containing .xlf files | . (current directory) |
| languages | Comma-separated codes of languages to process | Nothing (will determine from found .xlf files) |
You can always run xlf-stash --help for the reference.
Configuration
.gitignore
The script will create directory named .xlf-stash in the path where it keeps temporary files. You might want to add it to .gitignore as these files shouldn't end up in version control.
