/[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.11 Revision 1.12
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.11 2004/02/12 16:56:05 dertobi123 Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.12 2004/02/12 22:25:42 dertobi123 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"><mail link="holler@gentoo.de"> 7<author title="Author">
8 Alexander Holler</mail> 8 <mail link="holler@gentoo.de">Alexander Holler</mail>
9</author> 9</author>
10<author title="Translator/Editor"><mail link="slucy@uchicago.edu"> 10<author title="Translator/Editor">
11 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
19<abstract> 20<abstract>
20This guide should help users localize their Gentoo Linux distribution to any 21This guide should help users localize their Gentoo Linux distribution to any
21European locale. It uses Germany as a case-study, since it is translated from 22European locale. It uses Germany as a case-study, since it is translated from
22the German doc. Includes configuration for use of the Euro currency symbol. 23the German doc. Includes configuration for use of the Euro currency symbol.
23</abstract> 24</abstract>
24 25
26<version>1.9</version>
27<date>February 12, 2004</date>
28
25<chapter> 29<chapter>
26<title>Timezone</title> 30<title>Timezone</title>
27<section> 31<section>
28 <body> 32<body>
29 <p>In order to keep time properly, 33
30 <path>/etc/localtime</path> must point to the correct time zone 34<p>
31 data file. Look around in <path>/usr/share/zoneinfo/</path> 35In order to keep time properly, <path>/etc/localtime</path> must point to
32 and pick your timezone or a near-by big city. 36the correct time zone data file. Look around in
37<path>/usr/share/zoneinfo/</path> and pick your timezone or a near-by big city.
38</p>
39
33<pre caption="setting the timezone"> 40<pre caption="setting the timezone">
34# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i> 41# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
35# <i>date</i> 42# <i>date</i>
36Sun Feb 16 08:26:44 CET 2003 43Sun Feb 16 08:26:44 CET 2003
37</pre> 44</pre>
45
46<note>
38<note>Make sure that the three-letter timezone indicator (in this case "CET") 47Make sure that the three-letter timezone indicator (in this case "CET")
39is correct for your area.</note> 48is correct for your area.
49</note>
50
51<note>
40<note>You can set the value of <i>TZ</i> to be everything after the 52You can set the value of <i>TZ</i> to be everything after the
41<path>/usr/share/zoneinfo</path> in your shell rc file 53<path>/usr/share/zoneinfo</path> in your shell rc file
42(<path>.bash_profile</path> for bash) for a user-level setting. In this case 54(<path>.bash_profile</path> for bash) for a user-level setting. In this case
43<i>TZ="Europe/Berlin"</i>.</note> 55<i>TZ="Europe/Berlin"</i>.
44 </p> 56</note>
45 </body> 57
58</body>
46</section> 59</section>
47</chapter> 60</chapter>
48 61
49<chapter> 62<chapter>
50<title>System Clock</title> 63<title>System Clock</title>
51<section> 64<section>
52 <body> 65<body>
53 <p> 66
67<p>
54 In most Gentoo Linux installations, your system clock is set to 68In most Gentoo Linux installations, your system clock is set to
55 UTC (or GMT, Greenwhich Mean Time) and then your timezone is 69UTC (or GMT, Greenwhich Mean Time) and then your timezone is
56 taken into account to determine the actual, local time. If, 70taken into account to determine the actual, local time. If,
57 for some reason, you need your system clock not to be in UTC, 71for some reason, you need your system clock not to be in UTC,
58 you will need to edit <path>/etc/rc.conf</path> and change the 72you will need to edit <path>/etc/rc.conf</path> and change the
59 value of <i>CLOCK</i>. 73value of <i>CLOCK</i>.
74</p>
60 75
61<pre caption="local vs. GMT clock"> 76<pre caption="local vs. GMT clock">
62 <codenote>recommended:</codenote> 77<codenote>recommended:</codenote>
63 CLOCK="UTC" 78CLOCK="UTC"
64 <codenote>or:</codenote> 79<codenote>or:</codenote>
65 CLOCK="local" 80CLOCK="local"
66</pre> 81</pre>
67 </p> 82
68 </body> 83</body>
69</section> 84</section>
70</chapter> 85</chapter>
71 86
72<chapter> 87<chapter>
73<title>POSIX Locale</title> 88<title>POSIX Locale</title>
74<section> 89<section>
75 <body> 90<body>
76 <p> 91
92<p>
77 The next step is to set the <i>LANG</i> shell variable, which 93The next step is to set the <i>LANG</i> shell variable, which
78 is used by your shell and window manager (and some other 94is used by your shell and window manager (and some other
79 applications). Valid values can be found in 95applications). Valid values can be found in
80 <path>/usr/share/locale</path> and generally take the form 96<path>/usr/share/locale</path> and generally take the form
81 <i>ab_CD</i>, where <i>ab</i> is your two letter language code 97<i>ab_CD</i>, where <i>ab</i> is your two letter language code
82 and <i>CD</i> is your two letter country code. The <i>_CD</i> 98and <i>CD</i> is your two letter country code. The <i>_CD</i>
83 is left off if your language is only (or primarily) spoken in 99is left off if your language is only (or primarily) spoken in
84 one country. <i>LANG</i> can be set in 100one country. <i>LANG</i> can be set in
85 <path>/etc/profile</path> if you want it to take effect 101<path>/etc/profile</path> if you want it to take effect
86 system-wide, or in <path>~/.bashrc</path> as a user-specific 102system-wide, or in <path>~/.bashrc</path> as a user-specific
87 setting. 103setting.
104</p>
105
88<pre caption="setting the POSIX locale"> 106<pre caption="setting the POSIX locale">
89 export LANG="de_DE@euro" 107export LANG="de_DE@euro"
90</pre> 108</pre>
109
110<note>
91<note>Appended <i>@euro</i> to your locale if you want to use the new Euro 111Appended <i>@euro</i> to your locale if you want to use the new Euro
92currency symbol (&#8364;)</note> 112currency symbol (&#8364;)
93 </p> 113</note>
94 </body> 114
115</body>
95</section> 116</section>
96</chapter> 117</chapter>
97 118
98<chapter> 119<chapter>
99<title>Keyboard layout for the console</title> 120<title>Keyboard layout for the console</title>
100<section> 121<section>
101 <body> 122<body>
102 <p> 123
124<p>
103 The keyboard layout used by the console is set in 125The keyboard layout used by the console is set in
104 <path>/etc/rc.conf</path> by the <i>KEYMAP</i> variable. 126<path>/etc/rc.conf</path> by the <i>KEYMAP</i> variable.
105 Valid values can be found in 127Valid values can be found in
106 <path>/usr/share/keymaps/<i>{arch}</i>/</path>. 128<path>/usr/share/keymaps/<i>{arch}</i>/</path>.
107 <path>i386</path> has further subdivisions into layout 129<path>i386</path> has further subdivisions into layout
108 (<path>qwerty/</path>, <path>azerty/</path>, etc.). Some 130(<path>qwerty/</path>, <path>azerty/</path>, etc.). Some
109 languages have multiple options, so you may wish to experiment 131languages have multiple options, so you may wish to experiment
110 to decide which one fits your needs best. 132to decide which one fits your needs best.
133</p>
134
111<pre caption="setting the console keymap"> 135<pre caption="setting the console keymap">
112 KEYMAP="de" 136KEYMAP="de"
113 KEYMAP="de-latin1" 137KEYMAP="de-latin1"
114 KEYMAP="de-latin1-nodeadkeys" 138KEYMAP="de-latin1-nodeadkeys"
115</pre> 139</pre>
116 </p> 140
117 </body> 141</body>
118</section> 142</section>
119</chapter> 143</chapter>
120 144
121<chapter> 145<chapter>
122<title>Keyboard layout for the X server</title> 146<title>Keyboard layout for the X server</title>
123<section> 147<section>
124 <body> 148<body>
149
150<p>
125 <p>The keyboard layout to be used by the X server is specified 151The keyboard layout to be used by the X server is specified
126 in <path>/etc/X11/XF86Config</path> by the <i>XkbLayout</i> 152in <path>/etc/X11/XF86Config</path> by the <i>XkbLayout</i>
127 option. 153option.
154</p>
155
128<pre caption="setting the X keymap"> 156<pre caption="setting the X keymap">
129 Section "InputDevice" 157 Section "InputDevice"
130 Identifier "Keyboard1" 158 Identifier "Keyboard1"
131 ... 159 ...
132 Option "XkbLayout" "de" 160 Option "XkbLayout" "de"
133 # Option "XkbVariant" "nodeadkeys" 161 # Option "XkbVariant" "nodeadkeys"
134 ... 162 ...
135</pre> 163</pre>
136 </p> 164
137 </body> 165</body>
138</section> 166</section>
139</chapter> 167</chapter>
140 168
141<chapter> 169<chapter>
142<title>KDE</title> 170<title>KDE</title>
156</chapter> 184</chapter>
157 185
158<chapter> 186<chapter>
159<title>The Euro Symbol for the Console</title> 187<title>The Euro Symbol for the Console</title>
160<section> 188<section>
161 <body> 189<body>
162 <p> 190
191<p>
163 In order to get your console to display the Euro symbol, you 192In order to get your console to display the Euro symbol, you
164 will need to set <i>CONSOLEFONT</i> in 193will need to set <i>CONSOLEFONT</i> in
165 <path>/etc/rc.conf</path> to a file found in 194<path>/etc/rc.conf</path> to a file found in
166 <path>/usr/share/consolefonts/</path> (without the 195<path>/usr/share/consolefonts/</path> (without the
167 <c>.psfu.gz</c>). <c>lat9w-16</c> has the Euro symbol. 196<c>.psfu.gz</c>). <c>lat9w-16</c> has the Euro symbol.
197</p>
198
168<pre caption="setting the console font"> 199<pre caption="setting the console font">
169 CONSOLEFONT="lat9w-16" 200CONSOLEFONT="lat9w-16"
170</pre> 201</pre>
171 </p>
172 </body>
173</section>
174</chapter>
175 202
176<chapter> 203</body>
177 <title>The Euro Symbol in X</title>
178<section> 204</section>
205</chapter>
206
207<chapter>
208<title>The Euro Symbol in X</title>
209<section>
179 <title>Most Applications</title> 210<title>Most Applications</title>
180 <body> 211<body>
212
213<p>
181 <p>Getting the Euro symbol to work properly in X is a little 214Getting the Euro symbol to work properly in X is a little
182 bit tougher. The first thing you should do is change the <i> 215bit tougher. The first thing you should do is change the <i>
183 fixed</i> and <i>variable</i> definitions in 216fixed</i> and <i>variable</i> definitions in
184 <path>/usr/X11R6/lib/X11/fonts/misc/fonts.alias</path> to end 217<path>/usr/X11R6/lib/X11/fonts/misc/fonts.alias</path> to end
185 in <i>iso8859-15</i> instead of <i>iso8859-1</i>. 218in <i>iso8859-15</i> instead of <i>iso8859-1</i>.
219</p>
220
186<pre caption="setting default X fonts"> 221<pre caption="setting default X fonts">
187 fixed -misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso8859-15 222fixed -misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso8859-15
188 variable -*-helvetica-bold-r-normal-*-*-120-*-*-*-*-iso8859-15 223variable -*-helvetica-bold-r-normal-*-*-120-*-*-*-*-iso8859-15
189</pre> 224</pre>
190 </p> 225
226<p>
191 <p>Some applications use their own font, and you will have to 227Some applications use their own font, and you will have to
192 tell them separately to use a font with the Euro symbol. You 228tell them separately to use a font with the Euro symbol. You
193 can do this at a user-specific level in 229can do this at a user-specific level in
194 <path>.Xdefaults</path> (you can copy this file to 230<path>.Xdefaults</path> (you can copy this file to
195 <path>/etc/skel/</path> for use by new users), or at a global 231<path>/etc/skel/</path> for use by new users), or at a global
196 level for any application with a resource file in 232level for any application with a resource file in
197 <path>/usr/X11R6/lib/X11/app-defaults/</path> (like xterm). In 233<path>/usr/X11R6/lib/X11/app-defaults/</path> (like xterm). In
198 these files you generally have to change an existing line, 234these files you generally have to change an existing line,
199 rather than adding a new one. To change our xterm font, for 235rather than adding a new one. To change our xterm font, for
200 instance: 236instance:
237</p>
238
201<pre caption="setting fonts for xterm"> 239<pre caption="setting fonts for xterm">
202 <codenote>(in your home directory)</codenote> 240<codenote>(in your home directory)</codenote>
203 $ <i>echo 'XTerm*font: fixed' >> .Xresources </i> 241# <i>echo 'XTerm*font: fixed' >> .Xresources </i>
204 $ <i>xrdb -merge .Xresources</i> 242# <i>xrdb -merge .Xresources</i>
205</pre> 243</pre>
206 </p>
207 </body>
208</section>
209 244
245</body>
210<section> 246</section>
247<section>
211 <title>The Euro symbol in (X)Emacs</title> 248<title>The Euro symbol in (X)Emacs</title>
212 <body> 249<body>
250
251<p>
213 <p>To use the Euro symbol in (X)Emacs, add the following to 252To use the Euro symbol in (X)Emacs, add the following to
214 <path>.Xdefaults</path>: 253<path>.Xdefaults</path>:
254</p>
255
215<pre caption="setting the font for emacs"> 256<pre caption="setting the font for emacs">
216 Emacs.default.attributeFont: -*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-15 257Emacs.default.attributeFont: -*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-15
217</pre> 258</pre>
259
260<p>
218 </p><p>For XEmacs (not plain Emacs), you have to do a little 261For XEmacs (not plain Emacs), you have to do a little
219 more. In <path>/home/user/.xemacs/init.el</path>, add: 262more. In <path>/home/user/.xemacs/init.el</path>, add:
263</p>
264
220<pre caption="setting the font for xemacs"> 265<pre caption="setting the font for xemacs">
221 (define-key global-map '(EuroSign) '[&#8364;]) 266(define-key global-map '(EuroSign) '[&#8364;])
222</pre> 267</pre>
268
269<note>
223 <note>The symbol in the []s is the Euro symbol.</note> 270The symbol in the []s is the Euro symbol.
224 </p> 271</note>
225 </body> 272
226</section> 273</body>
227<section> 274</section>
275<section>
228 <title>Language for OpenOffice</title> 276<title>Language for OpenOffice</title>
229 <body> 277<body>
278
230 <note> 279<note>
231 Customized default language is not available for openoffice-bin ebuild. The 280Customized default language is not available for openoffice-bin ebuild. The
232 default language in the openoffice-bin is ENUS. 281default language in the openoffice-bin is ENUS.
233 </note> 282</note>
234 <p> 283
284<p>
235 The default language for OpenOffice is set as "ENUS"(01). If you wish to 285The default language for OpenOffice is set as "ENUS"(01). If you wish to
236 change the default language for OpenOffice, check the ebuild for the 286change the default language for OpenOffice, check the ebuild for the
237 default language code. 287default language code.
238 </p> 288</p>
289
239<pre caption="emerge openoffice with desired default language"> 290<pre caption="emerge openoffice with desired default language">
240# <i>LANGUAGE="01" emerge openoffice</i> 291# <i>LANGUAGE="01" emerge openoffice</i>
241<comment>01 is the ENUS language code for openoffice</comment> 292<comment>01 is the ENUS language code for openoffice</comment>
242</pre> 293</pre>
294
243 </body> 295</body>
244</section> 296</section>
245</chapter> 297</chapter>
246 298
247<version>1.9</version>
248<date>February 12, 2004</date>
249</guide> 299</guide>

Legend:
Removed from v.1.11  
changed lines
  Added in v.1.12

  ViewVC Help
Powered by ViewVC 1.1.20