po4a/po/l10n.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2010-05-06 17:34-0400\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "MIME-Version: 1.0\n"
  15 "Content-Type: text/plain; charset=utf-8\n"
  16 "Content-Transfer-Encoding: ENCODING"
  17
  18 #. type: Content of: <chapter><title>
  19 #: l10n.dbk:7
  20 msgid "Internationalization and Translations"
  21 msgstr ""
  22
  23 #. type: Content of: <chapter><para>
  24 #: l10n.dbk:9
  25 msgid ""
  26 "Debian supports an ever-increasing number of natural languages.  Even if you "
  27 "are a native English speaker and do not speak any other language, it is part "
  28 "of your duty as a maintainer to be aware of issues of internationalization "
  29 "(abbreviated i18n because there are 18 letters between the 'i' and the 'n' "
  30 "in internationalization).  Therefore, even if you are ok with English-only "
  31 "programs, you should read most of this chapter."
  32 msgstr ""
  33
  34 #. type: Content of: <chapter><para>
  35 #: l10n.dbk:17
  36 msgid ""
  37 "According to <ulink "
  38 "url=\"http://&www-debian-org;/doc/manuals/intro-i18n/\">Introduction to "
  39 "i18n</ulink> from Tomohiro KUBOTA, I18N (internationalization) means "
  40 "modification of a software or related technologies so that a software can "
  41 "potentially handle multiple languages, customs, and so on in the world, "
  42 "while L10N (localization) means implementation of a specific language for an "
  43 "already internationalized software."
  44 msgstr ""
  45
  46 #. type: Content of: <chapter><para>
  47 #: l10n.dbk:26
  48 msgid ""
  49 "l10n and i18n are interconnected, but the difficulties related to each of "
  50 "them are very different.  It's not really difficult to allow a program to "
  51 "change the language in which texts are displayed based on user settings, but "
  52 "it is very time consuming to actually translate these messages.  On the "
  53 "other hand, setting the character encoding is trivial, but adapting the code "
  54 "to use several character encodings is a really hard problem."
  55 msgstr ""
  56
  57 #. type: Content of: <chapter><para>
  58 #: l10n.dbk:34
  59 msgid ""
  60 "Setting aside the i18n problems, where no general guideline can be given, "
  61 "there is actually no central infrastructure for l10n within Debian which "
  62 "could be compared to the buildd mechanism for porting.  So most of the work "
  63 "has to be done manually."
  64 msgstr ""
  65
  66 #. type: Content of: <chapter><section><title>
  67 #: l10n.dbk:40
  68 msgid "How translations are handled within Debian"
  69 msgstr ""
  70
  71 #. type: Content of: <chapter><section><para>
  72 #: l10n.dbk:42
  73 msgid ""
  74 "Handling translation of the texts contained in a package is still a manual "
  75 "task, and the process depends on the kind of text you want to see "
  76 "translated."
  77 msgstr ""
  78
  79 #. type: Content of: <chapter><section><para>
  80 #: l10n.dbk:46
  81 msgid ""
  82 "For program messages, the gettext infrastructure is used most of the time.  "
  83 "Most of the time, the translation is handled upstream within projects like "
  84 "the <ulink url=\"http://www.iro.umontreal.ca/contrib/po/HTML/\">Free "
  85 "Translation Project</ulink>, the <ulink "
  86 "url=\"http://developer.gnome.org/projects/gtp/\">Gnome translation "
  87 "Project</ulink> or the <ulink url=\"http://i18n.kde.org/\">KDE one</ulink>.  "
  88 "The only centralized resource within Debian is the <ulink "
  89 "url=\"http://&www-debian-org;/intl/l10n/\">Central Debian translation "
  90 "statistics</ulink>, where you can find some statistics about the translation "
  91 "files found in the actual packages, but no real infrastructure to ease the "
  92 "translation process."
  93 msgstr ""
  94
  95 #. type: Content of: <chapter><section><para>
  96 #: l10n.dbk:59
  97 msgid ""
  98 "An effort to translate the package descriptions started long ago, even if "
  99 "very little support is offered by the tools to actually use them (i.e., only "
 100 "APT can use them, when configured correctly).  Maintainers don't need to do "
 101 "anything special to support translated package descriptions; translators "
 102 "should use the <ulink url=\"http://ddtp.debian.org/\">DDTP</ulink>."
 103 msgstr ""
 104
 105 #. type: Content of: <chapter><section><para>
 106 #: l10n.dbk:66
 107 msgid ""
 108 "For debconf templates, maintainers should use the po-debconf package to ease "
 109 "the work of translators, who could use the DDTP to do their work (but the "
 110 "French and Brazilian teams don't).  Some statistics can be found both on the "
 111 "DDTP site (about what is actually translated), and on the <ulink "
 112 "url=\"http://&www-debian-org;/intl/l10n/\">Central Debian translation "
 113 "statistics</ulink> site (about what is integrated in the packages)."
 114 msgstr ""
 115
 116 #. type: Content of: <chapter><section><para>
 117 #: l10n.dbk:74
 118 msgid ""
 119 "For web pages, each l10n team has access to the relevant CVS, and the "
 120 "statistics are available from the Central Debian translation statistics "
 121 "site."
 122 msgstr ""
 123
 124 #. type: Content of: <chapter><section><para>
 125 #: l10n.dbk:78
 126 msgid ""
 127 "For general documentation about Debian, the process is more or less the same "
 128 "as for the web pages (the translators have access to the CVS), but there are "
 129 "no statistics pages."
 130 msgstr ""
 131
 132 #. type: Content of: <chapter><section><para>
 133 #: l10n.dbk:83
 134 msgid ""
 135 "For package-specific documentation (man pages, info documents, other "
 136 "formats), almost everything remains to be done."
 137 msgstr ""
 138
 139 #. type: Content of: <chapter><section><para>
 140 #: l10n.dbk:87
 141 msgid ""
 142 "Most notably, the KDE project handles translation of its documentation in "
 143 "the same way as its program messages."
 144 msgstr ""
 145
 146 #. type: Content of: <chapter><section><para>
 147 #: l10n.dbk:91
 148 msgid ""
 149 "There is an effort to handle Debian-specific man pages within a <ulink "
 150 "url=\"&url-cvsweb;manpages/?cvsroot=debian-doc\">specific CVS "
 151 "repository</ulink>."
 152 msgstr ""
 153
 154 #. type: Content of: <chapter><section><title>
 155 #: l10n.dbk:98
 156 msgid "I18N &amp; L10N FAQ for maintainers"
 157 msgstr ""
 158
 159 #. type: Content of: <chapter><section><para>
 160 #: l10n.dbk:100
 161 msgid ""
 162 "This is a list of problems that maintainers may face concerning i18n and "
 163 "l10n.  While reading this, keep in mind that there is no real consensus on "
 164 "these points within Debian, and that this is only advice.  If you have a "
 165 "better idea for a given problem, or if you disagree on some points, feel "
 166 "free to provide your feedback, so that this document can be enhanced."
 167 msgstr ""
 168
 169 #. type: Content of: <chapter><section><section><title>
 170 #: l10n.dbk:107
 171 msgid "How to get a given text translated"
 172 msgstr ""
 173
 174 #. type: Content of: <chapter><section><section><para>
 175 #: l10n.dbk:109
 176 msgid ""
 177 "To translate package descriptions or debconf templates, you have nothing to "
 178 "do; the DDTP infrastructure will dispatch the material to translate to "
 179 "volunteers with no need for interaction from your part."
 180 msgstr ""
 181
 182 #. type: Content of: <chapter><section><section><para>
 183 #: l10n.dbk:114
 184 msgid ""
 185 "For all other material (gettext files, man pages, or other documentation), "
 186 "the best solution is to put your text somewhere on the Internet, and ask on "
 187 "debian-i18n for a translation in different languages.  Some translation team "
 188 "members are subscribed to this list, and they will take care of the "
 189 "translation and of the reviewing process.  Once they are done, you will get "
 190 "your translated document from them in your mailbox."
 191 msgstr ""
 192
 193 #. type: Content of: <chapter><section><section><title>
 194 #: l10n.dbk:124
 195 msgid "How to get a given translation reviewed"
 196 msgstr ""
 197
 198 #. type: Content of: <chapter><section><section><para>
 199 #: l10n.dbk:126
 200 msgid ""
 201 "From time to time, individuals translate some texts in your package and will "
 202 "ask you for inclusion of the translation in the package.  This can become "
 203 "problematic if you are not fluent in the given language.  It is a good idea "
 204 "to send the document to the corresponding l10n mailing list, asking for a "
 205 "review.  Once it has been done, you should feel more confident in the "
 206 "quality of the translation, and feel safe to include it in your package."
 207 msgstr ""
 208
 209 #. type: Content of: <chapter><section><section><title>
 210 #: l10n.dbk:136
 211 msgid "How to get a given translation updated"
 212 msgstr ""
 213
 214 #. type: Content of: <chapter><section><section><para>
 215 #: l10n.dbk:138
 216 msgid ""
 217 "If you have some translations of a given text lying around, each time you "
 218 "update the original, you should ask the previous translator to update the "
 219 "translation with your new changes.  Keep in mind that this task takes time; "
 220 "at least one week to get the update reviewed and all."
 221 msgstr ""
 222
 223 #. type: Content of: <chapter><section><section><para>
 224 #: l10n.dbk:144
 225 msgid ""
 226 "If the translator is unresponsive, you may ask for help on the corresponding "
 227 "l10n mailing list.  If everything fails, don't forget to put a warning in "
 228 "the translated document, stating that the translation is somehow outdated, "
 229 "and that the reader should refer to the original document if possible."
 230 msgstr ""
 231
 232 #. type: Content of: <chapter><section><section><para>
 233 #: l10n.dbk:150
 234 msgid ""
 235 "Avoid removing a translation completely because it is outdated.  Old "
 236 "documentation is often better than no documentation at all for non-English "
 237 "speakers."
 238 msgstr ""
 239
 240 #. type: Content of: <chapter><section><section><title>
 241 #: l10n.dbk:157
 242 msgid "How to handle a bug report concerning a translation"
 243 msgstr ""
 244
 245 #.  TODO: add the i18n tag to the bug?
 246 #. type: Content of: <chapter><section><section><para>
 247 #: l10n.dbk:159
 248 msgid ""
 249 "The best solution may be to mark the bug as forwarded to upstream, and "
 250 "forward it to both the previous translator and his/her team (using the "
 251 "corresponding debian-l10n-XXX mailing list)."
 252 msgstr ""
 253
 254 #. type: Content of: <chapter><section><title>
 255 #: l10n.dbk:169
 256 msgid "I18N &amp; L10N FAQ for translators"
 257 msgstr ""
 258
 259 #. type: Content of: <chapter><section><para>
 260 #: l10n.dbk:171
 261 msgid ""
 262 "While reading this, please keep in mind that there is no general procedure "
 263 "within Debian concerning these points, and that in any case, you should "
 264 "collaborate with your team and the package maintainer."
 265 msgstr ""
 266
 267 #. type: Content of: <chapter><section><section><title>
 268 #: l10n.dbk:176
 269 msgid "How to help the translation effort"
 270 msgstr ""
 271
 272 #. type: Content of: <chapter><section><section><para>
 273 #: l10n.dbk:178
 274 msgid ""
 275 "Choose what you want to translate, make sure that nobody is already working "
 276 "on it (using your debian-l10n-XXX mailing list), translate it, get it "
 277 "reviewed by other native speakers on your l10n mailing list, and provide it "
 278 "to the maintainer of the package (see next point)."
 279 msgstr ""
 280
 281 #. type: Content of: <chapter><section><section><title>
 282 #: l10n.dbk:186
 283 msgid "How to provide a translation for inclusion in a package"
 284 msgstr ""
 285
 286 #. type: Content of: <chapter><section><section><para>
 287 #: l10n.dbk:188
 288 msgid ""
 289 "Make sure your translation is correct (asking for review on your l10n "
 290 "mailing list) before providing it for inclusion.  It will save time for "
 291 "everyone, and avoid the chaos resulting in having several versions of the "
 292 "same document in bug reports."
 293 msgstr ""
 294
 295 #. type: Content of: <chapter><section><section><para>
 296 #: l10n.dbk:194
 297 msgid ""
 298 "The best solution is to file a regular bug containing the translation "
 299 "against the package.  Make sure to use the 'PATCH' tag, and to not use a "
 300 "severity higher than 'wishlist', since the lack of translation never "
 301 "prevented a program from running."
 302 msgstr ""
 303
 304 #. type: Content of: <chapter><section><title>
 305 #: l10n.dbk:204
 306 msgid "Best current practice concerning l10n"
 307 msgstr ""
 308
 309 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
 310 #: l10n.dbk:208
 311 msgid ""
 312 "As a maintainer, never edit the translations in any way (even to reformat "
 313 "the layout) without asking on the corresponding l10n mailing list.  You risk "
 314 "for example breaksing the encoding of the file by doing so.  Moreover, what "
 315 "you consider an error can be right (or even needed) in the given language."
 316 msgstr ""
 317
 318 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
 319 #: l10n.dbk:216
 320 msgid ""
 321 "As a translator, if you find an error in the original text, make sure to "
 322 "report it.  Translators are often the most attentive readers of a given "
 323 "text, and if they don't report the errors they find, nobody will."
 324 msgstr ""
 325
 326 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
 327 #: l10n.dbk:223
 328 msgid ""
 329 "In any case, remember that the major issue with l10n is that it requires "
 330 "several people to cooperate, and that it is very easy to start a flamewar "
 331 "about small problems because of misunderstandings.  So if you have problems "
 332 "with your interlocutor, ask for help on the corresponding l10n mailing list, "
 333 "on debian-i18n, or even on debian-devel (but beware, l10n discussions very "
 334 "often become flamewars on that list :)"
 335 msgstr ""
 336
 337 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
 338 #: l10n.dbk:233
 339 msgid ""
 340 "In any case, cooperation can only be achieved with <emphasis "
 341 "role=\"strong\">mutual respect</emphasis>."
 342 msgstr ""