1.2.0 • Published 6 years ago
@runner/generator-gettext v1.2.0
Tasks generator for gettext
Installation
npm install @runner/generator-gettextUsage
Add to the scope:
var generator = require('@runner/generator-gettext');Generate tasks according to the given config:
var tasks = generator({
languages: ['fr', 'de'],
source: 'src/lang',
target: 'build/develop/lang',
jsData: 'build/develop/main.js'
});Add generated tasks to the runner instance:
var runner = require('@runner/core');
Object.assign(runner.tasks, tasks);The following tasks will become available:
| Task name | Description |
|---|---|
gettext:config | prints the current configuration used for generated tasks |
gettext:build | performs language files compilation |
gettext:clear | removes compiled file |
Generator accepts two arguments: base configuration and additional options.
Base configuration
It's an object with the following properties:
| Name | Description |
|---|---|
| source | directory with po and pot files |
| target | directory with generated localization json files |
| jsData | javascript source file to scan |
| languages | list of language codes in ISO 639-1 format to generate localization files for |
| fromCode | specifies the encoding of the input files (flag --from-code=name) |
| addComments | place comment blocks starting with tag and preceding keyword lines in the output file (flag --add-comments[=tag]) |
| indent | write po files using indented style (flag --indent) |
| noLocation | write "#: filename:line" lines (flag --no-location) |
| addLocation | location type (flag --add-location) |
| noWrap | do not break long message lines (flag --no-wrap) |
| sortOutput | generate sorted output (flag --sort-output) |
| sortByFile | sort output by file location (flag --sort-by-file) |
| verbose | increase verbosity level (flag --verbose) |
Additional options
It's an object with the following properties:
| Name | Description |
|---|---|
| prefix | an affix placed before a task name (default is gettext:) |
| suffix | a string added at the end of a task name (empty by default) |
So it's possible to change generated tasks names:
Object.assign(runner.tasks,
generator(config, {
prefix: 'lang:',
suffix: ':develop'
})
);It will add the following tasks:
lang:config:developlang:build:developlang:clear:develop
Contribution
If you have any problems or suggestions please open an issue according to the contribution rules.
License
@runner/generator-gettext is released under the GPL-3.0 License.