Application Localizer
npm install app-localizerApplication Localizer package that helps with localizing applications
Pseudo Locale Generator Web Site
> uses Intl MessageFormat Parser that parses ICU Message strings into an AST.
>
> tested with Intl MessageFormat that formats ICU Message strings with number, date, plural, and select placeholders to create localized messages.
>
> used by vscode-app-localizer vscode extension
>
> 
* Locale validator - Check for missing labels - Multi-file locale support (see example below)
_ Polymer file structure
_ Angular flat file structure
* Pseudo locale generator (char mapping is taken from pseudolocalization-tool)
* Accents on letters
* Longer sentence
* Longer word
* Right-to-Left
* Enclose in exclamations
* Enclose in brackets - Support ICU Message syntax
* Cross-platform
``shell`
npm install app-localizer
Pseudo locale generator options
* expander Sentence expand factor 0.3 = 30%
* wordexpander Word expand factor 0.5 = 50%
* brackets Enclose sentence in brackets
* exclamations Enclose sentence in exclamations
* accents Convert letter to its accent version
* rightToLeft RTL writing systems
* forceException Force throwing syntax exception if any
Locale validator options
* filePathPattern Locale files path (supports node glob pattern)
* multiFile Each locale is in separate file in the same folder
* fileStructure Structure of locale file content (polymer or angular.flat file structure)
Validate locale file(s) (e.g. gulp)
`javascript
const gulp = require("gulp");
const localizer = require("app-localizer");
gulp.task("validateLocales", function validateLocales(callback) {
localizer.validateLocales(
"locales/app1/",
{ multiFile: true, fileStructure: "polymer" },
undefined,
result => {
// result contains missing labels if any
callback(result);
}
);
});
gulp.task("validateMultipleLocales", function validateMultipleLocales(
callback
) {
localizer.validateMultipleLocales(
["locales/app1/", "locales/app2/"],
{ multiFile: true, fileStructure: "polymer" },
undefined,
result => {
// result contains missing labels if any
callback(result);
}
);
});
`
Generate pseudo locale json file from source (gulp)
`javascript
const gulp = require("gulp");
const localizer = require("app-localizer");
const rename = require("gulp-rename");
gulp.task("locales", function generatePseudoLocale() {
gulp
.src("app/locales/en-us.json")
.pipe(rename("pseudo.json"))
.pipe(
localizer.pseudoLocalize({
expander: 0.2,
accents: true,
rightToLeft: false,
exclamations: true,
brackets: true,
wordexpander: 0.5,
forceException: false,
pseudoLocaleName: "en-us"
})
)
.pipe(gulp.dest("dist/locales/"));
});
`
Generate pseudo locale json file from source (grunt)
`javascript
const localizer = require("app-localizer");
module.exports = function gruntEntry(grunt) {
grunt.initConfig({
pkg: grunt.file.readJSON("package.json"),
pseudo: {
options: {
expander: 0.2,
exclamations: true,
brackets: true,
accents: true,
rightToLeft: false,
wordexpander: 0.5,
forceException: false,
pseudoLocaleName: "en-us"
},
dist: {
files: {
"app/locales/pseudo.json": ["app/locales/en-us.json"]
}
}
}
});
grunt.registerMultiTask("pseudo", "Pseudolocalize locale", function() {
const options = this.options();
this.files.forEach(file => {
if (file.dest) {
file.src.forEach(source => {
const text = grunt.file.read(source);
const result = localizer.pseudoLocalizeContent(options, text);
grunt.file.write(file.dest, result);
});
}
});
});
};
`
Generate pseudo pseudo text (browser)
`shell`
npm install intl-messageformat-parser
npm install app-localizer
`html`
Generate pseudo locale text (try it)
> transforms
>
> !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_abcdefghijklmnopqrstuvwxyz|~
>
> into
>
>
`javascript
const localizer = require("app-localizer");
const pseudoText = localizer.toPseudoText(text, {
expander: 0.2,
exclamations: true,
brackets: true,
accents: true,
rightToLeft: false,
wordexpander: 0.5,
forceException: false
});
`
`json`
{
"en-us": {
"label3": "blah3 {token}",
"label1": "blah1",
"label2": "blah2",
"label4": "blah4"
},
"de-de": {
"label3": "blah3 {token}",
"label1": "blah1",
"label2": "blah2",
"label4": "blah4"
}
}
> locale files should be in the same folder
`json`
{
"en-us": {
"label3": "blah3 {token}",
"label1": "blah1",
"label2": "blah2",
"label4": "blah4"
}
}
`json``
{
"label1": "blah1 {{token}}",
"label2": "blah2",
"label5": "blah3",
"label3": "blah4"
}