Application 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
Pseudo locale generator (char mapping is taken from pseudolocalization-tool)
Cross-platform
npm install app-localizer
Pseudo locale generator options
Locale validator options
polymer
or angular.flat
file structure)Validate locale file(s) (e.g. gulp
)
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
)
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
)
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
)
npm install intl-messageformat-parser
npm install app-localizer
<script type="text/javascript" src="https://github.com/ppatotski/app-localizer/raw/master/node_modules/intl-messageformat-parser/dist/parser.js" defer></script>
<script type="text/javascript" src="https://github.com/ppatotski/app-localizer/raw/master/node_modules/app-localizer/localizer.js" defer></script>
<script type="text/javascript">
function transform() {
'use strict';
const text = AppLocalizer.toPseudoText('some text', { expander: 0.5, accents: true, wordexpander: 0.2 }, IntlMessageFormatParser);
console.log(text);
}
</script>
Generate pseudo locale text (try it)
transforms
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_abcdefghijklmnopqrstuvwxyz|~
into
¡″♯€‰⅋´{}⁎⁺،‐·⁄⓪①②③④⑤⑥⑦⑧⑨∶⁏≤≂≥¿՞ÅƁÇÐÉƑĜĤÎĴĶĻṀÑÖÞǪŔŠŢÛṼŴẊÝŽ⁅∖⁆˄‿‵åƀçðéƒĝĥîĵķļɱñöþǫŕšţûṽŵẋýž¦˞
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
});
/locales/locale.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
/locales/en-us.json
(polymer file structure){
"en-us": {
"label3": "blah3 {token}",
"label1": "blah1",
"label2": "blah2",
"label4": "blah4"
}
}
/locales/fr.locale.json
(angular flat file structure){
"label1": "blah1 {{token}}",
"label2": "blah2",
"label5": "blah3",
"label3": "blah4"
}