Add Localization section and Russian Language l10n description

(somebody with better English, please check!)

BTW: Next: entry have wrong name "Network Communications"
in Locale Setup although points to right direction.
Looks like sgmlfmt bug...
This commit is contained in:
Andrey A. Chernov 1997-05-02 02:20:25 +00:00
parent 1ac310ddf7
commit b63edaf35f
4 changed files with 148 additions and 4 deletions

View File

@ -1,4 +1,4 @@
# $Id: Makefile,v 1.23 1997/02/22 12:58:05 peter Exp $
# $Id: Makefile,v 1.24 1997/05/01 03:06:31 jfieber Exp $
SRCS= authors.sgml basics.sgml bibliography.sgml boothelp.sgml
SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml cvsup.sgml
@ -10,7 +10,7 @@ SRCS+= kerberos.sgml kernelconfig.sgml kerneldebug.sgml kernelopts.sgml
SRCS+= lists.sgml mail.sgml memoryuse.sgml
SRCS+= mirrors.sgml nfs.sgml nutshell.sgml pgpkeys.sgml policies.sgml
SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml
SRCS+= quotas.sgml relnotes.sgml routing.sgml
SRCS+= quotas.sgml relnotes.sgml routing.sgml russian.sgml
SRCS+= serial.sgml scsi.sgml sections.sgml sio.sgml skey.sgml slipc.sgml
SRCS+= slips.sgml stable.sgml submitters.sgml sup.sgml synching.sgml
SRCS+= term.sgml userppp.sgml uart.sgml linuxemu.sgml

View File

@ -1,4 +1,4 @@
<!-- $Id: handbook.sgml,v 1.69 1997/04/08 00:47:59 jfieber Exp $ -->
<!-- $Id: handbook.sgml,v 1.70 1997/05/01 03:06:31 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [
@ -103,6 +103,9 @@ name="FreeBSD FTP server"> or one of the numerous
&hw;
<chapt><heading>Localization<label id="l10n"></heading>
&russian;
<!-- ************************************************************ -->
<part><heading>Network Communications</heading>

View File

@ -0,0 +1,140 @@
<!-- $Id: pgpkeys.sgml,v 1.20 1997/04/25 22:58:22 ache Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Russian Language<label id="russian"></heading>
<p><em>Contributed by &a.ache;<newline>
1 May 1997</em>.
<sect1><heading>Console Setup<label id="russian:console"></heading>
<p>
Russian console entry in <tt>/etc/rc.conf</tt> should looks like
<tscreen><verb>
keymap=ru.koi8-r
keychange="61 ^[[K"
scrnmap=koi8-r2cp866
font8x16=cp866b-8x16
font8x14=cp866-8x14
font8x8=cp866-8x8
</verb></tscreen>
<p>
NOTE: ^[ means that real ESC character must be entered into
<tt>/etc/rc.conf</tt>,
not just ^[ string.
<p>
This tuning means koi8-r keyboard with Alternative codeset
screen font mapped to koi8-r character set to
preserve pseudographics, <it>Gray Delete</it> key remapped to match Russian
termcap entry for console.
See <tt>rc.conf(5)</tt> for details.
<p>
For each <tt>ttyv?</tt> entry in <tt>/etc/ttys</tt>
change terminal type from <bf>cons25</bf> to
<bf>cons25r</bf>, i.e. each entry should looks like
<tscreen><verb>
ttyv0 "/usr/libexec/getty Pc" cons25r on secure
</verb></tscreen>
<sect1><heading>Locale Setup<label id="russian:locale"></heading>
<p>
There is two environment variables for locale setup: <tt>LANG</tt>
and <tt>MM_CHARSET</tt>.
The best way is using <tt>/etc/login.conf</tt>
<bf>russian</bf> user's login class
in <tt>passwd(5)</tt> entry login class position.
See <tt>login.conf(5)</tt> for details.
<sect2><heading>Login Class Method<label id="russian:class"></heading>
<p>
As first step check your <tt>/etc/login.conf</tt> have
<bf>russian</bf> login class, this entry may looks like:
<tscreen><verb>
russian:Russian Users Accounts:\
:charset=KOI8-R:\
:lang=ru_RU.KOI8-R:\
:tc=default:
</verb></tscreen>
<sect3><heading>How to do it with vipw(8)</heading>
<p>
If you use <tt>vipw(8)</tt> for adding new users,
<tt>/etc/master.passwd</tt>
entry should looks like:
<tscreen><verb>
user:password:1111:11:russian:0:0:User Name:/home/user:/bin/csh
</verb></tscreen>
<sect3><heading>How to do it with adduser(8)</heading>
<p>
If you use <tt>adduser(8)</tt> for adding new users, set
<tscreen><verb>
defaultclass = russian
</verb></tscreen>
in <tt>/etc/adduser.conf</tt>
(you must enter <bf>default</bf> class for all non-Russian
users in this case).
<p>
Alternative variant will be answer <bf>russian</bf> each time when you see
<tscreen><verb>
Enter login class: default []:
</verb></tscreen>
prompt from <tt>adduser(8)</tt>, or call
<tscreen><verb>
# adduser -class russian
</verb></tscreen>
for each Russian user you want to add.
<sect3><heading>How to do it with pw(8)</heading>
<p>
If you use <tt>pw(8)</tt> for adding new users, call it in this form:
<tscreen><verb>
# pw useradd user_name -L russian
</verb></tscreen>
<sect2><heading>Shell Startup Files Method</heading>
<p>
If you don't want to use
<ref id="russian:class" name="login class method">
for some reasons, just set
this two environment variables in <tt>/etc/profile</tt>:
<tscreen><verb>
LANG=ru_RU.KOI8-R; export LANG
MM_CHARSET=KOI8-R; export MM_CHARSET
</verb></tscreen>
and <tt>/etc/csh.login</tt>:
<tscreen><verb>
setenv LANG ru_RU.KOI8-R
setenv MM_CHARSET KOI8-R
</verb></tscreen>
<p>
Alternatively you can add this instructions to
<tt>/usr/share/skel/dot.profile</tt>
(similar to <tt>/etc/profile</tt>) and
<tt>/usr/share/skel/dot.login</tt> (similar to
<tt>/etc/csh.login</tt>).
<sect1><heading>X Window Setup<label id="russian:xwindow"></heading>
<p>
First off all do
<ref id="russian:locale" name="locale setup"> as described.
<p>
Then go to <tt>/usr/ports/russian/X.language</tt> directory and say
<tscreen><verb>
# make all install
</verb></tscreen>
there. This port install latest version of KOI8-R fonts.
<p>
Check find <tt>"Files"</tt> section in your <tt>/etc/XF86Config</tt>,
following lines must be before any other <tt>FontPath</tt> entries:
<tscreen><verb>
FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/misc"
FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/75dpi"
FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/100dpi"
</verb></tscreen>
<p>If you use high resolution video mode, swap 75 dpi and
100 dpi lines.
<p>To activate Russian keyboard add
<tscreen><verb>
XkbKeymap "xfree86(ru)"
</verb></tscreen>
line into <tt>"Keyboard"</tt> section in your <tt>/etc/XF86Config</tt>,
also make sure that <tt>XkbDisable</tt> is turned off (commented out)
there.

View File

@ -1,4 +1,4 @@
<!-- $Id: sections.sgml,v 1.22 1997/02/22 12:59:19 peter Exp $ -->
<!-- $Id: sections.sgml,v 1.23 1997/05/01 03:06:32 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!-- Entities containing all the pieces of the handbook are -->
@ -47,6 +47,7 @@
<!ENTITY quotas SYSTEM "quotas.sgml">
<!ENTITY relnotes SYSTEM "relnotes.sgml">
<!ENTITY routing SYSTEM "routing.sgml">
<!ENTITY russian SYSTEM "russian.sgml">
<!ENTITY serial SYSTEM "serial.sgml">
<!ENTITY scsi SYSTEM "scsi.sgml">
<!ENTITY sio SYSTEM "sio.sgml">