https://github.com/sc5/gulp-combine-languagefiles

Gulp plugin to combine several nested JSON language files
https://github.com/sc5/gulp-combine-languagefiles

Last synced: 8 days ago
JSON representation

Gulp plugin to combine several nested JSON language files

• Host: GitHub
• URL: https://github.com/sc5/gulp-combine-languagefiles
• Owner: SC5
• License: mit
• Created: 2015-06-03T11:26:34.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-11-28T15:18:49.000Z (almost 6 years ago)
• Last Synced: 2024-04-13T11:21:31.111Z (7 months ago)
• Language: JavaScript
• Size: 102 KB
• Stars: 2
• Watchers: 23
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gulp-combine-languagefiles

> Gulp plugin to combine several (nested) JSON language files

> Create easily editable CSV so non-programmers can help with translations

This plugin was originally made to be used with [gulp-bobrsass-boilerplate / angularjs](https://github.com/SC5/gulp-bobrsass-boilerplate/tree/angularjs), but it should work with other projects too using JSON key-value -pair translations. It expects translations to be named as `en.json`, `en-EN.json` or similar. Your project tree might look for example like

	src/

		app/

			module1/

				languages/

					en.json

					fi.json

			module2/

				languages/

					en.json

					fi.json

## Usage

Install `gulp-combine-languagefiles` as a development dependency:

```shell

npm install --save-dev gulp-combine-languagefiles

```

Add it to your `gulpfile.js`:

```javascript

var combine_languagefiles = require("gulp-combine-languagefiles");

gulp.src("src/app/**/languages/*.json")

	.pipe(combine_languagefiles("translations.json"))

	.pipe(gulp.dest(""));

```

You can use gulp-convert to convert result to CSV. Use `includeHeader` parameter to prepend header as first row.

```javascript

var concat_json = require("gulp-concat-languagefiles");

var convert = require("gulp-convert");

gulp.src("src/app/**/languages/*.json")

	.pipe(combine_languagefiles("translations.json", { includeHeader: true }))

	.pipe(convert({from: 'json', to: 'csv'}))

	.pipe(gulp.dest("")); // File will be saved as translations.csv to project root

```

See /example for a script to parse generated CSV back to original JSON-files, it even supports downloading CSV from Google Drive!