summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGervase Markham <gerv@gerv.net>2015-11-21 15:34:50 +0100
committerGervase Markham <gerv@gerv.net>2015-11-21 15:34:50 +0100
commit24a6c0e8bc5d81f90f582f05bf055570ea5dee50 (patch)
tree4c5ce9fe3ae58eca14c185bc9bfac90be9d8563a
parentca3c99b1b61151dd34a1cdfc748fea57842f6ad4 (diff)
downloadbugzilla-24a6c0e8bc5d81f90f582f05bf055570ea5dee50.tar.gz
bugzilla-24a6c0e8bc5d81f90f582f05bf055570ea5dee50.tar.xz
Bug 1226865 - bug fixes to localization documentation.
-rw-r--r--docs/en/rst/localizing/caveats.rst42
-rw-r--r--docs/en/rst/localizing/get-the-source.rst3
-rw-r--r--docs/en/rst/localizing/localizing-documentation.rst4
-rw-r--r--docs/en/rst/localizing/shipping.rst3
4 files changed, 28 insertions, 24 deletions
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") %]
<p>
Sorry, there
-
- [% IF comp.bug_count &gt; 1 %]
- are [% comp.bug_count %] [%+ terms.bugs %]
+
+ [% IF comp.bug_count &gt; 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 &gt; 1 %]
these [% terms.bugs %]
[% ELSE %]
this [% terms.bug %]
[% END %]
-
+
to another component before deleting this component.
</p>
[% 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") %]
<p>
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 &gt; 1 %]
these [% terms.bugs %]
[% ELSE %]
this [% terms.bug %]
[% END %]
-
+
to another component before deleting this component.
</p>
[% 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
<ul>
<li>In <code>index.rst</code> files, never localize what is under the <code>.. toctree::</code> directive: these are file names.</li>
- <li>Never localize a term surrounded with a double dot and two colons. For instance: <code><mark>.. warning::</mark> <span class="green">This is a warning.</span></code>. This
- will be automatically localized if necessary at compilation time. You can localize what is located after, in green in this example.</li>
+ <li>Never localize a term surrounded with a double dot and two colons. For instance: <code><mark>.. warning::</mark> This is a warning</code>. This
+ will be automatically localized if necessary at compilation time. You can localize any text that comes after ("This is a warning" in this example).</li>
<li>Exception: do not localize what is located after the directive <code>.. highlight:: console</code>. The word console here is for formatting purpose.</li>
<li>Do not localize a term surrounded with two colons or with the signs lesser than and greater than:
<code>:<mark>ref</mark>:`<span class="green">Démarrage rapide</span>&lt;<mark>quick-start</mark>&gt;`</code>. "ref" is a reserved word and "quick-start" is a file name. In the following syntax example, do not localize "using"
diff --git a/docs/en/rst/localizing/shipping.rst b/docs/en/rst/localizing/shipping.rst
index 556d88114..8afabc3b7 100644
--- a/docs/en/rst/localizing/shipping.rst
+++ b/docs/en/rst/localizing/shipping.rst
@@ -10,4 +10,7 @@ Bugzilla administrator will untar in their ``$BUGZILLA_HOME`` directory.
This command will find all of the files you've localized and put them into
an appropriate tarball. Don't forget to replace both instances of ``ab-CD``:
+Open a terminal and go to your Bugzilla installation's top-level directory
+and then run:
+
:command:`find -name "ab-CD" -print0 -o -path "./data" -prune | tar -cjvf ../bugzilla-ab-CD.tar.bz2 --null -T -`