path: root/ja_JP.eucJP/books/handbook/l10n/chapter.xml

<?xml version="1.0" encoding="euc-jp"?>
<!--
     The FreeBSD Documentation Project
     The FreeBSD Japanese Documentation Project

     Original revision: r43873
     $FreeBSD$
-->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="l10n">

  <info>
    <title>地域化 (localization) -
      <acronym>i18n</acronym>/<acronym>L10n</acronym> の利用と設定</title>

    <authorgroup>
      <author><personname><firstname>Andrey</firstname><surname>Chernov</surname></personname><contrib>寄稿: </contrib></author>
    </authorgroup>
    <authorgroup>
      <author><personname><firstname>Michael C.</firstname><surname>Wu</surname></personname><contrib>改訂: </contrib></author>
      <!-- 30 Nv 2000 -->
    </authorgroup>
  </info>

  <sect1 xml:id="l10n-synopsis">
    <title>この章では</title>

    <para>&os; は、
      ユーザーおよび貢献者が世界中に分散したプロジェクトです。
      そのため、&os; は多くの言語への地域化に対応しており、
      ユーザは、英語以外の言語を見たり、入力したり、処理したりできます。
      現在では、主要な言語のほとんどから選ぶことができます。
      たとえば中国語、ドイツ語、日本語、韓国語、フランス語、ロシア語、
      ベトナム語などがありますが、これらに限定されるわけではありません。</para>

    <indexterm>
      <primary>国際化 (internationalization)</primary>
      <see>地域化 (localization)</see>
    </indexterm>
    <indexterm><primary>地域化(localization)</primary></indexterm>

    <para>internationalization は、<acronym>i18n</acronym>
      と短縮して表記されます。
      これは internationalization
      の最初と最後の間の文字数に由来します。
      <acronym>L10n</acronym> も同じ命名法を用いて
      <quote>localization</quote> を縮めたものです。
      これらを合わせて、<acronym>i18n</acronym>/<acronym>L10n</acronym>
      された (すなわち国際化/地域化された)
      手法、プロトコル、アプリケーションは、
      自分達の好みの言語を使うことを可能にしてくれます。</para>

    <para>国際化 (<acronym>i18n</acronym>)
      されたアプリケーションは、ライブラリとして <acronym>i18n</acronym>
      化キットを用いてプログラミングされます。
      これは開発者が単純なファイルを書いて、
      表示されるメニューやテキストを各国語に翻訳できるようにしてくれます。</para>

    <para>この章では、&os; の国際化 (internationalization)
      と地域化 (localization) 機能について解説します。
      システムレベルでもアプリケーションレベルでも、
      国際化 (<acronym>i18n</acronym>) の実装には様々な側面があるので、
      必要に応じて可能な範囲で読者に対してより専門的な文書情報を示すことにします。</para>

    <para>この章では、以下の分野について説明します。</para>

    <itemizedlist>
      <listitem>
	<para>近代的なオペレーティングシステムで、
	  異なる言語およびロケールがどのように符号化されているか。</para>
      </listitem>

      <listitem>
	<para>ログインシェルでロケールを設定するにはどうするか。</para>
      </listitem>

      <listitem>
	<para>コンソールを英語以外の言語用に設定するにはどうするか。</para>
      </listitem>

      <listitem>
	<para>様々な言語で効率的に <application>Xorg</application>
	  を使うにはどうすればよいか。</para>
      </listitem>

      <listitem>
	<para>国際化 (<acronym>i18n</acronym>)
	  されたアプリケーションを書くための情報はどこにあるか。</para>
      </listitem>
    </itemizedlist>

    <para>この章を読む前に、以下のことを理解しておく必要があります。</para>

    <itemizedlist>
      <listitem>
	<para><link
	    linkend="ports">サードパーティ製アプリケーションのインストール方法</link></para>
      </listitem>
    </itemizedlist>
  </sect1>

  <sect1 xml:id="using-localization">
    <title>地域化の利用</title>

    <indexterm><primary>ロケール</primary></indexterm>

    <para>地域化の設定は、言語コード、
      国コード、エンコーディングという三つの要素を基本とします。
      ロケール名はこれらから以下のように構成されます。</para>

    <programlisting><replaceable>言語コード</replaceable>_<replaceable>国コード</replaceable>.<replaceable>エンコーディング</replaceable></programlisting>

      <indexterm><primary>言語コード</primary></indexterm>
      <indexterm><primary>国コード</primary></indexterm>

      <para><replaceable>言語コード</replaceable> および
	<replaceable>国コード</replaceable> は、
	国と言語を特定するために用いられます。
	<xref linkend="locale-lang-country"/> では、
	<replaceable>言語コード</replaceable>_<replaceable>国コード</replaceable>
	の例を示します</para>

      <table xml:id="locale-lang-country" frame="none" pgwide="1">
	<title>言語および国コード</title>
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>言語_国コード</entry>
	      <entry>説明</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>en_US</entry>
	      <entry>英語、合衆国</entry>
	    </row>

	    <row>
	      <entry>ru_RU</entry>
	      <entry>ロシア語、ロシア</entry>
	    </row>

	    <row>
	      <entry>zh_TW</entry>
	      <entry>繁体字中国語、台湾</entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>

      <indexterm><primary>エンコーディング</primary></indexterm>
      <indexterm><primary>ASCII</primary></indexterm>

      <para>いくつかの言語 (例えば中国語や日本語) は、
	ASCII 文字では表すことができないので、
	ワイド文字や多バイト文字を用いた拡張された言語のエンコードが必要となります。
	古いアプリケーションの中には、
	これらのエンコードを誤ってコントロール文字として認識するものがありますが、
	最近のアプリケーションは、大抵 8-bit 文字を認識します。
	実装方法にも依りますが、アプリケーションのコンパイル時もしくは
	configure 時に、ワイド/多バイト文字のサポートを指定する必要があるかも知れません。
	以下では、&os; システムにおいてロケールを設定する方法について説明します。
	次の節では、i18n
	に対応するアプリケーションの見つけ方やコンパイル方法について説明します。</para>

      <para>利用可能なすべてのロケールを調べるには、
	以下のように実行してください。</para>

      <screen>&prompt.user; <userinput>locale -a | more</userinput></screen>
      
      <para>現在のロケールの設定を調べるには、
	以下のコマンドを実行してください。</para>
      
      <screen>&prompt.user; <userinput>locale</userinput></screen>

    <sect2 xml:id="setting-locale">
      <title>ログインシェルでロケールを設定する</title>

      <para>ロケールの設定は、ユーザの
	<filename>~/.login_conf</filename>、
	またはユーザのシェルの初期設定ファイルである
	<filename>~/.profile</filename>,
	<filename>~/.bashrc</filename> または <filename>~/.cshrc</filename>
	で行います。</para>

      <para>以下の二つの環境変数を設定する必要があります。</para>

      <itemizedlist>
	<listitem>
	  <para><envar>LANG</envar>: ロケールを設定します。<indexterm>
	      <primary>POSIX</primary>
	    </indexterm></para>
	</listitem>

	<listitem>
	  <indexterm><primary>MIME</primary></indexterm>

	  <para><envar>MM_CHARSET</envar>: アプリケーションで使用される
	    MIME 文字セットを指定します。</para>
	</listitem>
      </itemizedlist>

      <para>これらの変数は、ユーザのシェルの設定ファイルに加え、
	アプリケーション固有の設定ファイル、
	および <application>Xorg</application>
	の設定ファイルにおいても指定される必要があります。</para>

	<indexterm><primary>ロケール (locale)</primary></indexterm>
	<indexterm><primary>ログインクラス</primary></indexterm>

	<para>必要な変数を割り当てるには、二つの方法があります。
	  <link
	    linkend="login-class">ログインクラス</link>
	  において割り当てる方法 (推奨される方法です)、および
	  <link linkend="startup-file">初期化ファイル</link>
	  で指定する方法です。
	  次の 2 つの節では、この両方の方法について説明します。</para>

	<sect3 xml:id="login-class">
	  <title>ログインクラスを用いる方法</title>

	  <para>最初に説明する方法は、
	    すべてのシェルにおいて必要なロケール名と MIME
	    文字セットを環境変数に割り当てます。
	    これは推奨される方法です。
	    この割り当て方法としては、各ユーザが行う方法と、
	    スーパーユーザがすべてのユーザに対して設定する
	    2 つの方法があります。</para>

	    <para>以下の簡単な例では、
	      各ユーザのホームディレクトリの
	      <filename>.login_conf</filename>
	      で、両方の変数に Latin-1 エンコーディングを設定します。</para>

	    <programlisting>me:\
	:charset=ISO-8859-1:\
	:lang=de_DE.ISO8859-1:</programlisting>

	    <indexterm><primary>繁体字中国語 (Traditional Chinese)</primary>
	      <secondary>BIG-5 エンコーディング</secondary></indexterm>
	    <para>これは、BIG-5
	      エンコーディングされた繁体字中国語用の環境変数を設定するユーザの
	      <filename>~/.login_conf</filename> の一例です。
	      中国語、日本語、韓国語用のロケール変数を正しく認識しないソフトウェアに対応するため、
	      より多くの変数に対する設定が行われています。</para>

	    <programlisting>#Users who do not wish to use monetary units or time formats
#of Taiwan can manually change each variable
me:\
	:lang=zh_TW.Big5:\
	:setenv=LC_ALL=zh_TW.Big5:\
	:setenv=LC_COLLATE=zh_TW.Big5:\
	:setenv=LC_CTYPE=zh_TW.Big5:\
	:setenv=LC_MESSAGES=zh_TW.Big5:\
	:setenv=LC_MONETARY=zh_TW.Big5:\
	:setenv=LC_NUMERIC=zh_TW.Big5:\
	:setenv=LC_TIME=zh_TW.Big5:\
	:charset=big5:\
	:xmodifiers="@im=gcin": #Set gcin as the XIM Input Server</programlisting>

	    <para>もう一つの方法では、
	      スーパーユーザがシステム上のすべてのユーザに対する地域化を設定します。
	      <filename>/etc/login.conf</filename>
	      の以下の変数により、ロケールおよび MIME
	      文字セットを設定します。</para>

	    <programlisting><replaceable>language_name</replaceable>|<replaceable>Account Type Description</replaceable>:\
	:charset=<replaceable>MIME_charset</replaceable>:\
	:lang=<replaceable>locale_name</replaceable>:\
	:tc=default:</programlisting>

	    <para>よって、先ほどの例における Latin-1 に対する設定は、
	      以下のようになります。</para>

	    <programlisting>german|German Users Accounts:\
	:charset=ISO-8859-1:\
	:lang=de_DE.ISO8859-1:\
	:tc=default:</programlisting>

	    <para>詳細に関しては
		&man.login.conf.5; を参照してください。</para>

	    <para><filename>/etc/login.conf</filename> を編集したら、
	      忘れずに以下のコマンドを実行してケイパビリティデータベースをアップデートしてください。</para>

	    <screen>&prompt.root; <userinput>cap_mkdb /etc/login.conf</userinput></screen>

 	    <sect4>
	    <title>ログインクラスを変更するユーティリティ</title>

	    <indexterm>
	      <primary><command>vipw</command></primary>
	    </indexterm>

	    <para><filename>/etc/login.conf</filename>
	      を手動により編集する方法に加え、
	      新たに作成するユーザのロケールを設定するためのユーティリティがあります。</para>

	    <para><command>vipw</command>
	      を使って新しいユーザを追加する際には、使用する言語を
	      <replaceable>language</replaceable>
	      に指定してください。</para>

	    <programlisting>user:password:1111:11:<replaceable>language</replaceable>:0:0:User Name:/home/user:/bin/sh</programlisting>

	    <indexterm>
	      <primary><command>adduser</command></primary>
	    </indexterm>
	    <indexterm><primary>ログインクラス</primary></indexterm>

	    <para><command>adduser</command>
	      を使って新しいユーザを追加する場合に、
	      すべてのユーザに対するデフォルトの言語は事前に設定でき、
	      個々のユーザに対する言語を指定できます。</para>

		<para>新しく追加するすべてのユーザが同じ言語を使う場合には、
		  <filename>/etc/adduser.conf</filename> で
		  <literal>defaultclass =
		    language</literal>
		  と設定してください。</para>

		<para>新しいユーザを作成するときに、この設定を変更するには、
		  以下のプロンプトにおいて希望するロケールを指定してください。</para>

		  <screen><prompt>Enter login class: default []: </prompt></screen>

		<para>もしくは、<command>adduser</command>
		  を実行する際にロケールを指定してください。</para>

		<screen>&prompt.root; <userinput>adduser -class language</userinput></screen>

	    <indexterm>
	      <primary><command>pw</command></primary>
	    </indexterm>

	    <para><command>pw</command>
	      を使って新しいユーザを追加する場合には、
	      以下のようにしてロケールを指定してください。</para>

	    <screen>&prompt.root; <userinput>pw useradd user_name -L language</userinput></screen>
	  </sect4>
	</sect3>

	<sect3 xml:id="startup-file">
	  <title>シェルの初期化ファイルによる方法</title>

	    <para>ここで説明する方法は、
	      使用するシェルごとに手動での設定が必要なため、
	      推奨されません。
	      シェル毎に設定ファイルが存在し、その構文はシェルに依存します。
	      たとえば、<command>sh</command>
	      シェルに対するドイツ語の設定では、
	      そのユーザのシェルを設定するためだけに、
	      <filename>~/.profile</filename>
	      に以下の行を追加ます。
	      これらの行を <filename>/etc/profile</filename> または、
	      <filename>/usr/share/skel/dot.profile</filename> に追加すると、
	      すべてのユーザのシェルを設定することが可能です。</para>

	  <programlisting><envar>LANG=de_DE.ISO8859-1; export LANG</envar>
<envar>MM_CHARSET=ISO-8859-1; export MM_CHARSET</envar></programlisting>

	  <para>しかしながら、<command>csh</command> シェルでは、
	    設定ファイルの名前や構文は異なります。
	    <filename>~/.csh.login</filename>,
	    <filename>/etc/csh.login</filename> または
	    <filename>/usr/share/skel/dot.login</filename>
	    では同じ設定です。</para>

	  <programlisting><envar>setenv LANG de_DE.ISO8859-1</envar>
<envar>setenv MM_CHARSET ISO-8859-1</envar></programlisting>

	  <para>さらに面倒なことに、
	    <application>Xorg</application> を設定するための
	    <filename>~/.xinitrc</filename> における構文は、
	    使用しているシェルに依存します。
	    以下の例において、最初は <command>sh</command>
	    シェルに対するもので、2 番目が
	    <command>csh</command> シェルに対するものです。</para>

	  <programlisting><envar>LANG=de_DE.ISO8859-1; export LANG</envar></programlisting>

	  <programlisting><envar>setenv LANG de_DE.ISO8859-1</envar></programlisting>
      </sect3>
    </sect2>

    <sect2 xml:id="setting-console">
      <title>コンソールの設定</title>

      <para>C 言語の char で表現できるシングルバイトの文字セット用に、
	<filename>/etc/rc.conf</filename>
	でその言語に対応した適切なコンソールフォントを指定してください。</para>

      <programlisting>font8x16=<replaceable>フォント名</replaceable>
font8x14=<replaceable>フォント名</replaceable>
font8x8=<replaceable>フォント名</replaceable></programlisting>

      <para>ここで <replaceable>フォント名</replaceable> は
	<filename>/usr/share/syscons/fonts</filename>
	にあるフォントファイルから <filename>.fnt</filename>
	という拡張子を除いたものです。</para>

      <indexterm>
	<primary><application>sysinstall</application></primary>
      </indexterm>
      <indexterm><primary>keymap</primary></indexterm>
      <indexterm><primary>screenmap</primary></indexterm>
      <para><command>sysinstall</command> を使って、C 言語の char
	で表現できるシングルバイトの文字セット用のキーマップとスクリーンマップを指定できます。
	<application>sysinstall</application> で、
	<guimenuitem>Configure</guimenuitem> を選択し、
	<guimenuitem>Console</guimenuitem> を選択してください。
	もしくは、<filename>/etc/rc.conf</filename>
	に以下の行を加えてください。</para>

      <programlisting>scrnmap=<replaceable>スクリーンマップ名</replaceable>
keymap=<replaceable>キーマップ名</replaceable>
keychange="<replaceable>ファンクションキー番号の並び</replaceable>"</programlisting>

      <para>ここで <replaceable>スクリーンマップ名</replaceable>
	は <filename>/usr/share/syscons/scrnmaps</filename>
	にあるマップファイルから <filename>.scm</filename>
	という拡張子を除いたものです。
	VGA アダプタがフォント文字マトリクスで
	bit 8 を bit 9 に拡張することに対処するために、
	フォントに適切にマップされたスクリーンマップが必要となります。
	スクリーンフォントが bit 8
	列を使っている時に文字を疑似グラフィクス領域から外に移動します。</para>

      <para><filename>/etc/rc.conf</filename> において、
	<application>moused</application> を有効にしている場合は、
	次の段落に書かれているマウスカーソルに関する情報を確認してください。</para>

      <indexterm>
	<primary><application>moused</application></primary>
      </indexterm>
      <para>設定省略時には、&man.syscons.4;
	ドライバのマウスカーソルはキャラクタセット中の
	0xd0-0xd3 の範囲を占めています。そのため、
	利用している言語がこの範囲のキャラクタセットを使っている場合、
	カーソルの占める範囲を移動してください。
	&os; でこれを回避するには、次の行を
	<filename>/etc/rc.conf</filename> に追加してください。</para>

      <programlisting>mousechar_start=3</programlisting>

      <para>上記の例の <replaceable>キーマップ名</replaceable> は
	<filename>/usr/share/syscons/keymaps</filename>
	にあるキーマップファイルから <filename>.kbd</filename>
	という拡張子を除いたものです。
	どのキーマップを使うかよくわからないなら、&man.kbdmap.1;
	で再起動せずにキーマップを試すことができます。</para>

      <para>ファンクションキーの並びはキーマップにより定義されてはいないため、
	端末タイプに合わせたファンクションキーを設定するために
	<literal>keychange</literal> が必要となります。</para>

      <para><filename>/etc/ttys</filename>
	の中のすべての仮想端末のエントリに対して、
	正しいコンソール端末タイプを設定するようにしてください。
	現在の定義済の値は以下の通りです。</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>文字セット</entry>
	      <entry>端末タイプ</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>ISO8859-1 もしくは ISO8859-15</entry>
	      <entry><literal>cons25l1</literal></entry>
	    </row>

	    <row>
	      <entry>ISO8859-2</entry>
	      <entry><literal>cons25l2</literal></entry>
	    </row>

	    <row>
	      <entry>ISO8859-7</entry>
	      <entry><literal>cons25l7</literal></entry>
	    </row>

	    <row>
	      <entry>KOI8-R</entry>
	      <entry><literal>cons25r</literal></entry>
	    </row>

	    <row>
	      <entry>KOI8-U</entry>
	      <entry><literal>cons25u</literal></entry>
	    </row>

	    <row>
	      <entry>CP437 (VGA のデフォルト)</entry>
	      <entry><literal>cons25</literal></entry>
	    </row>

	    <row>
	      <entry>US-ASCII</entry>
	      <entry><literal>cons25w</literal></entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>

      <para>ワイド/多バイト文字の言語については、
	<filename>/usr/ports/language</filename>
	内の適切な &os; port を利用してください。
	いくつかのアプリケーションは、
	システムに対しシリアルターミナルとして振る舞います。
	<filename>/etc/ttys</filename> において、
	<application>Xorg</application>
	と疑似シリアルコンソール用に充分なターミナルを用意してください。 
	以下はコンソールで他の言語を使うためのアプリケーションのリストの一部です。</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>言語</entry>
	      <entry>ports の位置</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>繁体字中国語 (BIG-5)</entry>
	      <entry><package>chinese/big5con</package></entry>
	    </row>

	    <row>
	      <entry>日本語</entry>
	      <entry><package>japanese/kon2-16dot</package> または
		<package>japanese/mule-freewnn</package></entry>
	    </row>

	    <row>
	      <entry>韓国語</entry>
	      <entry><package>korean/han</package></entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </sect2>

    <sect2>
      <title>Xorg の設定</title>

      <para><application>Xorg</application> は &os;
	とともにインストールされませんが、
	Ports Collection からインストールできます。
	インストール方法についての詳細は、
	<xref linkend="x11"/> を参照してください。
	この節では、インストールされた <application>Xorg</application>
	をどのように地域化するかについて説明します。</para>

      <para>フォント、メニューなどのアプリケーション固有の国際化
	 (<acronym>i18n</acronym>) の設定は、
	 <filename>~/.Xresources</filename> において指定できます。</para>

      <sect3>
	<title>フォントの表示</title>
	<indexterm><primary>Xorg True Type
	    フォントサーバ</primary></indexterm>

	<para><package>x11-servers/xorg-server</package>
	  をインストールしたら、言語の
	  &truetype; フォントをインストールしてください。
	  ロケールを正しく設定すれば、
	  選んだ言語がアプリケーションのメニューに表示されるはずです。</para>
      </sect3>

      <sect3>
	<title>非英語の文字を入力する</title>

	<indexterm><primary>X Input Method (XIM)</primary></indexterm>

	<para>X Input Method (<acronym>XIM</acronym>)
	  プロトコルは <application>Xorg</application>
	  クライアント用の標準規格です。
	  すべての <application>Xorg</application> アプリケーションは
	  XIM 入力サーバからの入力を受け取る
	  XIM クライアントとして書かれるべきです。
	  様々な言語用の XIM サーバが存在します。</para>
      </sect3>
    </sect2>

    <sect2>
      <title>プリンタの設定</title>

      <para>プリンタにはいくつかの C 言語の char で表現できる
	シングルバイトの文字セットがハードウェアに組み込まれています。
	ワイド/多バイトの文字セットでは、<application>apsfilter</application>
	といったユーティリティを使用する特殊な設定が必要です。
	言語固有のコンバータを用いて、文書を &postscript; や PDF
	フォーマットにコンバートできます。</para>
    </sect2>

    <sect2>
      <title>カーネルとファイルシステム</title>

      <para>&os; の高速ファイルシステム (<acronym>FFS</acronym>)
	は 8-bit 透過であり、
	C 言語の char で表現できるいかなる文字セットも使うことが
	できます。
	しかし、ファイルシステム中には文字セットの名前は記録されていません。
	したがって、これは単なる 8-bit であり、
	エンコーディングに関しては何の情報もないのです。
	公式には、<acronym>FFS</acronym>
	はいかなるワイド/マルチバイトの文字セットもサポートしていません。
	しかし <acronym>FFS</acronym>
	でそのようなサポートを行うためのパッチが、
	多くのワイド/マルチバイトの文字セットに存在します。
	これらのパッチに関しては、各言語のウェブサイトを参照してください。
      </para>

      <indexterm><primary>DOS</primary></indexterm>
      <indexterm><primary>Unicode</primary></indexterm>
      <para>&os; の &ms-dos; ファイルシステムに対する対応については、
	&ms-dos;, Unicode 文字セット、&os;
	ファイルシステムの文字セットの間で変換を行うことが可能です。
	詳細は &man.mount.msdosfs.8; を参照してください。</para>
    </sect2>
  </sect1>

  <sect1 xml:id="l10n-compiling">
    <title>国際化 (<acronym>i18n</acronym>)
      に対応したプログラムのコンパイル</title>

      <para>アプリケーションがワイド/多バイト文字に対応するために、
	<link xlink:href="&url.base;/ja/ports/index.html">&os; Ports
	  Collection</link> では各言語向けのプログラムを提供しています。
	アプリケーションを正しく configure する方法や、port
	の構築時に使用するコンパイルオプションを決めるための、
	より詳細な情報については、
	各 &os; port の <acronym>i18n</acronym> 文書を参照してください。</para>

      <para>次のことを心に留めておいてください。</para>

      <itemizedlist>
	<listitem>
	  <para>言語固有の、C 言語の char で表現できる
	    ISO8859-1, ISO8859-15, KOI8-R, CP437
	    といったシングルバイトの文字セット。
	    &man.multibyte.3; を参照してください。</para>
	</listitem>

	<listitem>
	  <para>EUC および Big5 といった、
	    ワイド/多バイトのエンコーディング。</para>
	</listitem>
      </itemizedlist>

      <para>現在有効な文字セットのリストは、
	<link
	  xlink:href="http://www.iana.org/assignments/character-sets">IANA
	    Registry</link>
	で確認できます。</para>

      <note>
	<para>&os; では、Xorg 互換のロケール符号を用いています。</para>
      </note>

    <para>&os; Ports Collection では、国際化
      (<acronym>i18n</acronym>) されたアプリケーションの名前には
      容易に認識できるように、<literal>-i18n</literal>
      と付いています。しかしながら、
      に必要とする言語に対応しているとは限りません。</para>

    <para>&os; Ports Collection の多くのアプリケーションはすでに国際化
      (<acronym>i18n</acronym>) されています。
      いくつかの port の名前には、<literal>-i18n</literal>
      と付いています。
      これらはもちろんのこと、
      他のプログラムも国際化 (<acronym>i18n</acronym>)
      への対応を組み込んだものがあり、
      コンパイルに際して特別な注意を払う必要はありません。</para>

    <indexterm>
      <primary><application>MySQL</application></primary>
    </indexterm>
    <para>しかし、<application>MySQL</application> のようなアプリケーションでは、
      特定の文字セットを使うように port の <filename>Makefile</filename>
      を設定する必要があります。
      これは大抵 <filename>Makefile</filename> の中で
      対処されているか、ソース中の <application>configure</application>
      に値を渡すことで対応しています。</para>
  </sect1>

  <sect1 xml:id="lang-setup">
    <title>&os; を特定の言語に地域化する</title>

    <sect2 xml:id="ru-localize">
      <info>
	<title>ロシア語 (KOI8-R エンコーディング)</title>

 	<authorgroup>
	  <author><personname><firstname>Andrey</firstname><surname>Chernov</surname></personname><contrib>原作: </contrib></author>
	</authorgroup>
      </info>

      <indexterm>
	<primary>地域化</primary>
	<secondary>ロシア語</secondary>
      </indexterm>

      <para>KOI8-R エンコーディングの詳細については、
	<link xlink:href="http://koi8.pp.ru/">KOI8-R References
	  (Russian Net Character Set)</link> を参照してください。</para>

      <sect3>
	<title>ロケールの設定</title>

	<para>このロケールに設定するには、以下の行を各ユーザの
	  <filename>~/.login_conf</filename> に追加してください。</para>

	<programlisting>me:My Account:\
	:charset=KOI8-R:\
	:lang=ru_RU.KOI8-R:</programlisting>
      </sect3>

      <sect3>
	<title>コンソールの設定</title>

	<itemizedlist>
	  <listitem>
	    <para><filename>/etc/rc.conf</filename>
	      に以下の行を追加してください。</para>

	    <programlisting>keymap="ru.koi8-r"
scrnmap="koi8-r2cp866"
font8x16="cp866b-8x16"
font8x14="cp866-8x14"
font8x8="cp866-8x8"
mousechar_start=3</programlisting>
	  </listitem>

	  <listitem>
	    <para><filename>/etc/ttys</filename> の各
	      <literal>ttyv</literal> エントリにおいて、
	      端末タイプとして <literal>cons25r</literal>
	      を指定してください。</para>
	  </listitem>
	</itemizedlist>
      </sect3>

      <sect3>
	<title>プリンタの設定</title>
	<indexterm><primary>プリンタ</primary></indexterm>

	<para>ロシア語用の文字を搭載したプリンタはほとんど
	  ハードウェアコードページ CP866 を使っているため、
	  KOI8-R を CP866 に変換する専用の出力フィルタが必要となります。
	  &os; は、デフォルトフィルタを
	  <filename>/usr/libexec/lpr/ru/koi2alt</filename>
	  にインストールします。
	  ロシア語用のプリンタの <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>記述のより詳細については &man.printcap.5;
	  を参照してください。</para>
      </sect3>

      <sect3>
	<title>&ms-dos; およびロシア語ファイル名</title>

	<para>以下の &man.fstab.5; エントリの例は、マウントされた
	  &ms-dos; ファイルシステムにおいてロシア語ファイル名を
	  使えるようにします。</para>

	<programlisting>/dev/ad0s2      /dos/c  msdos   rw,-Lru_RU.KOI8-R 0 0</programlisting>

	<para><option>-L</option> はロケール名を選択します。
	  詳しくは、&man.mount.msdosfs.8; を参照してください。</para>
      </sect3>

      <sect3>
	<title><application>Xorg</application> の設定</title>

	<orderedlist>
	  <listitem>
	    <para>まず <link linkend="setting-locale">X
	      以外のロケールの設定</link> を行ってください。</para>
	  </listitem>

	  <listitem>
	    <para><application>&xorg;</application> を使う際には、
	      <package>x11-fonts/xorg-fonts-cyrillic</package>
	      パッケージをインストールしてください。</para>

	    <para><filename>/etc/X11/xorg.conf</filename> の
	      <literal>"Files"</literal>
	      セクションをチェックしてください。
	      既存の <literal>FontPath</literal>
	      エントリの<emphasis>前に</emphasis>以下の行を追加しなければなりません。</para>

	    <programlisting>FontPath   "/usr/local/lib/X11/fonts/cyrillic"</programlisting>

	    <note>
	      <para>他の Cyrillic フォントについては、
		Ports Collection を検索してください。</para>
	    </note>
	  </listitem>

	  <listitem>
	    <para>ロシア語のキーボードを使えるようにするには、
	      以下の行を <filename>xorg.conf</filename> の
	      <literal>"Keyboard"</literal> セクションに追加します。</para>

	    <programlisting>Option "XkbLayout"   "us,ru"
Option "XkbOptions"  "grp:toggle"</programlisting>

	    <para>このファイルの中で <literal>XkbDisable</literal>
	      がコメントアウトされていることを確認してください。
	    </para>

	    <para><literal>grp:toggle</literal>
	      では <keycap>Right Alt</keycap> を使い、
	      <literal>grp:ctrl_shift_toggle</literal>
	      では <keycombo
		action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap></keycombo>
	      を使います。
	      <literal>grp:caps_toggle</literal> では、
	      <keycap>CapsLock</keycap> を使います。
	      従来の <keycap>CapsLock</keycap> の機能は、
	      ラテン文字モードの時のみ
	      <keycombo
		action="simul"><keycap>Shift</keycap><keycap>CapsLock</keycap></keycombo>
	      で使うことができます。
	      <application>&xorg;</application> では、理由は不明ですが
	      <literal>grp:caps_toggle</literal> は動作しません。</para>

	    <para>キーボードに <quote>&windows;</quote> キーがあり、
	      そのキーにいくつかの非英字キーが割り当てられているようなら、
	      <filename>xorg.conf</filename>
	      に以下の行を追加してください。</para>

	    <programlisting>Option "XkbVariant" ",winkeys"</programlisting>

	    <note>
	      <para>ロシア語の XKB キーボードは、
		地域化されていないアプリケーションではうまく動かないかも知れません。</para>
	    </note>
	  </listitem>
	</orderedlist>

	<note>
	  <para>地域化がされたアプリケーションは少なくともプログラムの最初の方で
	    <function>XtSetLanguageProc (NULL, NULL, NULL);</function>
	    を呼び出すべきです。
	    <application>Xorg</application>
	    アプリケーションを地域化する方法については、
	    <link xlink:href="http://koi8.pp.ru/xwin.html">
	      KOI8-R for X Window</link>
	    を参照してください。</para>
	</note>
      </sect3>
    </sect2>

    <sect2>
      <title>台湾向けの繁体字中国語への地域化</title>

      <indexterm>
	<primary>地域化</primary>
	<secondary>繁体字中国語</secondary>
      </indexterm>

      <para>&os;-Taiwan プロジェクトは、多くの
	中国語 ports を利用した、
	&os; を中国語化するための手引き <uri
	  xlink:href="http://netlab.cse.yzu.edu.tw/~statue/freebsd/zh-tut/">http://netlab.cse.yzu.edu.tw/~statue/freebsd/zh-tut/</uri>
	を提供しています。
	<literal>&os; Chinese HOWTO</literal> の現在の編集者は
	Shen Chuan-Hsing <email>statue@freebsd.sinica.edu.tw</email> です。</para>
    </sect2>

    <sect2>
      <title>ドイツ語への地域化 (すべての ISO 8859-1 言語向け)</title>

      <indexterm>
	<primary>地域化</primary>
	<secondary>ドイツ語</secondary>
      </indexterm>

      <para>Slaven Rezic <email>eserte@cs.tu-berlin.de</email> は
	&os; マシン上でウムラウトを使うためのチュートリアルを書きました。
	チュートリアルはドイツ語で書かれており、<uri
	  xlink:href="http://user.cs.tu-berlin.de/~eserte/FreeBSD/doc/umlaute/umlaute.html"></uri>
	から入手できます。</para>
    </sect2>

    <sect2>
      <title>ギリシャ語への地域化</title>

      <indexterm>
	<primary>地域化</primary>
	<secondary>Greek</secondary>
      </indexterm>
      <para>Nikos Kokkalis <email>nickkokkalis@gmail.com</email> は、
	&os; におけるギリシャ語のサポートについての記事を書きました。
	これは、公式の &os; ギリシャ語ドキュメンテーションの一部として
	<link
	  xlink:href="&url.doc.base;/el_GR.ISO8859-7/articles/greek-language-support/index.html">ここ</link> で読むことができます。
	この文書は、ギリシャ語で書かれています。</para>
    </sect2>

    <sect2>
      <title>日本語/韓国語への地域化</title>

      <indexterm>
	<primary>地域化</primary>
	<secondary>日本語</secondary>
      </indexterm>
      <indexterm>
	<primary>地域化</primary>
	<secondary>韓国語</secondary>
      </indexterm>
      <para>日本語に関しては <uri
	  xlink:href="http://www.jp.FreeBSD.org/">http://www.jp.FreeBSD.org/</uri>
	を、韓国語に関しては <uri
	  xlink:href="http://www.kr.FreeBSD.org/">http://www.kr.FreeBSD.org/</uri>
	を参照してください。</para>
    </sect2>

    <sect2>
      <title>英語以外の &os; ドキュメント</title>

      <para>&os; の文書の一部を他の言語に翻訳してくれている貢献者たちがいます。
	これらは <link
	  xlink:href="&url.base;/ja/index.html">メインサイト</link>
	のリンクを辿るか
	<filename class="directory">/usr/share/doc</filename>
	から入手できます。</para>
    </sect2>
  </sect1>
</chapter>