Gulp Translator

Almost like string replace but using locales

Usage

First, install gulp-translator as a development dependency:

1npm install --save-dev gulp-translator

Then, add it to your gulpfile.js:

1var translate = require('gulp-translator');
2
3gulp.task('translate', function() {
4  gulp.src('app/views/**/*.tpl.html')
5    .pipe(translate('./locales/*.yml', {replace:'tpl'}))
6    .pipe(gulp.dest('dist/views/'));
7});

or better, handle errors:

1gulp.task('translate', function() {
2
3  gulp.src('app/views/**/*.html')
4    .pipe(
5      gulpTranslateTemplate('./locales/*.yml')
6      .on('error', function(){
7        console.dir(arguments);
8      })
9    )
10    .pipe(gulp.dest('dist/views/'));
11});

Usage

I'm using angular-like syntax. Expressions in {{}} with | translate filter will be translated.

Following examples assume that "title" in locales equals "new TITLE"

Example:

{{ title | translate }} will be change to "new TITLE"

If you'd like to use filters(look at the bottom to check available filters) just pass them after like that:

{{ title | translate | lowercase }} will be change to "new title"

{{ title | translate | uppercase }} will be change to "NEW TITLE"

If you're still not sure, please look at tests.

API

gulp-translator is called with a string

translate(string)

string

Type: String

The string is a path to a nameOfTheFile.yml with your locales. Please look at test/locales for examples.

Available filters:

• lowercase
• uppercase

TODO:

• refactor tests

• work on matchers (sigh...)

• add filters:

  • capitalize
  • reverse

• add option to dynamically add filters

License

MIT