/[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.34 Revision 1.35
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.34 2005/11/25 20:43:33 jkt Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.35 2006/01/02 13:40:18 rane 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">
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.24</version> 32<version>1.25</version>
33<date>2005-11-25</date> 33<date>2006-01-02</date>
34 34
35<chapter> 35<chapter>
36<title>Time zone</title> 36<title>Time zone</title>
37<section> 37<section>
38<body> 38<body>
214library to extract and use localized messages. Of course, Gentoo's Portage will 214library to extract and use localized messages. Of course, Gentoo's Portage will
215automatically install it when needed. 215automatically install it when needed.
216</p> 216</p>
217 217
218<p> 218<p>
219Once you have set the right locale, be sure to update your environment
220variables to make your system aware of the change:
221</p>
222
223<pre caption="Update the environment">
224# <i>env-update &amp;&amp; source /etc/profile</i>
225</pre>
226
227<p>
228After this, you will need to kill your X server by pressing
229<c>Ctrl-Alt-Backspace</c>, log out, then log in as user.
230</p>
231
232<p>
233Now, verify that the changes have taken effect:
234</p>
235
236<pre caption="Verify env changes">
237$ <i>env | grep -i LC_</i>
238</pre>
239
240<p>
219There is also additional localisation variable called LINGUAS, which affects 241There is also additional localisation variable called LINGUAS, which affects
220to localisation files that get installed in gettext-based programs, and decides 242to localisation files that get installed in gettext-based programs, and decides
221used localisation for some specific software packages, such as 243used localisation for some specific software packages, such as
222<c>kde-base/kde-i18n</c> and <c>app-office/openoffice</c>. The variable 244<c>kde-base/kde-i18n</c> and <c>app-office/openoffice</c>. The variable
223takes in <e>space</e>-separated list of language codes, and suggested 245takes in <e>space</e>-separated list of language codes, and suggested
253</p> 275</p>
254 276
255<pre caption="Exporting the LANG variable"> 277<pre caption="Exporting the LANG variable">
256# <i>export LANG="en_US.ISO-8859-15"</i> 278# <i>export LANG="en_US.ISO-8859-15"</i>
257</pre> 279</pre>
280
281<p>
282Be sure to update the environment after the change:
283</p>
284
285<pre caption="Update the environment">
286# <i>env-update &amp;&amp; source /etc/profile</i>
287</pre>
288
289<p>
290After this, you will need to kill your X server by pressing
291<c>Ctrl-Alt-Backspace</c>, log out, then log in as user.
292</p>
258 293
259</body> 294</body>
260</section> 295</section>
261<section> 296<section>
262<title>The userlocales USE flag</title> 297<title>The userlocales USE flag</title>
333<pre caption="setting the X keymap"> 368<pre caption="setting the X keymap">
334 Section "InputDevice" 369 Section "InputDevice"
335 Identifier "Keyboard1" 370 Identifier "Keyboard1"
336 ... 371 ...
337 Option "XkbLayout" "de" 372 Option "XkbLayout" "de"
338 # Option "XkbVariant" "nodeadkeys" 373 #Option "XkbModel" "pc105" <comment>## this is for international keyboards.</comment>
374 # Option "XkbVariant" "nodeadkeys" <comment>## this would be used for xterm input</comment>
339 ... 375 ...
340</pre> 376</pre>
377
378<p>
379If you have an international keyboard layout, you should set the option
380<c>XkbModel</c> to <c>pc102</c> or <c>pc105</c>, as this will allow mapping of the
381additional keys specific to your keyboard.
382</p>
383
384<p>
385Deadkeys allow you to press keys that will not show immediately but will be
386combined with another letter to produce a single character such as é,è,á,à,
387etc. Setting <c>XkbVariant</c> to <c>nodeadkeys</c> allows input these special
388characters into X terminals.
389</p>
390
391<p>
392If you would like to switch between more than one keyboard layout (for example
393English and Russian), all you have to do is add a few lines to
394<path>xorg.conf</path> that specify the desired layouts and the shortcut
395command.
396</p>
397
398<pre caption="Switching between two keyboard layouts">
399 Section "InputDevice"
400 Identifier "Keyboard1"
401 ...
402 Option "XkbLayout" "us,ru"
403 Option "XkbOptions" "grp:alt_shift_toggle,grp_led:scroll"
404</pre>
405
406<p>
407Here, <c>XkbOptions</c> allows you to toggle between keyboard layouts by simply
408pressing <c>Alt-Shift</c>. This will also toggle the Scroll Lock light on or
409off, thanks to the <c>grp_led:scroll</c> option. This is a handy visual
410indicator of which keyboard layout you are using at the moment.
411</p>
341 412
342</body> 413</body>
343</section> 414</section>
344</chapter> 415</chapter>
345 416
363<body> 434<body>
364 435
365<p> 436<p>
366In order to get your console to display the Euro symbol, you 437In order to get your console to display the Euro symbol, you
367will need to set <c>CONSOLEFONT</c> in 438will need to set <c>CONSOLEFONT</c> in
368<path>/etc/rc.conf</path> to a file found in 439<path>/etc/conf.d/consolefont</path> to a file found in
369<path>/usr/share/consolefonts/</path> (without the 440<path>/usr/share/consolefonts/</path> (without the
370<c>.psfu.gz</c>). <c>lat9w-16</c> has the Euro symbol. 441<c>.psfu.gz</c>). <c>lat9w-16</c> has the Euro symbol.
371</p> 442</p>
372 443
373<pre caption="setting the console font"> 444<pre caption="setting the console font">
374CONSOLEFONT="lat9w-16" 445CONSOLEFONT="lat9w-16"
446</pre>
447
448<p>
449You should verify that <c>CONSOLEFONT</c> is in the boot runlevel:
450</p>
451
452<pre caption="Verify the proper runlevel">
453# <i>rc-update show | grep -i consolefont</i>
454</pre>
455
456<p>
457If no runlevel is displayed for <c>CONSOLEFONT</c>, then add it to the proper level:
458</p>
459
460<pre caption="Add consolefont to boot">
461# <i>rc-update add consolefont boot</i>
375</pre> 462</pre>
376 463
377</body> 464</body>
378</section> 465</section>
379</chapter> 466</chapter>

Legend:
Removed from v.1.34  
changed lines
  Added in v.1.35

  ViewVC Help
Powered by ViewVC 1.1.20