/[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.22 Revision 1.23
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.22 2005/05/25 16:54:08 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.23 2005/05/25 17:10:37 swift 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">
8 Alexander Holler 8 Alexander Holler
9</author> 9</author>
10<author title="Translator/Editor"> 10<author title="Translator/Editor">
11 <mail link="slucy@uchicago.edu">Steven Lucy</mail> 11 <mail link="slucy@uchicago.edu">Steven Lucy</mail>
12</author> 12</author>
13<author title="Editor"> 13<author title="Editor">
14 <mail link="bennyc@gentoo.org">Benny Chuang</mail> 14 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
15</author> 15</author>
16<author title="Editor"> 16<author title="Editor">
17 <mail link="pylon@gentoo.org">Lars Weiler</mail> 17 <mail link="pylon@gentoo.org">Lars Weiler</mail>
18</author> 18</author>
19<author title="Editor"> 19<author title="Editor">
20 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> 20 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
21</author> 21</author>
22<author title="Editor"> 22<author title="Editor">
23 <mail link="flammie@gentoo.org">Flammie Pirinen</mail> 23 <mail link="flammie@gentoo.org">Flammie Pirinen</mail>
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.14</version> 32<version>1.14</version>
33<date>2005-05-09</date> 33<date>2005-05-09</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
42the correct time zone data file. Look around in 42the correct time zone data file. Look around in
43<path>/usr/share/zoneinfo/</path> and pick your timezone or a near-by big city. 43<path>/usr/share/zoneinfo/</path> and pick your timezone or a near-by big city.
44</p> 44</p>
45 45
46<pre caption="setting the timezone"> 46<pre caption="setting the timezone">
47# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i> 47# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
48# <i>date</i> 48# <i>date</i>
49Sun Feb 16 08:26:44 CET 2003 49Sun Feb 16 08:26:44 CET 2003
50</pre> 50</pre>
51 51
60(<path>.bash_profile</path> for bash) for a user-level setting. In this case 60(<path>.bash_profile</path> for bash) for a user-level setting. In this case
61<c>TZ="Europe/Berlin"</c>. 61<c>TZ="Europe/Berlin"</c>.
62</note> 62</note>
63 63
64</body> 64</body>
65</section> 65</section>
66</chapter> 66</chapter>
67 67
68<chapter> 68<chapter>
69<title>System Clock</title> 69<title>System Clock</title>
70<section> 70<section>
71<body> 71<body>
72 72
73<p> 73<p>
74In most Gentoo Linux installations, your system clock is set to 74In most Gentoo Linux installations, your system clock is set to
75UTC (or GMT, Greenwhich Mean Time) and then your timezone is 75UTC (or GMT, Greenwich Mean Time) and then your timezone is
76taken into account to determine the actual, local time. If, 76taken into account to determine the actual, local time. If,
77for some reason, you need your system clock not to be in UTC, 77for some reason, you need your system clock not to be in UTC,
78you will need to edit <path>/etc/rc.conf</path> and change the 78you will need to edit <path>/etc/rc.conf</path> and change the
79value of <c>CLOCK</c>. 79value of <c>CLOCK</c>.
80</p> 80</p>
81 81
82<pre caption="local vs. GMT clock"> 82<pre caption="local vs. GMT clock">
83<comment>(recommended:)</comment> 83<comment>(recommended:)</comment>
84CLOCK="UTC" 84CLOCK="UTC"
85<comment>(or:)</comment> 85<comment>(or:)</comment>
86CLOCK="local" 86CLOCK="local"
87</pre> 87</pre>
88 88
89</body> 89</body>
90</section> 90</section>
126<tr> 126<tr>
127 <th>Variable name</th> 127 <th>Variable name</th>
128 <th>Explanation</th> 128 <th>Explanation</th>
129</tr> 129</tr>
130<tr> 130<tr>
131 <ti>LC_ALL</ti> 131 <ti>LC_ALL</ti>
132 <ti> 132 <ti>
133 Define all locale settings at once. This is the top level setting for 133 Define all locale settings at once. This is the top level setting for
134 locales which will override any other setting. 134 locales which will override any other setting.
135 </ti> 135 </ti>
136</tr> 136</tr>
137<tr> 137<tr>
138 <ti>LC_COLLATE</ti> 138 <ti>LC_COLLATE</ti>
139 <ti> 139 <ti>
140 Define alphabetical ordering of strings. This affects eg. output of sorted 140 Define alphabetical ordering of strings. This affects eg. output of sorted
141 dir listing. 141 directory listing.
142 </ti> 142 </ti>
143</tr> 143</tr>
144<tr> 144<tr>
145 <ti>LC_CTYPE</ti> 145 <ti>LC_CTYPE</ti>
146 <ti> 146 <ti>
147 Define the character handling properties for the system. This determines 147 Define the character handling properties for the system. This determines
148 which characters are seen as part of alphabet, numeric and so on. This also 148 which characters are seen as part of alphabet, numeric and so on. This also
149 determines the character set used, if applicable. 149 determines the character set used, if applicable.
150 </ti> 150 </ti>
151</tr> 151</tr>
152<tr> 152<tr>
153 <ti>LC_MESSAGES</ti> 153 <ti>LC_MESSAGES</ti>
154 <ti> 154 <ti>
155 Programs' localizations for applications that use message based localization 155 Programs' localizations for applications that use message based localization
156 scheme (majority of Gnu programs, see next chapters for closer information 156 scheme (majority of Gnu programs, see next chapters for closer information
229</p> 229</p>
230 230
231<pre caption="Exporting the LANG variable"> 231<pre caption="Exporting the LANG variable">
232# <i>export LANG="en_US.ISO-8859-15"</i> 232# <i>export LANG="en_US.ISO-8859-15"</i>
233</pre> 233</pre>
234 234
235</body> 235</body>
236</section> 236</section>
237<section> 237<section>
238<title>The userlocales USE flag</title> 238<title>The userlocales USE flag</title>
239<body> 239<body>
240 240
241<p> 241<p>
242You will probably only use one or maybe two locales on your system. Up until now 242You 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 243after 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 244created. 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>. 245only the locales you will need in <path>/etc/locales.build</path>.
246</p> 246</p>
247 247
248<pre caption="Activate the userlocales USE flag especially for glibc"> 248<pre caption="Activate the userlocales USE flag especially for glibc">
249echo "sys-libs/glibc userlocales" >> /etc/portage/package.use 249echo "sys-libs/glibc userlocales" >> /etc/portage/package.use
250</pre> 250</pre>
251 251
252<p> 252<p>
253Now specify the locales you want to be able to use: 253Now specify the locales you want to be able to use:
254</p> 254</p>
255 255
256<pre caption="Adding locales to /etc/locales.build"> 256<pre caption="Adding locales to /etc/locales.build">
257en_US/ISO-8859-1 257en_US/ISO-8859-1
258en_US.UTF-8/UTF-8 258en_US.UTF-8/UTF-8
259de_DE/ISO-8859-1 259de_DE/ISO-8859-1
420For XEmacs (not plain Emacs), you have to do a little 420For XEmacs (not plain Emacs), you have to do a little
421more. In <path>/home/user/.xemacs/init.el</path>, add: 421more. In <path>/home/user/.xemacs/init.el</path>, add:
422</p> 422</p>
423 423
424<pre caption="setting the font for xemacs"> 424<pre caption="setting the font for xemacs">
425(define-key global-map '(EuroSign) '[&#8364;]) 425(define-key global-map '(EuroSign) '[&#8364;])
426</pre> 426</pre>
427 427
428<note> 428<note>
429The symbol in the []s is the Euro symbol. 429The symbol in the []s is the Euro symbol.
430</note> 430</note>
431 431
432</body> 432</body>
433</section> 433</section>
434<section> 434<section>
435<title>Language for OpenOffice</title> 435<title>Language for OpenOffice.org</title>
436<body> 436<body>
437 437
438<note> 438<note>
439Customized default language is not available for openoffice-bin ebuild. The 439Customized default language is not available for openoffice-bin ebuild. The
440default language in the openoffice-bin is ENUS. 440default language in the openoffice-bin is ENUS.
441</note> 441</note>
442 442
443<p> 443<p>
444Please note that this package now uses the LINGUAS variable to 444Please note that this package now uses the LINGUAS variable to
445provide localization. The old LANGUAGE=ENUS|PORT system does <e>not</e> work 445provide localization. The old LANGUAGE=ENUS|PORT system does <e>not</e> work
446anymore. The default language for OpenOffice is set as "US English". If you 446anymore. The default language for OpenOffice.org is set as "US English". If you
447wish to change the default language for OpenOffice, check the ebuild for the 447wish to change the default language for OpenOffice.org, check the ebuild for the
448default language code. 448default language code.
449</p> 449</p>
450 450
451<pre caption="Example: emerge openoffice for german environment"> 451<pre caption="Example: emerge openoffice for german environment">
452# <i>nano -w /etc/make.conf</i> 452# <i>nano -w /etc/make.conf</i>
453<comment>(Add in the LINGUAS variable. For instance, for the German language:)</comment> 453<comment>(Add in the LINGUAS variable. For instance, for the German language:)</comment>
454LINGUAS="de" 454LINGUAS="de"
455 455
456<comment>(Now install openoffice)</comment> 456<comment>(Now install openoffice)</comment>
457# <i>emerge openoffice</i> 457# <i>emerge openoffice</i>
458</pre> 458</pre>
459 459
460</body> 460</body>
461</section> 461</section>
462</chapter> 462</chapter>

Legend:
Removed from v.1.22  
changed lines
  Added in v.1.23

  ViewVC Help
Powered by ViewVC 1.1.20