/[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.62 Revision 1.63
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.62 2011/09/04 17:53:40 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.63 2011/09/12 19:42:27 swift Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide> 5<guide>
6<title>Gentoo Linux Localization Guide</title> 6<title>Gentoo Linux Localization Guide</title>
7<author title="Author"> 7<author title="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<author title="Editor"> 25<author title="Editor">
26 <mail link="nightmorph"/> 26 <mail link="nightmorph"/>
27</author>
28<author title="Editor">
29 <mail link="klondike"/>
27</author> 30</author>
28 31
29<abstract> 32<abstract>
30This guide should help users localize their Gentoo Linux distribution to any 33This guide should help users localize their Gentoo Linux distribution to any
31European locale. It uses Germany as a case-study, since it is translated from 34European locale. It uses Germany as a case-study, since it is translated from
32the German doc. Includes configuration for use of the euro currency symbol. 35the German doc. Includes configuration for use of the euro currency symbol.
33</abstract> 36</abstract>
34 37
35<version>1.46</version> 38<version>2</version>
36<date>2010-02-14</date> 39<date>2011-09-12</date>
37 40
38<chapter> 41<chapter>
39<title>Time zone</title> 42<title>Time zone</title>
40<section> 43<section>
41<body> 44<body>
42 45
43<p> 46<p>
44In order to keep time properly, you need to select your timezone so that your 47In order to keep time properly, you need to select your timezone so that your
45system knows where it is located. Look for your timezone in 48system knows where it is located. Look for your timezone in
46<path>/usr/share/zoneinfo</path>. You then set your timezone in 49<path>/usr/share/zoneinfo</path>. You then set your timezone in
47<path>/etc/conf.d/clock</path>. Please avoid the 50<path>/etc/timezone</path>. Please avoid the
48<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not 51<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
49indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8. 52indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
50</p> 53</p>
51 54
52<pre caption="Setting the timezone information"> 55<pre caption="Setting the timezone information">
53# <i>ls /usr/share/zoneinfo</i> 56# <i>ls /usr/share/zoneinfo</i>
54<comment>(Suppose you want to use Brussels)</comment> 57<comment>(Suppose you want to use Brussels)</comment>
55<comment>(First copy the proper zone to localtime)</comment> 58<comment>(First copy the proper zone to localtime)</comment>
56# <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i> 59# <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
57<comment>(Now specify your timezone)</comment> 60<comment>(Now specify your timezone)</comment>
58# <i>nano -w /etc/conf.d/clock</i> 61# <i>nano -w /etc/timezone</i>
59TIMEZONE="Europe/Brussels" 62Europe/Brussels
60 63
61# <i>date</i> 64# <i>date</i>
62Wed Mar 8 00:46:05 CET 2006 65Wed Mar 8 00:46:05 CET 2006
63</pre> 66</pre>
64 67
86<p> 89<p>
87In most Gentoo Linux installations, your hardware clock is set to 90In most Gentoo Linux installations, your hardware clock is set to
88UTC (or GMT, Greenwich Mean Time) and then your timezone is 91UTC (or GMT, Greenwich Mean Time) and then your timezone is
89taken into account to determine the actual, local time. If, 92taken into account to determine the actual, local time. If,
90for some reason, you need your hardware clock not to be in UTC, 93for some reason, you need your hardware clock not to be in UTC,
91you will need to edit <path>/etc/conf.d/clock</path> and change the 94you will need to edit <path>/etc/conf.d/hwclock</path> (or if you use Gentoo
95BSD: <path>/etc/conf.d/adjkerntz</path>) and change the
92value of <c>CLOCK</c> from <c>UTC</c> to <c>local</c>. 96value of <c>clock</c> from <c>UTC</c> to <c>local</c>.
93</p> 97</p>
94 98
95<pre caption="local vs. GMT clock"> 99<pre caption="local vs. GMT clock">
96<comment>(recommended:)</comment> 100<comment>(recommended:)</comment>
97CLOCK="UTC" 101clock="UTC"
98<comment>(or:)</comment> 102<comment>(or:)</comment>
99CLOCK="local" 103clock="local"
100</pre> 104</pre>
101 105
102</body> 106</body>
103</section> 107</section>
104</chapter> 108</chapter>
220LC_COLLATE="C" 224LC_COLLATE="C"
221</pre> 225</pre>
222 226
223<note> 227<note>
224Use <c>de_DE@euro</c> as your LANG if you want to use the Euro currency symbol 228Use <c>de_DE@euro</c> as your LANG if you want to use the Euro currency symbol
225(€). 229(€) on non UTF-8 based locales.
226</note> 230</note>
227 231
228<p> 232<p>
229It's also possible, and pretty common especially in a more traditional UNIX 233It's also possible, and pretty common especially in a more traditional UNIX
230environment, to leave the global settings unchanged, i.e. in the "<c>C</c>" 234environment, to leave the global settings unchanged, i.e. in the "<c>C</c>"
345<section> 349<section>
346<body> 350<body>
347 351
348<p> 352<p>
349The keyboard layout used by the console is set in 353The keyboard layout used by the console is set in
350<path>/etc/conf.d/keymaps</path> by the <c>KEYMAP</c> variable. 354<path>/etc/conf.d/keymaps</path> by the <c>keymap</c> variable.
351Valid values can be found in 355Valid values can be found in
352<path>/usr/share/keymaps/<c>{arch}</c>/</path>. 356<path>/usr/share/keymaps/<c>{arch}</c>/</path>.
353<path>i386</path> has further subdivisions into layout 357<path>i386</path> has further subdivisions into layout
354(<path>qwerty/</path>, <path>azerty/</path>, etc.). Some 358(<path>qwerty/</path>, <path>azerty/</path>, etc.). Some
355languages have multiple options, so you may wish to experiment 359languages have multiple options, so you may wish to experiment
356to decide which one fits your needs best. 360to decide which one fits your needs best.
357</p> 361</p>
358 362
359<pre caption="Setting the console keymap"> 363<pre caption="Setting the console keymap">
360KEYMAP="de" 364keymap="de"
361KEYMAP="de-latin1" 365keymap="de-latin1"
362KEYMAP="de-latin1-nodeadkeys" 366keymap="de-latin1-nodeadkeys"
363</pre> 367</pre>
364 368
365</body> 369</body>
366</section> 370</section>
367</chapter> 371</chapter>
376in <path>/etc/X11/xorg.conf</path> by the <c>XkbLayout</c> 380in <path>/etc/X11/xorg.conf</path> by the <c>XkbLayout</c>
377option. 381option.
378</p> 382</p>
379 383
380<pre caption="Setting the X keymap"> 384<pre caption="Setting the X keymap">
381 Section "InputDevice" 385Section "InputClass"
382 Identifier "Keyboard1" 386 Identifier "keyboard-all"
383 ... 387 Driver "evdev"
384 Option "XkbLayout" "de" 388 Option "XkbLayout" "de"
385 #Option "XkbModel" "pc105" <comment>## this is for international keyboards.</comment> 389 #Option "XkbModel" "pc105"
386 # Option "XkbVariant" "nodeadkeys" <comment>## this would be used for xterm input</comment> 390 MatchIsKeyboard "on"
387 ... 391EndSection
388</pre> 392</pre>
389 393
390<p> 394<p>
391If you have an international keyboard layout, you should set the option 395If you have an international keyboard layout, you should set the option
392<c>XkbModel</c> to <c>pc102</c> or <c>pc105</c>, as this will allow mapping of the 396<c>XkbModel</c> to <c>pc102</c> or <c>pc105</c>, as this will allow mapping of the
406<path>xorg.conf</path> that specify the desired layouts and the shortcut 410<path>xorg.conf</path> that specify the desired layouts and the shortcut
407command. 411command.
408</p> 412</p>
409 413
410<pre caption="Switching between two keyboard layouts"> 414<pre caption="Switching between two keyboard layouts">
411 Section "InputDevice" 415Section "InputClass"
412 Identifier "Keyboard1" 416 Identifier "keyboard-all"
413 ... 417 Driver "evdev"
414 Option "XkbLayout" "us,ru" 418 Option "XkbLayout" "us,ru"
415 Option "XkbOptions" "grp:alt_shift_toggle,grp_led:scroll" 419 Option "XkbOptions" "grp:alt_shift_toggle,grp_led:scroll"
420 MatchIsKeyboard "on"
421EndSection
416</pre> 422</pre>
417 423
418<p> 424<p>
419Here, <c>XkbOptions</c> allows you to toggle between keyboard layouts by simply 425Here, <c>XkbOptions</c> allows you to toggle between keyboard layouts by simply
420pressing <c>Alt-Shift</c>. This will also toggle the Scroll Lock light on or 426pressing <c>Alt-Shift</c>. This will also toggle the Scroll Lock light on or
446<section> 452<section>
447<body> 453<body>
448 454
449<p> 455<p>
450In order to get your console to display the Euro symbol, you will need to set 456In order to get your console to display the Euro symbol, you will need to set
451<c>CONSOLEFONT</c> in <path>/etc/conf.d/consolefont</path> to a file found in 457<c>consolefont</c> in <path>/etc/conf.d/consolefont</path> to a file found in
452<path>/usr/share/consolefonts/</path> (without the <c>.psfu.gz</c>). 458<path>/usr/share/consolefonts/</path> (without the <c>.psfu.gz</c>).
453<c>lat9w-16</c> has the Euro symbol. 459<c>lat9w-16</c> has the Euro symbol.
454</p> 460</p>
455 461
456<pre caption="Setting the console font"> 462<pre caption="Setting the console font">
457CONSOLEFONT="lat9w-16" 463consolefont="lat9w-16"
458</pre> 464</pre>
459 465
460<p> 466<p>
461You should verify that <c>CONSOLEFONT</c> is in the boot runlevel: 467You should verify that <c>consolefont</c> is in the boot runlevel:
462</p> 468</p>
463 469
464<pre caption="Verify the proper runlevel"> 470<pre caption="Verify the proper runlevel">
465# <i>rc-update -v show | grep -i consolefont</i> 471# <i>rc-update -v show | grep consolefont</i>
466</pre> 472</pre>
467 473
468<p> 474<p>
469If no runlevel is displayed for <c>CONSOLEFONT</c>, then add it to the proper level: 475If no runlevel is displayed for <c>consolefont</c>, then add it to the proper level:
470</p> 476</p>
471 477
472<pre caption="Add consolefont to boot"> 478<pre caption="Add consolefont to boot">
473# <i>rc-update add consolefont boot</i> 479# <i>rc-update add consolefont boot</i>
474</pre> 480</pre>

Legend:
Removed from v.1.62  
changed lines
  Added in v.1.63

  ViewVC Help
Powered by ViewVC 1.1.20