From 24a6c0e8bc5d81f90f582f05bf055570ea5dee50 Mon Sep 17 00:00:00 2001 From: Gervase Markham Date: Sat, 21 Nov 2015 14:34:50 +0000 Subject: Bug 1226865 - bug fixes to localization documentation. --- docs/en/rst/localizing/caveats.rst | 42 +++++++++++----------- docs/en/rst/localizing/get-the-source.rst | 3 +- .../en/rst/localizing/localizing-documentation.rst | 4 +-- docs/en/rst/localizing/shipping.rst | 3 ++ 4 files changed, 28 insertions(+), 24 deletions(-) (limited to 'docs') diff --git a/docs/en/rst/localizing/caveats.rst b/docs/en/rst/localizing/caveats.rst index ce988dabe..3275562b9 100644 --- a/docs/en/rst/localizing/caveats.rst +++ b/docs/en/rst/localizing/caveats.rst @@ -164,21 +164,21 @@ Let's say we have the following: [% IF !Param("allowbugdeletion") %]

Sorry, there - - [% IF comp.bug_count > 1 %] - are [% comp.bug_count %] [%+ terms.bugs %] + + [% IF comp.bug_count > 1 %] + are [% comp.bug_count %] [%+ terms.bugs %] [% ELSE %] - is [% comp.bug_count %] [%+ terms.bug %] + is [% comp.bug_count %] [%+ terms.bug %] [% END %] - + pending for this component. You should reassign - + [% IF comp.bug_count > 1 %] these [% terms.bugs %] [% ELSE %] this [% terms.bug %] [% END %] - + to another component before deleting this component.

[% ELSE %] @@ -189,7 +189,7 @@ for a component. ``IF comp.bug_count > 1`` means "if there are more than one bug Let's say your language has to deal with three plural forms and that the terms "bug" and "pending" should be declensed as well. -First, you'll have to populate the :file:`/template/en/default/global/variables.none.tmp` +First, you'll have to populate the :file:`/template/en/default/global/variables.none.tmpl` file with the declensions for "bug", which would give something like: .. code-block:: text @@ -200,7 +200,7 @@ file with the declensions for "bug", which would give something like: "bug2" => "declension for two bugs", "bug3" => "declension for three bugs", "bugs" => "declension for more than three bugs", - + Then, the previous code should look like: @@ -209,31 +209,31 @@ Then, the previous code should look like: [% IF !Param("allowbugdeletion") %]

Sorry, there - - [% IF comp.bug_count > 3 %] - are [% comp.bug_count %] pending [% terms.bugs %] + + [% IF comp.bug_count > 3 %] + are [% comp.bug_count %] pending [% terms.bugs %] [% ELSE %] - [% IF comp.bug_count == 0 %] - is [% comp.bug_count %] pending [% terms.bug0 %] + [% IF comp.bug_count == 0 %] + is [% comp.bug_count %] pending [% terms.bug0 %] [% ELSE %] - [% IF comp.bug_count == 1 %] + [% IF comp.bug_count == 1 %] is [% comp.bug_count %] pending [% terms.bug %] [% ELSE %] - [% IF comp.bug_count == 2 %] + [% IF comp.bug_count == 2 %] are [% comp.bug_count %] pending [% terms.bug2 %] [% ELSE %] - [% IF comp.bug_count == 3 %] - are [% comp.bug_count %] pending [% terms.bug3 %] + [% IF comp.bug_count == 3 %] + are [% comp.bug_count %] pending [% terms.bug3 %] [% END %] - + for this component. You should reassign - + [% IF comp.bug_count > 1 %] these [% terms.bugs %] [% ELSE %] this [% terms.bug %] [% END %] - + to another component before deleting this component.

[% ELSE %] diff --git a/docs/en/rst/localizing/get-the-source.rst b/docs/en/rst/localizing/get-the-source.rst index d25f8266e..d4c62a95c 100644 --- a/docs/en/rst/localizing/get-the-source.rst +++ b/docs/en/rst/localizing/get-the-source.rst @@ -49,7 +49,8 @@ also use a four-letter locale code, e.g. ``pt-BR`` for Brazilian Portuguese or ``zh-CN`` for Chinese (Simplified). In the rest of this guide, your locale code will be represented by ``ab-CD``. -Then, run: +Open a terminal and go to your Bugzilla installation's top-level directory +and then run: :command:`contrib/new-locale.pl ab-CD` diff --git a/docs/en/rst/localizing/localizing-documentation.rst b/docs/en/rst/localizing/localizing-documentation.rst index 593bcd4d1..7d30fa1c8 100644 --- a/docs/en/rst/localizing/localizing-documentation.rst +++ b/docs/en/rst/localizing/localizing-documentation.rst @@ -23,8 +23,8 @@ Though I recommend that you read the documents stated above, here are a few rule