Added addTranslations and fixed de.js file Fixed de.js to use OC.L10N.register() and use to correct expected format. Added JS unit tests for OC.L10N class Include translations JS script for all appsremotes/origin/fix-10825
Vincent Petry
11 years ago
committed by
Thomas Müller
parent
f67123c5a4
commit
ec1a73fab9
@ -0,0 +1,178 @@ |
||||
/** |
||||
* Copyright (c) 2014 Vincent Petry <pvince81@owncloud.com> |
||||
* |
||||
* This file is licensed under the Affero General Public License version 3 |
||||
* or later. |
||||
* |
||||
* See the COPYING-README file. |
||||
* |
||||
*/ |
||||
|
||||
/** |
||||
* L10N namespace with localization functions. |
||||
* |
||||
* @namespace |
||||
*/ |
||||
OC.L10N = { |
||||
/** |
||||
* String bundles with app name as key. |
||||
* @type {Object.<String,String>} |
||||
*/ |
||||
_bundles: {}, |
||||
|
||||
/** |
||||
* Plural functions, key is app name and value is function. |
||||
* @type {Object.<String,Function>} |
||||
*/ |
||||
_pluralFunctions: {}, |
||||
|
||||
/** |
||||
* Register an app's translation bundle. |
||||
* |
||||
* @param {String} appName name of the app |
||||
* @param {Object<String,String>} strings bundle |
||||
* @param {{Function|String}} [pluralForm] optional plural function or plural string |
||||
*/ |
||||
register: function(appName, bundle, pluralForm) { |
||||
this._bundles[appName] = bundle || {}; |
||||
|
||||
if (_.isFunction(pluralForm)) { |
||||
this._pluralFunctions[appName] = pluralForm; |
||||
} else { |
||||
// generate plural function based on form
|
||||
this._pluralFunctions[appName] = this._generatePluralFunction(pluralForm); |
||||
} |
||||
}, |
||||
|
||||
/** |
||||
* Generates a plural function based on the given plural form. |
||||
* If an invalid form has been given, returns a default function. |
||||
* |
||||
* @param {String} pluralForm plural form |
||||
*/ |
||||
_generatePluralFunction: function(pluralForm) { |
||||
// default func
|
||||
var func = function (n) { |
||||
var p = (n !== 1) ? 1 : 0; |
||||
return { 'nplural' : 2, 'plural' : p }; |
||||
}; |
||||
|
||||
if (!pluralForm) { |
||||
console.warn('Missing plural form in language file'); |
||||
return func; |
||||
} |
||||
|
||||
/** |
||||
* code below has been taken from jsgettext - which is LGPL licensed |
||||
* https://developer.berlios.de/projects/jsgettext/
|
||||
* http://cvs.berlios.de/cgi-bin/viewcvs.cgi/jsgettext/jsgettext/lib/Gettext.js
|
||||
*/ |
||||
var pf_re = new RegExp('^(\\s*nplurals\\s*=\\s*[0-9]+\\s*;\\s*plural\\s*=\\s*(?:\\s|[-\\?\\|&=!<>+*/%:;a-zA-Z0-9_\\(\\)])+)', 'm'); |
||||
if (pf_re.test(pluralForm)) { |
||||
//ex english: "Plural-Forms: nplurals=2; plural=(n != 1);\n"
|
||||
//pf = "nplurals=2; plural=(n != 1);";
|
||||
//ex russian: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10< =4 && (n%100<10 or n%100>=20) ? 1 : 2)
|
||||
//pf = "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)";
|
||||
var pf = pluralForm; |
||||
if (! /;\s*$/.test(pf)) { |
||||
pf = pf.concat(';'); |
||||
} |
||||
/* We used to use eval, but it seems IE has issues with it. |
||||
* We now use "new Function", though it carries a slightly |
||||
* bigger performance hit. |
||||
var code = 'function (n) { var plural; var nplurals; '+pf+' return { "nplural" : nplurals, "plural" : (plural === true ? 1 : plural ? plural : 0) }; };'; |
||||
Gettext._locale_data[domain].head.plural_func = eval("("+code+")"); |
||||
*/ |
||||
var code = 'var plural; var nplurals; '+pf+' return { "nplural" : nplurals, "plural" : (plural === true ? 1 : plural ? plural : 0) };'; |
||||
func = new Function("n", code); |
||||
} else { |
||||
console.warn('Invalid plural form in language file: "' + pluralForm + '"'); |
||||
} |
||||
return func; |
||||
}, |
||||
|
||||
/** |
||||
* Translate a string |
||||
* @param {string} app the id of the app for which to translate the string |
||||
* @param {string} text the string to translate |
||||
* @param [vars] map of placeholder key to value |
||||
* @param {number} [count] number to replace %n with |
||||
* @return {string} |
||||
*/ |
||||
translate: function(app, text, vars, count) { |
||||
// TODO: cache this function to avoid inline recreation
|
||||
// of the same function over and over again in case
|
||||
// translate() is used in a loop
|
||||
var _build = function (text, vars, count) { |
||||
return text.replace(/%n/g, count).replace(/{([^{}]*)}/g, |
||||
function (a, b) { |
||||
var r = vars[b]; |
||||
return typeof r === 'string' || typeof r === 'number' ? r : a; |
||||
} |
||||
); |
||||
}; |
||||
var translation = text; |
||||
var bundle = this._bundles[app] || {}; |
||||
var value = bundle[text]; |
||||
if( typeof(value) !== 'undefined' ){ |
||||
translation = value; |
||||
} |
||||
|
||||
if(typeof vars === 'object' || count !== undefined ) { |
||||
return _build(translation, vars, count); |
||||
} else { |
||||
return translation; |
||||
} |
||||
}, |
||||
|
||||
/** |
||||
* Translate a plural string |
||||
* @param {string} app the id of the app for which to translate the string |
||||
* @param {string} text_singular the string to translate for exactly one object |
||||
* @param {string} text_plural the string to translate for n objects |
||||
* @param {number} count number to determine whether to use singular or plural |
||||
* @param [vars] map of placeholder key to value |
||||
* @return {string} Translated string |
||||
*/ |
||||
translatePlural: function(app, textSingular, textPlural, count, vars) { |
||||
var identifier = '_' + textSingular + '_::_' + textPlural + '_'; |
||||
var bundle = this._bundles[app] || {}; |
||||
var value = bundle[identifier]; |
||||
if( typeof(value) !== 'undefined' ){ |
||||
var translation = value; |
||||
if ($.isArray(translation)) { |
||||
var plural = this._pluralFunctions[app](count); |
||||
return this.translate(app, translation[plural.plural], vars, count); |
||||
} |
||||
} |
||||
|
||||
if(count === 1) { |
||||
return this.translate(app, textSingular, vars, count); |
||||
} |
||||
else{ |
||||
return this.translate(app, textPlural, vars, count); |
||||
} |
||||
} |
||||
}; |
||||
|
||||
/** |
||||
* translate a string |
||||
* @param {string} app the id of the app for which to translate the string |
||||
* @param {string} text the string to translate |
||||
* @param [vars] map of placeholder key to value |
||||
* @param {number} [count] number to replace %n with |
||||
* @return {string} |
||||
*/ |
||||
window.t = _.bind(OC.L10N.translate, OC.L10N); |
||||
|
||||
/** |
||||
* translate a string |
||||
* @param {string} app the id of the app for which to translate the string |
||||
* @param {string} text_singular the string to translate for exactly one object |
||||
* @param {string} text_plural the string to translate for n objects |
||||
* @param {number} count number to determine whether to use singular or plural |
||||
* @param [vars] map of placeholder key to value |
||||
* @return {string} Translated string |
||||
*/ |
||||
window.n = _.bind(OC.L10N.translatePlural, OC.L10N); |
||||
|
||||
@ -0,0 +1,101 @@ |
||||
/** |
||||
* Copyright (c) 2014 Vincent Petry <pvince81@owncloud.com> |
||||
* |
||||
* This file is licensed under the Affero General Public License version 3 |
||||
* or later. |
||||
* |
||||
* See the COPYING-README file. |
||||
* |
||||
*/ |
||||
|
||||
describe('OC.L10N tests', function() { |
||||
var TEST_APP = 'jsunittestapp'; |
||||
|
||||
afterEach(function() { |
||||
delete OC.L10N._bundles[TEST_APP]; |
||||
}); |
||||
|
||||
describe('text translation', function() { |
||||
beforeEach(function() { |
||||
OC.L10N.register(TEST_APP, { |
||||
'Hello world!': 'Hallo Welt!', |
||||
'Hello {name}, the weather is {weather}': 'Hallo {name}, das Wetter ist {weather}', |
||||
'sunny': 'sonnig' |
||||
}); |
||||
}); |
||||
it('returns untranslated text when no bundle exists', function() { |
||||
delete OC.L10N._bundles[TEST_APP]; |
||||
expect(t(TEST_APP, 'unknown text')).toEqual('unknown text'); |
||||
}); |
||||
it('returns untranslated text when no key exists', function() { |
||||
expect(t(TEST_APP, 'unknown text')).toEqual('unknown text'); |
||||
}); |
||||
it('returns translated text when key exists', function() { |
||||
expect(t(TEST_APP, 'Hello world!')).toEqual('Hallo Welt!'); |
||||
}); |
||||
it('returns translated text with placeholder', function() { |
||||
expect( |
||||
t(TEST_APP, 'Hello {name}, the weather is {weather}', {name: 'Steve', weather: t(TEST_APP, 'sunny')}) |
||||
).toEqual('Hallo Steve, das Wetter ist sonnig'); |
||||
}); |
||||
}); |
||||
describe('plurals', function() { |
||||
function checkPlurals() { |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 0) |
||||
).toEqual('0 Dateien herunterladen'); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 1) |
||||
).toEqual('1 Datei herunterladen'); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 2) |
||||
).toEqual('2 Dateien herunterladen'); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 1024) |
||||
).toEqual('1024 Dateien herunterladen'); |
||||
} |
||||
|
||||
it('generates plural for default text when translation does not exist', function() { |
||||
OC.L10N.register(TEST_APP, { |
||||
}); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 0) |
||||
).toEqual('download 0 files'); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 1) |
||||
).toEqual('download 1 file'); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 2) |
||||
).toEqual('download 2 files'); |
||||
expect( |
||||
n(TEST_APP, 'download %n file', 'download %n files', 1024) |
||||
).toEqual('download 1024 files'); |
||||
}); |
||||
it('generates plural with default function when no forms specified', function() { |
||||
OC.L10N.register(TEST_APP, { |
||||
'_download %n file_::_download %n files_': |
||||
['%n Datei herunterladen', '%n Dateien herunterladen'] |
||||
}); |
||||
checkPlurals(); |
||||
}); |
||||
it('generates plural with generated function when forms is specified', function() { |
||||
OC.L10N.register(TEST_APP, { |
||||
'_download %n file_::_download %n files_': |
||||
['%n Datei herunterladen', '%n Dateien herunterladen'] |
||||
}, 'nplurals=2; plural=(n != 1);'); |
||||
checkPlurals(); |
||||
}); |
||||
it('generates plural with function when forms is specified as function', function() { |
||||
OC.L10N.register(TEST_APP, { |
||||
'_download %n file_::_download %n files_': |
||||
['%n Datei herunterladen', '%n Dateien herunterladen'] |
||||
}, function(n) { |
||||
return { |
||||
nplurals: 2, |
||||
plural: (n !== 1) ? 1 : 0 |
||||
}; |
||||
}); |
||||
checkPlurals(); |
||||
}); |
||||
}); |
||||
}); |
||||
Loading…
Reference in new issue