1 files changed, 371 insertions, 0 deletions
diff --git a/files/pt-br/mozilla/localization/localization_and_plurals/index.html b/files/pt-br/mozilla/localization/localization_and_plurals/index.html
new file mode 100644
index 0000000000..859adb7a4d
--- /dev/null
+++ b/files/pt-br/mozilla/localization/localization_and_plurals/index.html
@@ -0,0 +1,371 @@
+---
+title: Localização e Plurais
+slug: Mozilla/Localization/Localization_and_Plurals
+tags:
+  - Internacionalização
+  - Internationalization
+  - Localization
+  - Localização
+translation_of: Mozilla/Localization/Localization_and_Plurals
+---
+<p>Você provavelmente está aqui porque está localizando um arquivo .properties e ele tem um link para essa página. Essa página ajuda a explicar como localizar essas strings de forma que a forma de plural correta seja mostrada para o usuário. Por exemplo, "1 página" vs "2 páginas".</p>
+
+<p>Se você está aqui para tornar seu código (ex.: extensões) localizável para formas de plural, você pode pular direto para <a href="#Developing_with_PluralForm">Desenvolvendo com PluralForm</a>, mas se você provavelmente precisa localizar as strings iniciais para seu código, então seria bom também ler pelo menos a seção Uso.</p>
+
+<p> </p>
+
+<h2 id="Usage" name="Usage">Uso</h2>
+
+<p>Aqui estão alguns termos usados nesta página para ajudar a manter as coisas claras:</p>
+
+<ul>
+ <li><strong>regra de plural</strong>: Para um idioma dado, há uma regra gramatical sobre como alterar palavras dependendo do número qualificando a palavra. Idiomas diferentes podem ter regras diferentes.</li>
+ <li><strong>forma de plural</strong>: Para uma regra de plural em particular, pode haver múltiplas formas de uma palavra, tal como "página" e "páginas". Neste caso, há 2 formas, mas outros idiomas podem ter 1 ou muito mais.</li>
+</ul>
+
+<p>Se você está aqui para <code>pluralRule</code> no arquivo <code>chrome/global/intl.properties</code>, você precisa descobrir qual <em>regra de plural</em> deve ser escolhida para sua localização. Essa regra de plural é usada para determinar quantas <em>formas de plural</em> são necessárias para cada palavra que precisa ser localizada com plurais em mente.</p>
+
+<p>Para todos os demais arquivos de propriedades que possuem link para essa página, você terá que fornecer formas de plural suficiente da palavra desejada e separá-las com ponto e vírgula (;). Se você não sabe quantas formas de plural você precisa, verifique o número de <code>pluralRule</code> em <code>chrome/global/intl.properties</code> e procure pela entrada correspondente à entrada na lista de regras de plural a seguir.</p>
+
+<h2 id="List_of_Plural_Rules" name="List_of_Plural_Rules">Lista de Regras de Plural</h2>
+
+<p>Essa seção contém uma lista de regras de plural ordenada por seu número de regras de plural. Cada entrada indica quantas formas de plural são necessárias ao localizar uma palavra. Para cada entrada, há uma lista de famílias e idiomas naquelas famílias para lhe ajudar a descobrir se esta é a regra que você deveria escolher para <code>pluralRule</code>. Adicionalmente, há uma breve descrição de cada forma de plural seguida por alguns exemplos de números que caem naquela forma em particular.</p>
+
+<p>Para a regra de plural dada, a ordem na qual as formas de plural são listadas está na mesma ordem que você localizar uma palavra, separadas por caractere de ponto e vírgula. Por exemplo, o inglês usa a regra de plural 1, e localizar <code>plurals</code> exigiria uma string de "plural;plurais" na qual a primeira palavra é a forma singular e a segunda é a forma plural geral.</p>
+
+<h3 id="Plural_rule_.230_.281_form.29" name="Plural_rule_.230_.281_form.29">Regra de plural #<em><strong>0</strong></em> (1 forma)</h3>
+
+<p><strong>Famílias</strong>: asiática (chinês, japonês, coreano), persa, turca/altaica (turco), tailandês, laociana<br>
+ <strong>tudo</strong>: <small>0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, …</small></p>
+
+<h3 id="Plural_rule_.231_.282_forms.29" name="Plural_rule_.231_.282_forms.29">Regra de plural #<em><strong>1</strong></em> (2 formas)</h3>
+
+<p><strong>Famílias</strong>: germânica (dinamarquês, holandês, inglês, faroês, frísio, alemão, norueguês, sueco), fino-úgricas (estoniando, finlandês, húngaro), língua isolada (basco), latina/grega (grego), semítica (hebráico), românica (italiano, português, espanhol, catalão), vietnamita<br>
+ <strong>é 1</strong>: <small>1</small><br>
+ <strong>todo resto</strong>: <small>0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, …</small></p>
+
+<h3 id="Plural_rule_.232_.282_forms.29" name="Plural_rule_.232_.282_forms.29">Regra de plural #<em><strong>2</strong></em> (2 formas)</h3>
+
+<p><strong>Família</strong>: Românica (francês, português brasileiro)<br>
+ <strong>é 0 ou 1</strong>: <small>0, 1</small><br>
+ <strong>todo resto</strong>: <small>2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, …</small></p>
+
+<h3 id="Plural_rule_.233_.283_forms.29" name="Plural_rule_.233_.283_forms.29">Regra de plural #<em><strong>3</strong></em> (3 formas)</h3>
+
+<p><strong>Famílias</strong>: báltica (letã)<br>
+ <strong>é 0</strong>: <small>0</small><br>
+ <strong>termina em 1, excluindo 11</strong>: <small>1, 21, 31, 41, 51, 61, 71, 81, 91, 101, 121, 131, 141, 151, 161, 171, 181, 191, 201, 221, 231, 241, 251, 261, 271, 281, 291, …</small><br>
+ <strong>todo resto</strong>: <small>2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, …</small></p>
+
+<h3 id="Plural_rule_.234_.283_forms.29" name="Plural_rule_.234_.283_forms.29">Regra de plural #<em><strong>4</strong></em> (4 formas)</h3>
+
+<p><strong>Famílias</strong>: céltica (gaélico escocês)<br>
+ <strong>é 1 ou 11</strong>: <small>1, 11</small><br>
+ <strong>é 2 ou 12</strong>: <small>2, 12</small><br>
+ <strong>é 3-10 ou 13-19</strong>: <small>3, 4, 5, 6, 7, 8, 9, 10, 13, 14, 15, 16, 17, 18, 19</small><br>
+ <strong>todo resto</strong>: <small>0, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, …</small></p>
+
+<h3 id="Plural_rule_.235_.283_forms.29" name="Plural_rule_.235_.283_forms.29">Regra de plural #<em><strong>5</strong></em> (3 formas)</h3>
+
+<p><strong>Families</strong>: Romanic (Romanian)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>is 0 or ends in 01-19, excluding 1</strong>: <small>0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, …</small><br>
+ <strong>everything else</strong>: <small>20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, …</small></p>
+
+<h3 id="Plural_rule_.236_.283_forms.29" name="Plural_rule_.236_.283_forms.29">Regra de plural #<em><strong>6</strong></em> (3 formas)</h3>
+
+<p><strong>Families</strong>: Baltic (Lithuanian)<br>
+ <strong>ends in 1, excluding 11</strong>: <small>1, 21, 31, 41, 51, 61, 71, 81, 91, 101, 121, 131, 141, 151, 161, 171, 181, 191, 201, 221, 231, 241, 251, 261, 271, 281, 291, …</small><br>
+ <strong>ends in 0 or ends in 11-19</strong>: <small>0, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 130, 140, 150, 160, 170, 180, 190, 200, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, …</small><br>
+ <strong>everything else</strong>: <small>2, 3, 4, 5, 6, 7, 8, 9, 22, 23, 24, 25, 26, 27, 28, 29, 32, 33, 34, 35, 36, 37, 38, 39, 42, 43, 44, 45, 46, 47, 48, 49, 52, 53, 54, 55, 56, 57, 58, 59, 62, 63, 64, 65, 66, 67, 68, 69, 72, 73, …</small></p>
+
+<h3 id="Plural_rule_.237_.283_forms.29" name="Plural_rule_.237_.283_forms.29">Regra de plural #<em><strong>7</strong></em> (3 formas)</h3>
+
+<p><strong>Families</strong>: Slavic (Belarusian, Bosnian, Croatian, Serbian, Russian, Ukrainian)<br>
+ <strong>ends in 1, excluding 11</strong>: <small>1, 21, 31, 41, 51, 61, 71, 81, 91, 101, 121, 131, 141, 151, 161, 171, 181, 191, 201, 221, 231, 241, 251, 261, 271, 281, 291, …</small><br>
+ <strong>ends in 2-4, excluding 12-14</strong>: <small>2, 3, 4, 22, 23, 24, 32, 33, 34, 42, 43, 44, 52, 53, 54, 62, 63, 64, 72, 73, 74, 82, 83, 84, 92, 93, 94, 102, 103, 104, 122, 123, 124, 132, 133, 134, 142, 143, 144, 152, 153, 154, 162, 163, 164, 172, 173, 174, 182, 183, …</small><br>
+ <strong>everything else</strong>: <small>0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 25, 26, 27, 28, 29, 30, 35, 36, 37, 38, 39, 40, 45, 46, 47, 48, 49, 50, 55, 56, 57, 58, 59, 60, 65, 66, 67, 68, 69, 70, 75, 76, 77, …</small></p>
+
+<h3 id="Plural_rule_.238_.283_forms.29" name="Plural_rule_.238_.283_forms.29">Regra de plural #<em><strong>8</strong></em> (3 formas)</h3>
+
+<p><strong>Families</strong>: Slavic (Slovak, Czech)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>is 2-4</strong>: <small>2, 3, 4</small><br>
+ <strong>everything else</strong>: <small>0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, …</small></p>
+
+<h3 id="Plural_rule_.239_.283_forms.29" name="Plural_rule_.239_.283_forms.29">Regra de plural #<em><strong>9</strong></em> (3 formas)</h3>
+
+<p><strong>Families</strong>: Slavic (Polish)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>ends in 2-4, excluding 12-14</strong>: <small>2, 3, 4, 22, 23, 24, 32, 33, 34, 42, 43, 44, 52, 53, 54, 62, 63, 64, 72, 73, 74, 82, 83, 84, 92, 93, 94, 102, 103, 104, 122, 123, 124, 132, 133, 134, 142, 143, 144, 152, 153, 154, 162, 163, 164, 172, 173, 174, 182, 183, …</small><br>
+ <strong>everything else</strong>: <small>0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 25, 26, 27, 28, 29, 30, 31, 35, 36, 37, 38, 39, 40, 41, 45, 46, 47, 48, 49, 50, 51, 55, 56, 57, 58, 59, 60, 61, 65, 66, 67, 68, …</small></p>
+
+<h3 id="Plural_rule_.2310_.284_forms.29" name="Plural_rule_.2310_.284_forms.29">Regra de plural #<em><strong>10</strong></em> (4 formas)</h3>
+
+<p><strong>Families</strong>: Slavic (Slovenian, Sorbian)<br>
+ <strong>ends in 01</strong>: <small>1, 101, 201, …</small><br>
+ <strong>ends in 02</strong>: <small>2, 102, 202, …</small><br>
+ <strong>ends in 03-04</strong>: <small>3, 4, 103, 104, 203, 204, …</small><br>
+ <strong>everything else</strong>: <small>0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, …</small></p>
+
+<h3 id="Plural_rule_.2311_.285_forms.29" name="Plural_rule_.2311_.285_forms.29">Regra de plural #<em><strong>11</strong></em> (5 formas)</h3>
+
+<p><strong>Families</strong>: Celtic (Irish Gaelic)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>is 2</strong>: <small>2</small><br>
+ <strong>is 3-6</strong>: <small>3, 4, 5, 6</small><br>
+ <strong>is 7-10</strong>: <small>7, 8, 9, 10</small><br>
+ <strong>everything else</strong>: <small>0, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, …</small></p>
+
+<h3 id="Plural_rule_.2312_.284_forms.29" name="Plural_rule_.2312_.284_forms.29">Regra de plural #<em><strong>12</strong></em> (6 formas)</h3>
+
+<p><strong>Families</strong>: Semitic (Arabic)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>is 2</strong>: <small>2</small><br>
+ <strong>ends in 03-10</strong>: <small>3, 4, 5, 6, 7, 8, 9, 10, 103, 104, 105, 106, 107, 108, 109, 110, 2</small><small>03, 204, 205, 206, 207, 208, 209, 210, </small><small>…</small><br>
+ <strong>everything else but is 0 and ends in 00-02, excluding 0-2</strong>: <small>11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, … </small><br>
+ <strong>ends in 00-02, excluding 0-2</strong>: <small>100, 101, 102, 200, 201, 202, …</small><br>
+ <strong>is 0</strong>: <small>0</small></p>
+
+<h3 id="Plural_rule_.2313_.284_forms.29" name="Plural_rule_.2313_.284_forms.29">Regra de plural #<em><strong>13</strong></em> (4 formas)</h3>
+
+<p><strong>Families</strong>: Semitic (Maltese)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>is 0 or ends in 01-10, excluding 1</strong>: <small>0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, …</small><br>
+ <strong>ends in 11-19</strong>: <small>11, 12, 13, 14, 15, 16, 17, 18, 19, 111, 112, 113, 114, 115, 116, 117, 118, 119, 211, 212, 213, 214, 215, 216, 217, 218, 219, …</small><br>
+ <strong>everything else</strong>: <small>20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, …</small></p>
+
+<h3 id="Plural_rule_.2314_.283_forms.29" name="Plural_rule_.2314_.283_forms.29">Regra de plural #<em><strong>14</strong></em> (3 formas)</h3>
+
+<p><strong>Families</strong>: Slavic (Macedonian)<br>
+ <strong>ends in 1</strong>: <small>1, 11, 21, 31, 41, 51, 61, 71, 81, 91, 101, 111, 121, 131, 141, 151, 161, 171, 181, 191, 201, 211, 221, 231, 241, 251, 261, 271, 281, 291, …</small><br>
+ <strong>ends in 2</strong>: <small>2, 12, 22, 32, 42, 52, 62, 72, 82, 92, 102, 112, 122, 132, 142, 152, 162, 172, 182, 192, 202, 212, 222, 232, 242, 252, 262, 272, 282, 292, …</small><br>
+ <strong>everything else</strong>: <small>0, 3, 4, 5, 6, 7, 8, 9, 10, 13, 14, 15, 16, 17, 18, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 33, 34, 35, 36, 37, 38, 39, 40, 43, 44, 45, 46, 47, 48, 49, 50, 53, 54, 55, 56, 57, 58, 59, 60, 63, …</small></p>
+
+<h3 id="Plural_rule_.2315_.283_forms.29" name="Plural_rule_.2315_.283_forms.29">Regra de plural #<em><strong>15</strong></em> (2 formas)</h3>
+
+<p><strong>Families</strong>: Icelandic<br>
+ <strong>ends in 1, excluding 11</strong>: <small>1, 21, 31, 41, 51, 61, 71, 81, 91, 101, 121, 131, 141, 151, 161, 171, 181, 191, 201, 221, 231, 241, 251, 261, 271, 281, 291, …</small><br>
+ <strong>everything else</strong>: <small>0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, …</small></p>
+
+<h3 id="Plural_rule_.2316_.283_forms.29" name="Plural_rule_.2316_.283_forms.29">Regra de plural #<em><strong>16</strong></em> (6 formas)</h3>
+
+<p><strong>Families</strong>: Celtic (Breton)<br>
+ <strong>is 1</strong>: <small>1</small><br>
+ <strong>ends in 1, excluding 1, 11, 71, 91</strong>: <small>21, 31, 41, 51, 61, 81, 101, 121, 131, 141, 151, 161, 181, 201, 221, 231, 241, 251, 261, 281, ...</small><br>
+ <strong>ends in 2, excluding 12, 72, 92</strong>: <small>2, 22, 32, 42, 52, 62, 82, 102, 122, 132, 142, 152, 162, 182, 202, 222, 232, 242, 252, 262, 282, ...</small><br>
+ <strong>ends in 3, 4 or 9 excluding 13, 14, 19, 73, 74, 79, 93, 94, 99</strong>: <small>3, 4, 9, 23, 24, 29, 33, 34, 39, 43, 44, 49, 53, 54, 59, ...</small><br>
+ <strong>ends in 1000000</strong>: <small>1000000: 1000000, 2000000, 3000000, 4000000, 5000000, 6000000, 7000000, 8000000, 9000000, 10000000, ...</small><br>
+ <strong>everything else</strong>: <small>0, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 25, 26, 27, 28, 30, 35, 36, 37, 38, 40, ...</small></p>
+
+<h2 id="Examples" name="Examples">Examples</h2>
+
+<p>The following are some examples for various languages and a brief thought processes.</p>
+
+<h3 id="French" name="French">French</h3>
+
+<p>Some French speaking places treat 0 as plural while others treat it as singular. The only other singular is 1 while everything else is plural. So pick either plural rule #1 or #2.</p>
+
+<p><code>pluralRule=2<br>
+ seconds=seconde;secondes<br>
+ minutes=minute;minutes<br>
+ hours=heure;heures<br>
+ days=jour;jours </code></p>
+
+<p>Like many other times when localizing words, gender agreement might force you to rearrange words in a way that the gender is always the same. (seconde vs jour)</p>
+
+<h3 id="Chinese" name="Chinese">Chinese</h3>
+
+<p>A word doesn't change if there is a different number in front of it, so all numbers use the same plural form. With just one plural form, it has to be plural rule #0. For each word to localize, it's just like localizing a single word with no semi-colons needed.</p>
+
+<p><code>pluralRule=0<br>
+ seconds=秒<br>
+ minutes=分<br>
+ hours=時<br>
+ days=日 </code></p>
+
+<h3 id="Polish" name="Polish">Polish</h3>
+
+<p>There's a singular form for 1, a plural form for 2-4, and another for 5-21 at which point 22 is the same as 2. Plural rule #7 has a "ends in 2-4, not 12-14" but the singular form includes everything ending in 1 except 11. Plural rule #9 has the correct singular form for only 1.</p>
+
+<p><code>pluralRule=9<br>
+ seconds=sekunda;sekundy;sekund<br>
+ minutes=minuta;minuty;minut<br>
+ hours=godzina;godziny;godzin<br>
+ days=dzień;dni;dni </code></p>
+
+<p>Even though the last 2 plural forms of "day" are the same, both are still needed because there needs to be 3 plural forms for each word.</p>
+
+<h3 id="Sorbian" name="Sorbian">Sorbian</h3>
+
+<p>There are 4 plural forms: nominative singular, nominative dual, nominative plural, genitive plural. These match up with plural rule #10.</p>
+
+<p><code>pluralRule=10<br>
+ seconds=sekunda;sekundźe;sekundy;sekundow<br>
+ minutes=mjeńšina;mjeńšinje;mjeńšiny;mjeńšin<br>
+ hours=hodźina;hodźinje;hodźiny;hodźin<br>
+ days=dźeń;dnjej;dny;dnjow </code></p>
+
+<h2 id="Testing_Extension" name="Testing_Extension">Testing Extension</h2>
+
+<p>To help make sure you pick the right plural rule and provide enough plural forms for strings, you should use the pluralForm Checker extension. After installing the extension, it should be available from the Tools menu.</p>
+
+<p>To use it, list off the property files and properties that you want to check and click the button. The extension will load each property and display the plural forms in a table. Selecting a table entry will populate the bottom box with sample uses of the word for some numbers.</p>
+
+<p><img alt="Image:pluralForm-checker.0.3.png" class="internal" src="/@api/deki/files/804/=PluralForm-checker.0.3.png"></p>
+
+<p><a class="external" href="http://ed.agadak.net/firefox/pluralForm-checker.xpi">Install pluralForm Checker v0.3 extension</a></p>
+
+<h3 id="Extension_input" name="Extension_input">Extension input</h3>
+
+<p>It would be good to keep this list updated with all the words that need plural forms. People using the extension can then copy/paste this input.</p>
+
+<p><code><small><a class="external" rel="freelink">chrome://mozapps/locale/downloads/do...tes,hours,days</a><br>
+ <a class="external" rel="freelink">chrome://mozapps/locale/downloads/do...dsTitlePercent</a><br>
+ <a class="external" rel="freelink">chrome://browser/locale/browser.prop...ausedDownloads</a> </small></code></p>
+
+<h3 id="Version_history" name="Version_history">Version history</h3>
+
+<p>0.1: Initial version with pluralRule check, properties input loading, table generation, sample output display<br>
+ 0.2: Use PluralForm.numForms() to get the number of forms instead of figuring out locally to better support future rules - <strong>Requires build from 2007/01/27 or later</strong><br>
+ 0.3: Generate a list of what numbers fall into which plural form to minimize the sample output to at most 3 of each form</p>
+
+<h2 id="Developing_with_PluralForm" name="Developing_with_PluralForm">Developing with PluralForm</h2>
+
+<p>The functionality for getting the correct plural forms is provided by a JavaScript Module, <code>PluralForm.jsm</code>. This module provides a couple methods for localizing to the browser's current locale as well as getting methods to localize to a desired plural rule. The latter ability of specifying a plural rule is useful for extensions because the extension doesn't necessarily have to be localized to the browser's locale.</p>
+
+<h3 id="Loading_PluralForm.jsm" name="Loading_PluralForm.jsm">Loading <code>PluralForm.jsm</code></h3>
+
+<p>Loading the PluralForm module from JavaScript is simple with <a href="/en/Components.utils.import" title="en/Components.utils.import">Components.utils.import</a>. Just put the following line somewhere that will be evaluated before you want to use PluralForm. At the top of your JavaScript file is fine.</p>
+
+<pre>Components.utils.import("resource://gre/modules/PluralForm.jsm");</pre>
+
+<h3 id="Methods:_get" name="Methods:_get">Methods: <code>get</code></h3>
+
+<p>These methods make use of the browser's current locale specified by <code><a class="external" rel="freelink">chrome://global/locale/intl.properties</a></code>'s <code>pluralRule</code> value.</p>
+
+<pre>/**
+ * Get the correct plural form of a word based on the number
+ *
+ * @param aNum
+ *        The number to decide which plural form to use
+ * @param aWords
+ *        A semi-colon (;) separated string of words to pick the plural form
+ * @return The appropriate plural form of the word
+ */
+string pluralForm
+get(int aNum, string aWords)</pre>
+
+<p>Here is an example of using this method:</p>
+
+<pre>// Load PluralForm and for this example, assume English
+Components.utils.import("resource://gre/modules/PluralForm.jsm");
+
+// PluralForm.get expects a semi-colon separated list of words
+let downloads = "download;downloads";
+// Pretend this number came from somewhere else
+let num = 10;
+
+// Display the correct plural form for 10 downloads: "You have 10 downloads.")
+print("You have " + num + " " + PluralForm.get(num, downloads) + ".");
+
+// Try again with a different value: "You have 1 download."
+num = 1;
+print("You have " + num + " " + PluralForm.get(num, downloads) + ".")</pre>
+
+<p>The above example works, but is still difficult to localize because we're concatenating strings assuming a particular grammatical structure. The following would be better:</p>
+
+<pre>Components.utils.import("resource://gre/modules/PluralForm.jsm");
+
+let downloads = "You have one download.;You have #1 downloads.";
+let num = 10;
+
+// For English, this would display "You have 10 downloads."
+print(PluralForm.get(num, downloads).replace("#1", num);</pre>
+
+<p>Notice in the above example that the code can be written to support placeholders or not use placeholders in some forms of the string. Additionally, the localizer has control over where the placeholder is in relation to the rest of the text.</p>
+
+<p>Of course, the strings to be localized will be placed in a separate file such as yourextension.properties instead of being hardcoded in the JavaScript code file.</p>
+
+<p>The following 3 file snippets show how to use PluralForm with your <code>.xul</code>, <code>.properties</code>, <code>.js</code> files.</p>
+
+<p><code>downloads.xul</code>:</p>
+
+<pre>&lt;stringbundleset&gt;
+  &lt;stringbundle id="strings" src="chrome://downloads.properties"/&gt;
+&lt;/stringbundleset&gt;</pre>
+
+<p><code>downloads.properties</code>:</p>
+
+<pre># LOCALIZATION NOTE (downloadsTitleFiles): Semi-colon list of plural forms.
+# See: http://developer.mozilla.org/en/docs/Localization_and_Plurals
+# #1 number of files
+# example: 111 files - Downloads
+downloadsTitleFiles=#1 file - Downloads;#1 files - Downloads
+
+# LOCALIZATION NOTE (timePair): #1 time number; #2 time unit
+# example: 1 second; 11 seconds
+timePair=#1 #2
+seconds=second;seconds
+minutes=minute;minutes
+hours=hour;hours
+</pre>
+
+<p><code>downloads.js</code>:</p>
+
+<pre>Components.utils.import("resource://gre/modules/PluralForm.jsm");
+let getStr = function(string) document.getElementById("strings").getString(string);
+
+// Get the correct plural form for the title
+let numDownloads = 3;
+let title = PluralForm.get(numDownloads, getStr("downloadsTitleFiles"));
+// Put in the correct number of downloads
+print(title.replace("#1", numDownloads));
+
+// Get the correct plural form of seconds
+let timeLeft = 55;
+let seconds = PluralForm.get(timeLeft, getStr("seconds"));
+// Print the localized string for "55 seconds"
+print(getStr("timePair").replace("#1", timeLeft).replace("#2", seconds));</pre>
+
+<h3 id="Method:_makeGetter" name="Method:_makeGetter">Method: <code>makeGetter</code></h3>
+
+<p>If you're writing an extension, you'll want to use <code>makeGetter</code> instead of <code>PluralForm.get()</code> or <code>PluralForm.numForms()</code> because someone installing the extension on a different locale will be using the strings provided by your default extension locale. For example, your extension localized for English with plural rule #1, which expects 2 plural forms, is installed on a localized version of Firefox with plural rule #4, which expects 3 forms.</p>
+
+<pre>/**
+ * Create a pair of plural form functions for the given plural rule number.
+ *
+ * @param aRuleNum
+ *        The plural rule number to create functions
+ * @return A pair: [function that gets the right plural form,
+ *                  function that returns the number of plural forms]
+ */
+[string pluralForm get(int aNum, string aWords), int numForms numForms()]
+makeGetter(int aRuleNum)</pre>
+
+<p>Here is an example usage of <code>makeGetter</code>:</p>
+
+<pre>Components.utils.import("resource://gre/modules/PluralForm.jsm");
+
+// Let's get Irish (plural rule #11)
+let [get, numForms] = PluralForm.makeGetter(11);
+
+// Make up some values to use with "get"
+let dummyText = "form 1;form 2;form 3;form 4;form 5";
+let dummyNum = 10;
+
+// In the case of Irish, the value 10 uses plural form #4, so "form 4" is printed
+print(get(dummyNum, dummyText));</pre>
+
+<p>In this example, the Irish plural rule was hardcoded, but this could be a value specified in the .properties file. So for your extension, specify a pluralRule value in the .properties and call <code>PluralForm.makeGetter(pluralRuleFromProperties)</code> making sure to save the 2 returned functions. (You can use <a href="/en/JavaScript/New_in_JavaScript/1.7#Destructuring_assignment" title="en/New_in_JavaScript_1.7#Destructuring_assignment">destructured assignment</a> in JavaScript 1.7 to keep things clean.) The returned functions act just like <code>PluralForm.get()</code> and <code>PluralForm.numForms()</code> except for the specified plural rule instead of the default plural rule.</p>
+
+<h2 id="Credits" name="Credits">Credits</h2>
+
+<p>Plural Form code first implemented for {{ Bug(394516) }} - <em>Figure out a remaining-time rounding scheme for minutes -&gt; hours/days</em><br>
+ Plural rules and families derived from <a class="external" href="http://www.gnu.org/software/gettext/manual/html_node/gettext_150.html#Plural-forms">GNU <code>gettext</code> documentation</a>.</p>
+
+<p> </p>
+
+<p> </p>
+
+<p>{{ languages( { "es": "es/Localización_y_Plurales", "fr": "fr/Localisation_et_pluriels", "ja": "ja/Localization_and_Plurals", "pl": "pl/Lokalizacja_i_liczba_mnoga" } ) }}</p>