doc/en/guide-localization.xml

<?xml version='1.0'?>
<?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>

<guide link = "/doc/en/guide-localization.xml">
<title>Gentoo Linux Localization Instructions</title>
<author><mail link="holler@ahsoftware.de">
        Alexander Holler</mail>
</author>

<abstract>This instructions explains the few steps you need to follow to use Gentoo Linux 
with another language than english. It also explains what to do to get the Euro character shown.</abstract>

<chapter>
<title>Preface</title>
<section>
        <body>
                <p>As I'm a German I explain how to enable the german language. If you want 
                another language, you just have to replace the german language code <i>de</i> with 
                the corresponding code for your country, e.g. <i>fr</i> for France or <i>es</i> for Spain.
                </p>
        </body>
</section>
</chapter>

<chapter>
<title>Timezone</title>
<section>
        <body>
                <p>To enable the right timezone <path>/etc/localtime</path> should point to the 
                appropriate file with the datas for your timezone. You will find those files
                in <path>/usr/share/zoneinfo/</path>.
<pre>
# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
</pre>
                </p>
        </body>
</section>
</chapter>

<chapter>
<title>Hardware clock</title>
<section>
        <body>
                <p>If your hardware clock is set to local time and not to GMT you have to correct
                the variable <i>CLOCK</i> in <path>/etc/rc.conf</path>.
<pre>
 CLOCK="local"
</pre>
                </p>
        </body>
</section>
</chapter>

<chapter>
<title>Language</title>
<section>
        <body>
                <p>Telling programms what language you prefer will be done with the environment variable
                <i>LANG</i>. If you want to set the language system-wide for all users you should export 
                <i>LANG</i> in <path>/etc/profile</path>. If not, this can be done in through your private
                <path>.bashrc</path> in your home directory. You can find available languages in 
                <path>/usr/share/i18n/locales</path>.
<pre>
 export LANG="de_DE@euro"
</pre>
                </p>
        </body>
</section>
</chapter>

<chapter>
<title>Keyboard-layout (terminal)</title>
<section>
        <body>
                <p>The keyboard-layout for terminal sessions is set through <i>KEYMAP</i> in
                <path>/etc/rc.conf</path>. You will find the appropriate tables in
                <path>/usr/share/keymaps</path>. If you aren't using composed characters with
                tildes (e.g. &#245;), accent graph (e.g. &#232;) or similar, you could use the
                nodeadkeys-variants. This will save you to enter a space after typing letters
                like ~.
<pre>
 KEYMAP="de-latin1"
 # KEYMAP="de-latin1-nodeadkeys"
</pre>
                </p>
        </body>
</section>
</chapter>

<chapter>
<title>Keyboard-layout (X server)</title>
<section>
        <body>
                <p>The keyboard-layout for the X server is set with the option
                <i>XkbLayout</i> in the file <path>/etc/X11/XF86Config</path>.
<pre>
 Section "InputDevice"
     Identifier  "Keyboard1"
     ...
     Option "XkbLayout"    "de"
     # Option XkbVariant"  "nodeadkeys"
     ...
</pre>
                </p>
        </body>
</section>
</chapter>

<chapter>
<title>Euro character (terminal)</title>
<section>
        <body>
                <p>If you want to see the Euro character in a session without using X, you have
                to use a console font which contains it. The console font is set with
                <i>CONSOLEFONT</i> in <path>/etc/rc.conf</path>. Available fonts will be find in
                <path>/usr/share/consolefonts</path>.
<pre>
 CONSOLEFONT="lat0-16"
</pre>
                </p>
        </body>
</section>
</chapter>

<chapter>
        <title>Euro character (X server)</title>
<section>
        <title>General</title>
        <body>
                <p>Using the above settings and KDE you should already get the Euro character with
                Alt-Gr-E in all KDE-programs. Remaining the non-KDE-programs.
                </p><p>Unfortunately this is not as easy as the settings before. You have to set the right
                font for every single X-program. So I will just explain how to enable the Euro character 
                for xterm and (X)Emacs. You can change the fonts for programs under X in your private
                <path>.Xdefaults</path> in your home directory. To enable it for other (new) users you could
                copy this file to <path>/etc/skel</path>.
                </p>
        </body>
</section>

<section>
        <title>Euro character for xterm</title>
        <body>
                <p>Insert the following in your <path>.Xdefaults</path>:
<pre>
 xterm*font: 7x13euro
</pre>
                </p>
        </body>
</section>

<section>
        <title>Euro character for (X)Emacs</title>
        <body>
                <p>For (X)Emacs you define the font in <path>.Xdefaults</path> as shown below:
<pre>
 Emacs.default.attributeFont: -*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-15
</pre>
                </p><p>If you are using XEmacs (not Emacs) you will have to tell him what to do with
                the <i>EuroSign</i>. This will be done through a definition in 
                <path>.xemacs/init.el</path> in your home directory:
<pre>
 (define-key global-map '(EuroSign) '[&#8364;])
</pre>
                <note>The character in the square brackets is the Euro character.</note>
                </p>
        </body>
</section>

</chapter>

<version>$Revision: 1.1 $</version>
<date>$Date: 2002/11/09 18:47:44 $</date>
</guide>
1	<?xml version='1.0'?>
2	<?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
3
4	<guide link = "/doc/en/guide-localization.xml">
5	<title>Gentoo Linux Localization Instructions</title>
6	<author><mail link="holler@ahsoftware.de">
7	Alexander Holler</mail>
8	</author>
9
10	<abstract>This instructions explains the few steps you need to follow to use Gentoo Linux
11	with another language than english. It also explains what to do to get the Euro character shown.</abstract>
12
13	<chapter>
14	<title>Preface</title>
15	<section>
16	<body>
17	<p>As I'm a German I explain how to enable the german language. If you want
18	another language, you just have to replace the german language code <i>de</i> with
19	the corresponding code for your country, e.g. <i>fr</i> for France or <i>es</i> for Spain.
20	</p>
21	</body>
22	</section>
23	</chapter>
24
25	<chapter>
26	<title>Timezone</title>
27	<section>
28	<body>
29	<p>To enable the right timezone <path>/etc/localtime</path> should point to the
30	appropriate file with the datas for your timezone. You will find those files
31	in <path>/usr/share/zoneinfo/</path>.
32	<pre>
33	# <i>ln -sf /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
34	</pre>
35	</p>
36	</body>
37	</section>
38	</chapter>
39
40	<chapter>
41	<title>Hardware clock</title>
42	<section>
43	<body>
44	<p>If your hardware clock is set to local time and not to GMT you have to correct
45	the variable <i>CLOCK</i> in <path>/etc/rc.conf</path>.
46	<pre>
47	CLOCK="local"
48	</pre>
49	</p>
50	</body>
51	</section>
52	</chapter>
53
54	<chapter>
55	<title>Language</title>
56	<section>
57	<body>
58	<p>Telling programms what language you prefer will be done with the environment variable
59	<i>LANG</i>. If you want to set the language system-wide for all users you should export
60	<i>LANG</i> in <path>/etc/profile</path>. If not, this can be done in through your private
61	<path>.bashrc</path> in your home directory. You can find available languages in
62	<path>/usr/share/i18n/locales</path>.
63	<pre>
64	export LANG="de_DE@euro"
65	</pre>
66	</p>
67	</body>
68	</section>
69	</chapter>
70
71	<chapter>
72	<title>Keyboard-layout (terminal)</title>
73	<section>
74	<body>
75	<p>The keyboard-layout for terminal sessions is set through <i>KEYMAP</i> in
76	<path>/etc/rc.conf</path>. You will find the appropriate tables in
77	<path>/usr/share/keymaps</path>. If you aren't using composed characters with
78	tildes (e.g. õ), accent graph (e.g. è) or similar, you could use the
79	nodeadkeys-variants. This will save you to enter a space after typing letters
80	like ~.
81	<pre>
82	KEYMAP="de-latin1"
83	# KEYMAP="de-latin1-nodeadkeys"
84	</pre>
85	</p>
86	</body>
87	</section>
88	</chapter>
89
90	<chapter>
91	<title>Keyboard-layout (X server)</title>
92	<section>
93	<body>
94	<p>The keyboard-layout for the X server is set with the option
95	<i>XkbLayout</i> in the file <path>/etc/X11/XF86Config</path>.
96	<pre>
97	Section "InputDevice"
98	Identifier "Keyboard1"
99	...
100	Option "XkbLayout" "de"
101	# Option XkbVariant" "nodeadkeys"
102	...
103	</pre>
104	</p>
105	</body>
106	</section>
107	</chapter>
108
109	<chapter>
110	<title>Euro character (terminal)</title>
111	<section>
112	<body>
113	<p>If you want to see the Euro character in a session without using X, you have
114	to use a console font which contains it. The console font is set with
115	<i>CONSOLEFONT</i> in <path>/etc/rc.conf</path>. Available fonts will be find in
116	<path>/usr/share/consolefonts</path>.
117	<pre>
118	CONSOLEFONT="lat0-16"
119	</pre>
120	</p>
121	</body>
122	</section>
123	</chapter>
124
125	<chapter>
126	<title>Euro character (X server)</title>
127	<section>
128	<title>General</title>
129	<body>
130	<p>Using the above settings and KDE you should already get the Euro character with
131	Alt-Gr-E in all KDE-programs. Remaining the non-KDE-programs.
132	</p><p>Unfortunately this is not as easy as the settings before. You have to set the right
133	font for every single X-program. So I will just explain how to enable the Euro character
134	for xterm and (X)Emacs. You can change the fonts for programs under X in your private
135	<path>.Xdefaults</path> in your home directory. To enable it for other (new) users you could
136	copy this file to <path>/etc/skel</path>.
137	</p>
138	</body>
139	</section>
140
141	<section>
142	<title>Euro character for xterm</title>
143	<body>
144	<p>Insert the following in your <path>.Xdefaults</path>:
145	<pre>
146	xterm*font: 7x13euro
147	</pre>
148	</p>
149	</body>
150	</section>
151
152	<section>
153	<title>Euro character for (X)Emacs</title>
154	<body>
155	<p>For (X)Emacs you define the font in <path>.Xdefaults</path> as shown below:
156	<pre>
157	Emacs.default.attributeFont: --courier-medium-r----120-----iso8859-15
158	</pre>
159	</p><p>If you are using XEmacs (not Emacs) you will have to tell him what to do with
160	the <i>EuroSign</i>. This will be done through a definition in
161	<path>.xemacs/init.el</path> in your home directory:
162	<pre>
163	(define-key global-map '(EuroSign) '[€])
164	</pre>
165	<note>The character in the square brackets is the Euro character.</note>
166	</p>
167	</body>
168	</section>
169
170	</chapter>
171
172	<version>$Revision: 1.1 $</version>
173	<date>$Date: 2002/11/09 18:47:44 $</date>
174	</guide>