grunt-language-helpers v0.1.0
grunt-language-helpers
4 grunt task helpers for working with json base language dictionaries
- langGenerate
- langSort
- langCheck
- langDiff
Getting Started
This plugin requires Grunt ~0.4.5
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-language-helpers --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-language-helpers');
The "langGenerate" task
Overview
In your project's Gruntfile, add a section named langGenerate
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
langGenerate: {
options:{
source: 'languages/en.json',
destiny: 'languages/test.json'
/* optionals
minify: false,
useKeyAsValue: false,
prefix: '[',
suffix: ']',
,printInConsole:
{
source: true,
destiny: true
}
*/
}
}
});
This task is useful because allow you to automatically create
{
"KEY_1": "[Translation 1]",
"KEY_2": "[Translation 2]",
}
from model.json
{
"KEY_1": "Translation 1",
"KEY_2": "Translation 2",
}
So you can see straight away the parts of your app that are already translated and how.
Options
options.source
(Required)
Type: String
The source path to the json model language.
options.destiny
(Required)
Type: String
The destiny path to generated json language base on the source language.
options.minify
(Optional)
Type: Boolean
Default value: 'false'
If the generated json file will minified or pretty formatted.
options.prefix
(Optional)
Type: String
Default value: '['
Prefix of translation text.
options.suffix
(Optional)
Type: String
Default value: ']'
Suffix of translation text.
options.printInConsole.source
(Optional)
Type: Boolean
Default value: 'false'
Print out to the console the entire source json file.
options.printInConsole.destiny
(Optional)
Type: Boolean
Default value: 'false'
Print out to the console the entire destiny json file.
Usage Examples
Adding this task to your watch with live reload can be very useful.
The "langSort" task
Overview
In your project's Gruntfile, add a section named langSort
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
langSort: {
options: {
langFolder: 'languages/',
targets: ['en', 'es']
//minify: false
}
}
});
This task is useful because allow you to automatically improve the readability of your language definition
{
"KEY_Z": "Translation Z",
"KEY_A": "Translation A",
}
become sorted
{
"KEY_A": "Translation A",
"KEY_Z": "Translation Z",
}
So it is easier to find a key and improve human readability.
Options
options.langFolder
(Required)
Type: String
The source path to the folder containing all the languages.
options.targets
(Required)
Type: String Array
The languages in that folder that you want to sort. file is expected to end in ".json".
options.minify
(Optional)
Type: Boolean
Default value: 'false'
If the generated json will minified or pretty formatted.
The "langCheck" task
Overview
In your project's Gruntfile, add a section named langCheck
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
langCheck: {
options:{
langFolder: 'languages/',
targets: ['en', 'es']
}
}
});
Check if keys have the right format (A_KEY) Check if the same value is used for different keys Check for whitespace problems. starting or ending with whitespace multiple whitespaces together * empty values.
To do
Add regular expressions capabilities
Options
options.langFolder
(Required)
Type: String
The source path to the folder containing all the languages.
options.targets
(Required)
Type: String Array
The languages in that folder that you want to sort. files are expected to end in ".json".
The "langDiff" task
Overview
In your project's Gruntfile, add a section named langDiff
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
langDiff: {
options: {
langFolder: 'languages/',
model: 'en',
targets: ['es']
}
}
});
Check for: Missing keys in the target that are in the model. Unexpected extra keys in the target that the model don't have.
Options
options.langFolder
(Required)
Type: String
The source path to the folder containing all the languages.
options.model
(Required)
Type: String
The model language that you know is ok.
options.targets
(Required)
Type: String Array
The languages in that folder that you want to check against the model language. files are expected to end in ".json".
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt. Please fell free to do pull request.
Release History
version 1.
10 years ago