svn commit: r43879 - head/en_US.ISO8859-1/books/handbook/l10n
Dru Lavigne
dru at FreeBSD.org
Tue Feb 11 22:06:20 UTC 2014
Author: dru
Date: Tue Feb 11 22:06:19 2014
New Revision: 43879
URL: http://svnweb.freebsd.org/changeset/doc/43879
Log:
Initial pass through 22.4 Locale Configuration for Specific Languages.
More commits to come.
Sponsored by: iXsystems
Modified:
head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml Tue Feb 11 20:17:36 2014 (r43878)
+++ head/en_US.ISO8859-1/books/handbook/l10n/chapter.xml Tue Feb 11 22:06:19 2014 (r43879)
@@ -739,7 +739,8 @@ keychange="<replaceable>fkey_number sequ
</tgroup>
</table>
</sect2>
-
+<!--
+Comment out for now. If needed, can be added as note in new Printing chapter.
<sect2>
<title>Printer Setup</title>
@@ -750,7 +751,7 @@ keychange="<replaceable>fkey_number sequ
converted to &postscript; or PDF formats using language
specific converters.</para>
</sect2>
-
+ -->
<sect2>
<title>Kernel and File Systems</title>
@@ -831,7 +832,12 @@ keychange="<replaceable>fkey_number sequ
</sect1>
<sect1 xml:id="lang-setup">
- <title>Localizing &os; to Specific Languages</title>
+ <title>Locale Configuration for Specific Languages</title>
+
+ <para>This section provides configuration examples for localizing
+ a &os; system for the
+ Russian language. It then provides some
+ additional resources for localizing other languages.</para>
<sect2 xml:id="ru-localize">
<info>
@@ -848,27 +854,14 @@ keychange="<replaceable>fkey_number sequ
<secondary>Russian</secondary>
</indexterm>
- <para>For more information about KOI8-R encoding, refer to
- <link xlink:href="http://koi8.pp.ru/">KOI8-R References
- (Russian Net Character Set)</link>.</para>
-
- <sect3>
- <title>Locale Setup</title>
-
- <para>To set this locale, put the following lines into each
+ <para>To set this locale for the login shell, add the following lines into each
user's <filename>~/.login_conf</filename>:</para>
<programlisting>me:My Account:\
:charset=KOI8-R:\
:lang=ru_RU.KOI8-R:</programlisting>
- </sect3>
- <sect3>
- <title>Console Setup</title>
-
- <itemizedlist>
- <listitem>
- <para>Add the following lines to
+ <para>To configure the console, add the following lines to
<filename>/etc/rc.conf</filename>:</para>
<programlisting>keymap="ru.koi8-r"
@@ -877,78 +870,49 @@ font8x16="cp866b-8x16"
font8x14="cp866-8x14"
font8x8="cp866-8x8"
mousechar_start=3</programlisting>
- </listitem>
- <listitem>
<para>For each <literal>ttyv</literal> entry in
<filename>/etc/ttys</filename>, use
<literal>cons25r</literal> as the terminal type.</para>
- </listitem>
- </itemizedlist>
- </sect3>
-
- <sect3>
- <title>Printer Setup</title>
<indexterm><primary>printers</primary></indexterm>
- <para>Since most printers with Russian characters come with
- hardware code page CP866, a special output filter is needed
- to convert from KOI8-R to CP866. &os; installs a default
- filter as <filename>/usr/libexec/lpr/ru/koi2alt</filename>.
- A Russian printer <filename>/etc/printcap</filename> entry
- should look like:</para>
+ <para>To configure printing, a special output filter is needed
+ to convert from KOI8-R to CP866 since most printers with Russian characters come with
+ hardware code page CP866. &os; includes a default
+ filter for this purpose, <filename>/usr/libexec/lpr/ru/koi2alt</filename>.
+ To use this filter, add this entry to <filename>/etc/printcap</filename>:</para>
<programlisting>lp|Russian local line printer:\
:sh:of=/usr/libexec/lpr/ru/koi2alt:\
:lp=/dev/lpt0:sd=/var/spool/output/lpd:lf=/var/log/lpd-errs:</programlisting>
<para>Refer to &man.printcap.5; for a more detailed
- description.</para>
- </sect3>
+ explanation.</para>
- <sect3>
- <title>&ms-dos; and Russian Filenames</title>
-
- <para>The following example &man.fstab.5; entry enables
+ <para>To configure
support for Russian filenames in mounted &ms-dos;
- filesystems:</para>
+ file systems, include <option>-L</option> and the locale name when adding an entry to
+ <filename>/etc/fstab</filename>:</para>
<programlisting>/dev/ad0s2 /dos/c msdos rw,-Lru_RU.KOI8-R 0 0</programlisting>
- <para><option>-L</option> selects the locale name. Refer to
+ <para>Refer to
&man.mount.msdosfs.8; for more details.</para>
- </sect3>
-
- <sect3>
- <title><application>Xorg</application> Setup</title>
- <orderedlist>
- <listitem>
- <para>First, configure the
- <link linkend="setting-locale">non-X locale
- setup</link>.</para>
- </listitem>
- <listitem>
- <para>When using <application>&xorg;</application>,
+ <para>To configure Russian fonts for <application>&xorg;</application>,
install the
<package>x11-fonts/xorg-fonts-cyrillic</package>
- package.</para>
-
- <para>Check the <literal>"Files"</literal> section in
+ package. Then, check the <literal>"Files"</literal> section in
<filename>/etc/X11/xorg.conf</filename>. The
following line must be added <emphasis>before</emphasis>
any other <literal>FontPath</literal> entries:</para>
<programlisting>FontPath "/usr/local/lib/X11/fonts/cyrillic"</programlisting>
- <note>
- <para>Search the Ports Collection for more Cyrillic
- fonts.</para>
- </note>
- </listitem>
+ <para>Additional Cyrillic
+ fonts are available in the Ports Collection.</para>
- <listitem>
<para>To activate a Russian keyboard, add the following
to the <literal>"Keyboard"</literal> section of
<filename>/etc/xorg.conf</filename>:</para>
@@ -983,10 +947,7 @@ Option "XkbOptions" "grp:toggle"</progr
<para>The Russian XKB keyboard may not work with
non-localized applications.</para>
</note>
- </listitem>
- </orderedlist>
- <note>
<para>Minimally localized applications should call a
<function>XtSetLanguageProc (NULL, NULL, NULL);</function>
function early in the program.</para>
@@ -994,81 +955,100 @@ Option "XkbOptions" "grp:toggle"</progr
<para>See <link xlink:href="http://koi8.pp.ru/xwin.html">
KOI8-R for X Window</link> for more instructions on
localizing <application>Xorg</application>
- applications.</para>
- </note>
- </sect3>
+ applications. For more general
+ information about KOI8-R encoding, refer to
+ <link xlink:href="http://koi8.pp.ru/">KOI8-R -
+ Russian Net Character Set</link>.</para>
</sect2>
<sect2>
- <title>Traditional Chinese Localization for Taiwan</title>
+ <title>Additional Language-Specific Resources</title>
+
+ <para>Some intro text here...</para>
<indexterm>
<primary>localization</primary>
<secondary>Traditional Chinese</secondary>
</indexterm>
+ <indexterm>
+ <primary>localization</primary>
+ <secondary>German</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>localization</primary>
+ <secondary>Greek</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>localization</primary>
+ <secondary>Japanese</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>localization</primary>
+ <secondary>Korean</secondary>
+ </indexterm>
+
+ <variablelist>
+ <varlistentry>
+ <term>Traditional Chinese for Taiwan</term>
+
+ <listitem>
<para>The &os;-Taiwan Project has a Chinese HOWTO for
&os; at <uri
xlink:href="http://netlab.cse.yzu.edu.tw/~statue/freebsd/zh-tut/">http://netlab.cse.yzu.edu.tw/~statue/freebsd/zh-tut/</uri>
using many Chinese ports. The current editor for the
<literal>&os; Chinese HOWTO</literal> is Shen Chuan-Hsing
<email>statue at freebsd.sinica.edu.tw</email>.</para>
- </sect2>
-
- <sect2>
- <title>German Language Localization for All ISO 8859-1
- Languages</title>
-
- <indexterm>
- <primary>localization</primary>
- <secondary>German</secondary>
- </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>German Language Localization for All ISO 8859-1
+ Languages</term>
+ <listitem>
<para>Slaven Rezic <email>eserte at cs.tu-berlin.de</email> wrote a
tutorial on using umlauts on &os;. The tutorial
is written in German and is available at <uri
xlink:href="http://user.cs.tu-berlin.de/~eserte/FreeBSD/doc/umlaute/umlaute.html">http://user.cs.tu-berlin.de/~eserte/FreeBSD/doc/umlaute/umlaute.html</uri>.</para>
- </sect2>
-
- <sect2>
- <title>Greek Language Localization</title>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Greek Language Localization</term>
- <indexterm>
- <primary>localization</primary>
- <secondary>Greek</secondary>
- </indexterm>
+ <listitem>
<para>Nikos Kokkalis <email>nickkokkalis at gmail.com</email> has
written a complete article on Greek support in &os;. It is
available <link
xlink:href="&url.doc.base;/el_GR.ISO8859-7/articles/greek-language-support/index.html">here</link>,
in Greek only, as part of the official &os; Greek
documentation.</para>
- </sect2>
+ </listitem>
+ </varlistentry>
- <sect2>
- <title>Japanese and Korean Language Localization</title>
+ <varlistentry>
+ <term>Japanese and Korean Language Localization</term>
- <indexterm>
- <primary>localization</primary>
- <secondary>Japanese</secondary>
- </indexterm>
- <indexterm>
- <primary>localization</primary>
- <secondary>Korean</secondary>
- </indexterm>
+ <listitem>
<para>For Japanese, refer to <uri
xlink:href="http://www.jp.FreeBSD.org/">http://www.jp.FreeBSD.org/</uri>,
and for Korean, refer to <uri
xlink:href="http://www.kr.FreeBSD.org/">http://www.kr.FreeBSD.org/</uri>.</para>
- </sect2>
+ </listitem>
+ </varlistentry>
- <sect2>
- <title>Non-English &os; Documentation</title>
+ <varlistentry>
+ <term>Non-English &os; Documentation</term>
+ <listitem>
<para>Some &os; contributors have translated parts of the
&os; documentation to other languages. They are available
through links on the <link
xlink:href="&url.base;/index.html">main site</link> or in
<filename>/usr/share/doc</filename>.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect2>
</sect1>
</chapter>
More information about the svn-doc-head
mailing list