/[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.18 Revision 1.31
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.18 2005/02/05 14:53:36 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.31 2005/08/21 22:44:26 neysx 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">
24</author> 24</author>
25 25
26<abstract> 26<abstract>
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.13</version> 32<version>1.22</version>
33<date>2005-02-05</date> 33<date>2005-08-22</date>
34 34
35<chapter> 35<chapter>
36<title>Timezone</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 point to 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>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
48# <i>date</i> 50# <i>date</i>
64</body> 66</body>
65</section> 67</section>
66</chapter> 68</chapter>
67 69
68<chapter> 70<chapter>
69<title>System Clock</title> 71<title>Hardware Clock</title>
70<section> 72<section>
71<body> 73<body>
72 74
73<p> 75<p>
74In most Gentoo Linux installations, your system clock is set to 76In most Gentoo Linux installations, your hardware clock is set to
75UTC (or GMT, Greenwhich Mean Time) and then your timezone is 77UTC (or GMT, Greenwich Mean Time) and then your timezone is
76taken into account to determine the actual, local time. If, 78taken into account to determine the actual, local time. If,
77for some reason, you need your system clock not to be in UTC, 79for some reason, you need your hardware clock not to be in UTC,
78you will need to edit <path>/etc/rc.conf</path> and change the 80you will need to edit <path>/etc/conf.d/clock</path> and change the
79value of <c>CLOCK</c>. 81value of <c>CLOCK</c> from <c>UTC</c> to <c>local</c>.
80</p> 82</p>
81 83
82<pre caption="local vs. GMT clock"> 84<pre caption="local vs. GMT clock">
83<codenote>recommended:</codenote> 85<comment>(recommended:)</comment>
84CLOCK="UTC" 86CLOCK="UTC"
85<codenote>or:</codenote> 87<comment>(or:)</comment>
86CLOCK="local" 88CLOCK="local"
87</pre> 89</pre>
88 90
89</body> 91</body>
90</section> 92</section>
99<p> 101<p>
100A Locale is a set of information that most programs use for determining 102A Locale is a set of information that most programs use for determining
101country and language specific settings. The locales and their data 103country and language specific settings. The locales and their data
102are part of the system library and can be found 104are part of the system library and can be found
103at <path>/usr/share/locale</path> on most systems. A locale name is generally 105at <path>/usr/share/locale</path> on most systems. A locale name is generally
104named <c>ab_CD</c >where <c>ab</c> is your two (or three) letter 106named <c>ab_CD</c> where <c>ab</c> is your two (or three) letter
105language code (as specified in ISO-639) and <c>CD</c> is your two letter country 107language code (as specified in ISO-639) and <c>CD</c> is your two letter country
106code (as specified in ISO-3199). 108code (as specified in ISO-3199).
107</p> 109</p>
108 110
109</body> 111</body>
136</tr> 138</tr>
137<tr> 139<tr>
138 <ti>LC_COLLATE</ti> 140 <ti>LC_COLLATE</ti>
139 <ti> 141 <ti>
140 Define alphabetical ordering of strings. This affects eg. output of sorted 142 Define alphabetical ordering of strings. This affects eg. output of sorted
141 dir listing. 143 directory listing.
142 </ti> 144 </ti>
143</tr> 145</tr>
144<tr> 146<tr>
145 <ti>LC_CTYPE</ti> 147 <ti>LC_CTYPE</ti>
146 <ti> 148 <ti>
182 Defines all locale settings at once. This setting can be overridden by 184 Defines all locale settings at once. This setting can be overridden by
183 individual LC_* settings above or even by LC_ALL. 185 individual LC_* settings above or even by LC_ALL.
184 </ti> 186 </ti>
185</tr> 187</tr>
186</table> 188</table>
189
190<note>
191Even though most programs work with LC_ALL only, some of them misbehave if
192LC_ALL is set but LANG isn't. If you want to play safe, set them <e>both</e>.
193</note>
187 194
188<p> 195<p>
189Most typically users only set the LANG variable and perhaps LC_CTYPE variable 196Most typically users only set the LANG variable and perhaps LC_CTYPE variable
190on user level by adding definitions to shells startup files defining 197on user level by adding definitions to shells startup files defining
191the environment variable manually from command line: 198the environment variable manually from command line:
239<body> 246<body>
240 247
241<p> 248<p>
242You will probably only use one or maybe two locales on your system. Up until now 249You will probably only use one or maybe two locales on your system. Up until now
243after compiling <c>glibc</c> a full set of all available locales has been 250after compiling <c>glibc</c> a full set of all available locales has been
244created. As of now you can activate the <c>userlocales</c> USE flag und specify 251created. As of now you can activate the <c>userlocales</c> USE flag and specify
245only the locales you will need in <path>/etc/locales.build</path>. 252only the locales you will need in <path>/etc/locales.build</path>.
246</p> 253</p>
247 254
248<pre caption="Activate the userlocales USE flag especially for glibc"> 255<pre caption="Activate the userlocales USE flag especially for glibc">
249echo "sys-libs/glibc userlocales" >> /etc/portage/package.use 256echo "sys-libs/glibc userlocales" >> /etc/portage/package.use
274<section> 281<section>
275<body> 282<body>
276 283
277<p> 284<p>
278The keyboard layout used by the console is set in 285The keyboard layout used by the console is set in
279<path>/etc/rc.conf</path> by the <c>KEYMAP</c> variable. 286<path>/etc/conf.d/keymaps</path> by the <c>KEYMAP</c> variable.
280Valid values can be found in 287Valid values can be found in
281<path>/usr/share/keymaps/<c>{arch}</c>/</path>. 288<path>/usr/share/keymaps/<c>{arch}</c>/</path>.
282<path>i386</path> has further subdivisions into layout 289<path>i386</path> has further subdivisions into layout
283(<path>qwerty/</path>, <path>azerty/</path>, etc.). Some 290(<path>qwerty/</path>, <path>azerty/</path>, etc.). Some
284languages have multiple options, so you may wish to experiment 291languages have multiple options, so you may wish to experiment
300<section> 307<section>
301<body> 308<body>
302 309
303<p> 310<p>
304The keyboard layout to be used by the X server is specified 311The keyboard layout to be used by the X server is specified
305in <path>/etc/X11/XF86Config</path> by the <c>XkbLayout</c> 312in <path>/etc/X11/xorg.conf</path> by the <c>XkbLayout</c>
306option. 313option.
307</p> 314</p>
308 315
309<pre caption="setting the X keymap"> 316<pre caption="setting the X keymap">
310 Section "InputDevice" 317 Section "InputDevice"
324<section> 331<section>
325<body> 332<body>
326 333
327<p> 334<p>
328For KDE you have to install the kde-i18n package with the appropriate 335For KDE you have to install the kde-i18n package with the appropriate
329LINGUAS environment variable set:</p> 336LINGUAS variable set:
337</p>
330 338
331<pre caption="Install localized KDE"> 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>
342LINGUAS="de"
343
344<comment>(Now install kde-i18n)</comment>
332# <i>LINGUAS="de" emerge kde-i18n</i> 345# <i>emerge kde-i18n</i>
333</pre> 346</pre>
334 347
335</body> 348</body>
336</section> 349</section>
337</chapter> 350</chapter>
388rather than adding a new one. To change our xterm font, for 401rather than adding a new one. To change our xterm font, for
389instance: 402instance:
390</p> 403</p>
391 404
392<pre caption="setting fonts for xterm"> 405<pre caption="setting fonts for xterm">
393<codenote>(in your home directory)</codenote> 406<comment>(in your home directory)</comment>
394# <i>echo 'XTerm*font: fixed' >> .Xresources </i> 407# <i>echo 'XTerm*font: fixed' >> .Xresources </i>
395# <i>xrdb -merge .Xresources</i> 408# <i>xrdb -merge .Xresources</i>
396</pre> 409</pre>
397 410
398</body> 411</body>
424</note> 437</note>
425 438
426</body> 439</body>
427</section> 440</section>
428<section> 441<section>
429<title>Language for OpenOffice</title> 442<title>Language for OpenOffice.org</title>
430<body> 443<body>
431 444
432<note> 445<note>
433Customized default language is not available for openoffice-bin ebuild. The 446Customized default language is not available for openoffice-bin ebuild. The
434default language in the openoffice-bin is ENUS. 447default language in the openoffice-bin is ENUS.
435</note> 448</note>
436 449
437<p> 450<p>
451Please note that this package now uses the LINGUAS variable to
452provide localization. The old LANGUAGE=ENUS|PORT system does <e>not</e> work
438The default language for OpenOffice is set as "ENUS"(01). If you wish to 453anymore. The default language for OpenOffice.org is set as "US English". If you
439change the default language for OpenOffice, check the ebuild for the 454wish to change the default language for OpenOffice.org, check the ebuild for the
440default language code. 455default language code.
441</p> 456</p>
442 457
443<pre caption="emerge openoffice with desired default language"> 458<pre caption="Example: emerge openoffice for german + english environment">
459# <i>nano -w /etc/make.conf</i>
460<comment>(Add in the LINGUAS variable. For instance, for the German and English language:)</comment>
461LINGUAS="de en"
462
463<comment>(Now install openoffice)</comment>
444# <i>LANGUAGE="01" emerge openoffice</i> 464# <i>emerge openoffice</i>
445<comment>01 is the ENUS language code for openoffice</comment>
446</pre> 465</pre>
447 466
448</body> 467</body>
449</section> 468</section>
450</chapter> 469</chapter>

Legend:
Removed from v.1.18  
changed lines
  Added in v.1.31

  ViewVC Help
Powered by ViewVC 1.1.20