/[gentoo]/xml/htdocs/doc/en/guide-localization.xml
Gentoo

Diff of /xml/htdocs/doc/en/guide-localization.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.28 Revision 1.33
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.28 2005/06/24 18:04:15 fox2mike Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.33 2005/11/25 20:36:01 jkt 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">
27This guide should help users localize their Gentoo Linux distribution to any 27This guide should help users localize their Gentoo Linux distribution to any
28European locale. It uses Germany as a case-study, since it is translated from 28European locale. It uses Germany as a case-study, since it is translated from
29the German doc. Includes configuration for use of the euro currency symbol. 29the German doc. Includes configuration for use of the euro currency symbol.
30</abstract> 30</abstract>
31 31
32<version>1.19</version> 32<version>1.24</version>
33<date>2005-06-24</date> 33<date>2005-11-25</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>
39 39
40<p> 40<p>
41In order to keep time properly, <path>/etc/localtime</path> must point to 41In order to keep time properly, <path>/etc/localtime</path> must contain the
42the correct time zone data file. Look around in 42correct time zone data file. Look around in <path>/usr/share/zoneinfo/</path>
43<path>/usr/share/zoneinfo/</path> and pick your timezone or a near-by big city. 43and pick your timezone or a near-by big city. Please avoid the
44<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
45indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
44</p> 46</p>
45 47
46<pre caption="setting the timezone"> 48<pre caption="setting the timezone">
47# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i> 49# <i>cp /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
48# <i>date</i> 50# <i>date</i>
49Sun Feb 16 08:26:44 CET 2003 51Sun Feb 16 08:26:44 CET 2003
50</pre> 52</pre>
51 53
52<note> 54<note>
106code (as specified in ISO-3199). 108code (as specified in ISO-3199).
107</p> 109</p>
108 110
109</body> 111</body>
110</section> 112</section>
111<section> 113<section id="variables">
112<title>Environment variables for locales</title> 114<title>Environment variables for locales</title>
113<body> 115<body>
114 116
115<p> 117<p>
116Locale settings are stored in environment variables. These are typically 118Locale settings are stored in environment variables. These are typically
210probably need to have programs compiled with the <c>nls</c> (Native language 212probably need to have programs compiled with the <c>nls</c> (Native language
211support) USE flag set. Most of the programs using nls also need the gettext 213support) USE flag set. Most of the programs using nls also need the gettext
212library to extract and use localized messages. Of course, Gentoo's Portage will 214library to extract and use localized messages. Of course, Gentoo's Portage will
213automatically install it when needed. 215automatically install it when needed.
214</p> 216</p>
217
218<p>
219There is also additional localisation variable called LINGUAS, which affects
220to localisation files that get installed in gettext-based programs, and decides
221used localisation for some specific software packages, such as
222<c>kde-base/kde-i18n</c> and <c>app-office/openoffice</c>. The variable
223takes in <e>space</e>-separated list of language codes, and suggested
224place 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,
230for German, Finnish and English:)</comment>
231LINGUAS="de fi en"
232</pre>
233
215 234
216</body> 235</body>
217</section> 236</section>
218<section> 237<section>
219<title>Generating Specific Locales</title> 238<title>Generating Specific Locales</title>
328<title>KDE</title> 347<title>KDE</title>
329<section> 348<section>
330<body> 349<body>
331 350
332<p> 351<p>
333For KDE you have to install the kde-i18n package with the appropriate 352For KDE you have to install the <c>kde-base/kde-i18n</c> package. Kde-i18n
334LINGUAS variable set: 353respects <uri link="#variables">LINGUAS variable</uri> described earlier.
335</p>
336
337<pre caption="Install localized KDE">
338# <i>nano -w /etc/make.conf</i>
339<comment>(Add in the LINGUAS variable. For instance, for the German language:)</comment>
340LINGUAS="de"
341
342<comment>(Now install kde-i18n)</comment>
343# <i>emerge kde-i18n</i>
344</pre> 354</p>
345 355
346</body> 356</body>
347</section> 357</section>
348</chapter> 358</chapter>
349 359
435</note> 445</note>
436 446
437</body> 447</body>
438</section> 448</section>
439<section> 449<section>
440<title>Language for OpenOffice.org</title> 450<title>OpenOffice.Org</title>
441<body> 451<body>
442 452
443<note>
444Customized default language is not available for openoffice-bin ebuild. The
445default language in the openoffice-bin is ENUS.
446</note>
447
448<p>
449Please note that this package now uses the LINGUAS variable to
450provide localization. The old LANGUAGE=ENUS|PORT system does <e>not</e> work
451anymore. The default language for OpenOffice.org is set as "US English". If you
452wish to change the default language for OpenOffice.org, check the ebuild for the
453default language code.
454</p> 453<p>
455 454The current <c>app-office/openoffice</c> (or <c>-ximian</c>) source ebuilds
456<pre caption="Example: emerge openoffice for german environment"> 455support <uri link="#variables">LINGUAS variable</uri> for selecting installed
457# <i>nano -w /etc/make.conf</i> 456GUI language packs. The current <e>stable</e>
458<comment>(Add in the LINGUAS variable. For instance, for the German language:)</comment> 457<c>app-office/openoffice-bin</c> binary ebuilds do <e>not</e> yet
459LINGUAS="de" 458support LINGUAS variable, however, so in order to use localised OpenOffice.Org
460 459you must either install the source version, or, with your discretion, the
461<comment>(Now install openoffice)</comment> 460unstable binary version. To see status of GUI translation,
462# <i>emerge openoffice</i> 461hyphenation, spell checking and other localisations on your language, please
462refer to
463<uri link="http://l10n.openoffice.org/languages.html">OpenOffice.Org
464localisation web site</uri>.
463</pre> 465</p>
464 466
465</body> 467</body>
466</section> 468</section>
467</chapter> 469</chapter>
468 470

Legend:
Removed from v.1.28  
changed lines
  Added in v.1.33

  ViewVC Help
Powered by ViewVC 1.1.20