2 * Localized Language support attempts to mirror some of the functionality of
3 * Language.php in MediaWiki.
4 * This adds methods for transforming message text.
11 * Process the PLURAL template substitution
13 * @param {object} template Template object
16 * 'title': [title of template],
17 * 'parameters': [template parameters]
19 * @example {{Template:title|params}}
21 'procPLURAL': function( template
) {
22 if ( template
.title
&& template
.parameters
&& mw
.language
.convertPlural
) {
23 // Check if we have forms to replace
24 if ( template
.parameters
.length
=== 0 ) {
27 // Restore the count into a Number ( if it got converted earlier )
28 var count
= mw
.language
.convertNumber( template
.title
, true );
29 // Do convertPlural call
30 return mw
.language
.convertPlural( parseInt( count
, 10 ), template
.parameters
);
32 // Could not process plural return first form or nothing
33 if ( template
.parameters
[0] ) {
34 return template
.parameters
[0];
39 * Plural form transformations, needed for some languages.
41 * @param count integer Non-localized quantifier
42 * @param forms array List of plural forms
43 * @return string Correct form for quantifier in this language
45 'convertPlural': function( count
, forms
){
46 if ( !forms
|| forms
.length
=== 0 ) {
49 return ( parseInt( count
, 10 ) == 1 ) ? forms
[0] : forms
[1];
52 * Pads an array to a specific length by copying the last one element.
54 * @param forms array Number of forms given to convertPlural
55 * @param count integer Number of forms required
56 * @return array Padded array of forms
58 'preConvertPlural': function( forms
, count
) {
59 while ( forms
.length
< count
) {
60 forms
.push( forms
[ forms
.length
-1 ] );
65 * Converts a number using digitTransformTable.
67 * @param {num} number Value to be converted
68 * @param {boolean} integer Convert the return value to an integer
70 'convertNumber': function( num
, integer
) {
71 if ( !mw
.language
.digitTransformTable
) {
74 // Set the target Transform table:
75 var transformTable
= mw
.language
.digitTransformTable
;
76 // Check if the "restore" to Latin number flag is set:
78 if ( parseInt( num
, 10 ) == num
) {
82 for ( var i
in transformTable
) {
83 tmp
[ transformTable
[ i
] ] = i
;
87 var numberString
= '' + num
;
88 var convertedNumber
= '';
89 for ( var i
= 0; i
< numberString
.length
; i
++ ) {
90 if ( transformTable
[ numberString
[i
] ] ) {
91 convertedNumber
+= transformTable
[numberString
[i
]];
93 convertedNumber
+= numberString
[i
];
96 return integer
? parseInt( convertedNumber
, 10 ) : convertedNumber
;
99 * Provides an alternative text depending on specified gender.
100 * Usage {{gender:[gender|user object]|masculine|feminine|neutral}}.
101 * If second or third parameter are not specified, masculine is used.
103 * These details may be overriden per language.
105 * @param gender string male, female, or anything else for neutral.
106 * @param forms array List of gender forms
110 'gender': function( gender
, forms
) {
111 if ( !forms
|| forms
.length
=== 0 ) {
114 forms
= mw
.language
.preConvertPlural( forms
, 2 );
115 if ( gender
=== 'male' ) {
118 if ( gender
=== 'female' ) {
121 return ( forms
.length
=== 3 ) ? forms
[2] : forms
[0];
125 * Grammatical transformations, needed for inflected languages.
126 * Invoked by putting {{grammar:form|word}} in a message.
127 * The rules can be defined in $wgGrammarForms global or grammar
128 * forms can be computed dynamically by overriding this method per language
130 * @param word {String}
131 * @param form {String}
134 convertGrammar: function ( word
, form
) {
135 var grammarForms
= mw
.language
.getData( mw
.config
.get( 'wgUserLanguage' ), 'grammarForms' );
136 if ( grammarForms
&& grammarForms
[form
] ) {
137 return grammarForms
[form
][word
] || word
;
142 // Digit Transform Table, populated by language classes where applicable
143 'digitTransformTable': mw
.language
.getData( mw
.config
.get( 'wgUserLanguage' ), 'digitTransformTable' )
146 $.extend( mw
.language
, language
);
148 } )( jQuery
, mediaWiki
);