Gulp Translator-d

Almost like string replace but using locales

Usage

First, install gulp-translator-d as a development dependency:

1npm install --save-dev gulp-translator-d

Then, add it to your gulpfile.js:

1var translate = require('gulp-translator');
2
3gulp.task('translate', function() {
4  var translations = ['pl', 'en'];
5
6  translations.forEach(function(translation){
7    gulp.src('app/views/**/*.html')
8      .pipe(translate('./locales/'+ translation +'.yml'))
9      .pipe(gulp.dest('dist/views/' + translation));
10  });
11});

or better, handle errors:

1gulp.task('translate', function() {
2  var translations = ['pl', 'en'];
3
4  translations.forEach(function(translation){
5    gulp.src('app/views/**/*.html')
6      .pipe(
7        gulpTranslateTemplate('./locales/'+ translation +'.yml')
8        .on('error', function(){
9          console.dir(arguments);
10        })
11      )
12      .pipe(gulp.dest('dist/views/' + translation));
13  });
14});

Usage

I'm using {{{}}} to avoid conflict with angular-like syntax

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

Example:

{{{ title }}} 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 | lowercase }}} will be change to "new title"

{{{ title | 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

• filter chain

License

MIT