Changes between Version 82 and Version 83 of TracL10N

Timestamp:

Jan 7, 2010, 3:47:50 PM (14 years ago)

Author:

Christian Boos

Comment:

#EditingGuidelines section added - some intro about the .po files (better late than never)

TracL10N

@@ -95 +95 @@
 on [http://transifex.org/wiki/About Transifex].
 
+
+
+
+=== Editing Guidelines ===
+
+There are tons of good guidelines on the web about how to write good translations.
+See for example: [http://techbase.kde.org/Localization/Concepts/PO_Odyssey PO_Odyssey] and [http://l10n.kde.org/docs/translation-howto/gui-step-by-step.html step-by-step], and other resources from http://l10n.kde.org.
+
+In short, a translation unit is typically something like:
+{{{
+#: trac/ticket/templates/milestone_delete.html:41
+#: trac/ticket/templates/milestone_view.html:105
+msgid "Delete milestone"
+msgstr "Supprimer le jalon"
+}}}
+
+- the "#:" lines are comments indicating the locations of the message in 
+  the source.
+- `msgid "..."` is the message itself, this should never be changed
+- `msgstr` is your translation; you should keep there the same structure,
+  as in the msgid. In particular the presence of "\n" at the beginning or 
+  the end of the msgid should be mirrored in msgstr
+- right after an automatic catalog update you'll see lots of:
+  - `# fuzzy` comments: this identifies translations that are only
+  approximated (the msgid has changed)
+  - `msgstr ""` translations: those are newly added translations
+
+There are a few more complex situations.
+
+Here's a message containing parameters:
+{{{
+#: trac/ticket/templates/milestone_view.html:26
+#, python-format
+msgid ""
+"Completed %(duration)s ago\n"
+"              (%(date)s)"
+msgstr ""
+"Atteint il y a %(duration)s\n"
+"                (%(date)s)"
+}}}
+
+Note that you need to have to keep the parameters names from `msgid` 
+in `msgstr`, although you can reorder them as needed.
+
+Another example, here's how a structured message looks like:
+{{{
+#: trac/ticket/templates/milestone_delete.html:45
+msgid ""
+"[1:Note:] See\n"
+"      [2:TracRoadmap] for help on using\n"
+"      the roadmap."
+msgstr ""
+"[1:Note :] consultez [2:TracRoadmap] pour obtenir de l'aide sur "
+"l'utilisation de la feuille de route."
+}}}
+
+The `[1: ...]` groups are used when the message contains markup
+(this is Genshi specific).
+It is important to keep the same semantic structure. 
+As with message parameters, the groups can be reordered but you should 
+have the same groups in msgid and msgstr.
+
+Of course, you can have messages that combine markup groups and 
+parameters names:
+{{{
+#: trac/ticket/templates/milestone_view.html:32
+#, python-format
+msgid ""
+"[1:%(duration)s late]\n"
+"              (%(date)s)"
+msgstr ""
+"[1:%(duration)s en retard]\n"
+"                (%(date)s)"
+}}}
+
+
+Finally, there's the translation of sentences which have a singular and
+a plural form:
+{{{
+#: trac/ticket/templates/query.html:29
+#: trac/ticket/templates/query_results.html:30
+#: trac/ticket/templates/report_view.html:94
+#, python-format
+msgid "%(num)s match"
+msgid_plural "%(num)s matches"
+msgstr[0] "%(num)s résultat"
+msgstr[1] "%(num)s résultats"
+}}}
+
+- when such a message is newly added, you'll have [[br]]
+  `#, fuzzy, python-format` as the first comment.
+  Be careful to remove only the `fuzzy, ` part, but not the `python-format` 
+  keyword.
+- some languages (zh, ko) don't have plural forms (plural == 1), 
+  so you only have to put a `msgstr[0]` line.
+- some other languages have more than 2 plural forms, so you need as 
+  many `msgstr[]` as needed.
+
+''Note: '' there are some problems with Genshi and Babel when all the `msgstr[]` need to have the same content. Also, Babel seems to handle well different parameters for msgid and msgid_plural, whereas `msgfmt` complains about those.
+{{{
+#!comment
+File that bug report ;-) 
+
+progress bar macros
+
+#: trac/templates/macros.html:214
+#, python-format
+msgid "%(num)s of %(total)s %(unit)s %(title)s"
+msgid_plural "%(num)s of %(total)s %(units)s %(title)s"
+msgstr[0] "%(num)s %(unit)s « %(title)s » sur %(total)s"
+msgstr[1] "%(num)s %(units)s « %(title)s » sur %(total)s"
+
+#: trac/templates/macros.html:227
+#, python-format
+msgid "%(title)s %(unit)s:"
+msgid_plural "%(title)s %(units)s:"
+msgstr[0] "%(unit)s « %(title)s » :"
+msgstr[1] "%(units)s « %(title)s » :"
+
+#: trac/templates/macros.html:237
+#, python-format
+msgid "Total %(unit)s:"
+msgid_plural "Total %(units)s:"
+msgstr[0] "%(unit)s au total :"
+msgstr[1] "%(units)s au total :"
+
+
+-- cboos
+}}}
+
+
 === Terms (Definitions) === #term-definitions