| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.31 2005/08/21 22:44:26 neysx Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.32 2005/09/24 13:06:18 flammie Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/guide-localization.xml"> |
5 | <guide link="/doc/en/guide-localization.xml"> |
| 6 | <title>Gentoo Linux Localization Guide</title> |
6 | <title>Gentoo Linux Localization Guide</title> |
| 7 | <author title="Author"> |
7 | <author title="Author"> |
| … | |
… | |
| 27 | This guide should help users localize their Gentoo Linux distribution to any |
27 | This guide should help users localize their Gentoo Linux distribution to any |
| 28 | European locale. It uses Germany as a case-study, since it is translated from |
28 | European locale. It uses Germany as a case-study, since it is translated from |
| 29 | the German doc. Includes configuration for use of the euro currency symbol. |
29 | the German doc. Includes configuration for use of the euro currency symbol. |
| 30 | </abstract> |
30 | </abstract> |
| 31 | |
31 | |
| 32 | <version>1.22</version> |
32 | <version>1.23</version> |
| 33 | <date>2005-08-22</date> |
33 | <date>2005-09-24</date> |
| 34 | |
34 | |
| 35 | <chapter> |
35 | <chapter> |
| 36 | <title>Time zone</title> |
36 | <title>Time zone</title> |
| 37 | <section> |
37 | <section> |
| 38 | <body> |
38 | <body> |
| … | |
… | |
| 108 | code (as specified in ISO-3199). |
108 | code (as specified in ISO-3199). |
| 109 | </p> |
109 | </p> |
| 110 | |
110 | |
| 111 | </body> |
111 | </body> |
| 112 | </section> |
112 | </section> |
| 113 | <section> |
113 | <section id="variables"> |
| 114 | <title>Environment variables for locales</title> |
114 | <title>Environment variables for locales</title> |
| 115 | <body> |
115 | <body> |
| 116 | |
116 | |
| 117 | <p> |
117 | <p> |
| 118 | Locale settings are stored in environment variables. These are typically |
118 | Locale settings are stored in environment variables. These are typically |
| … | |
… | |
| 212 | probably need to have programs compiled with the <c>nls</c> (Native language |
212 | probably need to have programs compiled with the <c>nls</c> (Native language |
| 213 | support) USE flag set. Most of the programs using nls also need the gettext |
213 | support) USE flag set. Most of the programs using nls also need the gettext |
| 214 | library to extract and use localized messages. Of course, Gentoo's Portage will |
214 | library to extract and use localized messages. Of course, Gentoo's Portage will |
| 215 | automatically install it when needed. |
215 | automatically install it when needed. |
| 216 | </p> |
216 | </p> |
|
|
217 | |
|
|
218 | <p> |
|
|
219 | There is also additional localisation variable called LINGUAS, which affects |
|
|
220 | to localisation files that get installed in gettext-based programs, and decides |
|
|
221 | used localisation for some specific software packages, such as |
|
|
222 | <c>kde-base/kde-i18n</c> and <c>app-office/openoffice</c>. The variable |
|
|
223 | takes in <e>space</e>-separated list of language codes, and suggested |
|
|
224 | place to set it is <path>/etc/make.conf</path>: |
|
|
225 | </p> |
|
|
226 | |
|
|
227 | <pre caption="setting LINGUAS in make.conf"> |
|
|
228 | # <i>nano -w /etc/make.conf</i> |
|
|
229 | <comment>(Add in the LINGUAS variable. For instance, |
|
|
230 | for German, Finnish and English:)</comment> |
|
|
231 | LINGUAS="de fi en" |
|
|
232 | </pre> |
|
|
233 | |
| 217 | |
234 | |
| 218 | </body> |
235 | </body> |
| 219 | </section> |
236 | </section> |
| 220 | <section> |
237 | <section> |
| 221 | <title>Generating Specific Locales</title> |
238 | <title>Generating Specific Locales</title> |
| … | |
… | |
| 330 | <title>KDE</title> |
347 | <title>KDE</title> |
| 331 | <section> |
348 | <section> |
| 332 | <body> |
349 | <body> |
| 333 | |
350 | |
| 334 | <p> |
351 | <p> |
| 335 | For KDE you have to install the kde-i18n package with the appropriate |
352 | For KDE you have to install the <c>kde-base/kde-i18n</c> package. Kde-i18n |
| 336 | LINGUAS variable set: |
353 | respects <uri link="#variables">LINGUAS variable</uri> described earlier. |
| 337 | </p> |
|
|
| 338 | |
|
|
| 339 | <pre caption="Install localized KDE"> |
|
|
| 340 | # <i>nano -w /etc/make.conf</i> |
|
|
| 341 | <comment>(Add in the LINGUAS variable. For instance, for the German language:)</comment> |
|
|
| 342 | LINGUAS="de" |
|
|
| 343 | |
|
|
| 344 | <comment>(Now install kde-i18n)</comment> |
|
|
| 345 | # <i>emerge kde-i18n</i> |
|
|
| 346 | </pre> |
354 | </p> |
| 347 | |
355 | |
| 348 | </body> |
356 | </body> |
| 349 | </section> |
357 | </section> |
| 350 | </chapter> |
358 | </chapter> |
| 351 | |
359 | |
| … | |
… | |
| 437 | </note> |
445 | </note> |
| 438 | |
446 | |
| 439 | </body> |
447 | </body> |
| 440 | </section> |
448 | </section> |
| 441 | <section> |
449 | <section> |
| 442 | <title>Language for OpenOffice.org</title> |
450 | <title>OpenOffice.Org</title> |
| 443 | <body> |
451 | <body> |
| 444 | |
452 | |
| 445 | <note> |
|
|
| 446 | Customized default language is not available for openoffice-bin ebuild. The |
|
|
| 447 | default language in the openoffice-bin is ENUS. |
|
|
| 448 | </note> |
|
|
| 449 | |
|
|
| 450 | <p> |
|
|
| 451 | Please note that this package now uses the LINGUAS variable to |
|
|
| 452 | provide localization. The old LANGUAGE=ENUS|PORT system does <e>not</e> work |
|
|
| 453 | anymore. The default language for OpenOffice.org is set as "US English". If you |
|
|
| 454 | wish to change the default language for OpenOffice.org, check the ebuild for the |
|
|
| 455 | default language code. |
|
|
| 456 | </p> |
453 | <p> |
| 457 | |
454 | The current <c>app-office/openoffice</c> (or <c>-ximian</c>) source ebuilds |
| 458 | <pre caption="Example: emerge openoffice for german + english environment"> |
455 | support <uri link="#variables">LINGUAS variable</uri> for selecting installed |
| 459 | # <i>nano -w /etc/make.conf</i> |
456 | GUI language packs. The current <e>stable</e> |
| 460 | <comment>(Add in the LINGUAS variable. For instance, for the German and English language:)</comment> |
457 | <c>app-office/openoffice-bin</c> binary ebuilds do <e>not</e> yet |
| 461 | LINGUAS="de en" |
458 | support LINGUAS variable, however, so in order to use localised OpenOffice.Org |
| 462 | |
459 | you must either install the source version, or, with your discretion, the |
| 463 | <comment>(Now install openoffice)</comment> |
460 | unstable binary version. To see status of GUI translation, |
| 464 | # <i>emerge openoffice</i> |
461 | hyphenation, spell checking and other localisations on your language, please |
|
|
462 | refer to |
|
|
463 | <uri link="http://l10n.openoffice.org/languages.html">OpenOffice.Org |
|
|
464 | localisation web site</uri>. |
| 465 | </pre> |
465 | </p> |
| 466 | |
466 | |
| 467 | </body> |
467 | </body> |
| 468 | </section> |
468 | </section> |
| 469 | </chapter> |
469 | </chapter> |
| 470 | |
470 | |