<!--DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook V4.1//EN"-->
<appendix id="xim">
	<title>日本語入力トラブルシューティング</title>
	<para>X Window System 上で日本語の入力・変換ができなくなった場合、いろいろな原因が考えられます。どんなトラブルにも言えることですが、原因を突き止めるには問題点を絞りこむ必要があります。</para>
	<para><xref linkend="xim" />では、解決法と言うよりは、むしろそうした場合にまず何を調べればよいかを説明し、解決のヒントを書いておきます。</para>

<!--appendixinfo>
  <authorgroup>
    <author>
      <firstname>Yasumichi</firstname>
      <surname>Akahoshi</surname>
    </author>
    <editor>
      <firstname>Takuya</firstname>
      <surname>Kobayashi</surname>
    </editor>
  </authorgroup>
  <pubdate>2007/9/29</pubdate>
  <abstract>
  </abstract>
</appendixinfo-->

<sect1 id="postulate">
  <title>前提事項</title>
  <para>以下の説明は次の三つを前提にしています。</para>
  <itemizedlist> 
    <listitem><para>かな漢字変換システム(漢字入力システム)に Canna か FreeWnn を使っていること。</para></listitem>
    <listitem><para>kterm などでの漢字入力に kinput2 を利用していること。</para></listitem>
    <listitem><para>X Window System の起動時に実行されるスクリプト(xinitrc、Xsession など。以下では X 起動スクリプトと書く)は、自分で作ったものではなく、Vine 付属のものを使っていること。</para></listitem>
  </itemizedlist> 
  <para>
とは言え、ほかのかな漢字変換システムをご利用の方や、自分で X 起動スクリプトをお書きになっている方にも、参考になるところがあるだろうと思います。
  </para>
</sect1>

<sect1 id="checklist">
	<title>チェックリスト</title>
	<variablelist>
		<varlistentry>
			<term>入力・変換ができなくなった状況は?</term>
			<listitem><para>さっきまで問題なく使えていて、突然入力・変換が出来なくなったのなら、その間に何をしたかを思い出してください。</para></listitem>
		</varlistentry>
		<varlistentry>
			<term>~/.bash_profile と ~/.bashrc は存在しますか?</term>
			<listitem>
				<para>ホームディレクトリに <filename>.bash_profile</filename> と <filename>.bashrc</filename> は存在しますか。Vine の X 起動スクリプトはこの二つのファイルを利用しています。そのため、tcsh など bash 以外のシェルを常用する場合でも、この二つのファイルがないと、kterm などで日本語入力ができなくなります。</para>
				<para>もし、ホームディレクトリに <filename>.bash_profile</filename> と <filename>.bashrc</filename> が存在しなかったり、両ファイルを大幅に書き換えている場合は、<filename class="directory">/etc/skel</filename> にVine 標準のものがありますから、それをコピーしてください。</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>問題のあるアプリケーションは? </term>
			<listitem>
				<para>全てのアプリケーションで入力・変換ができないのか、それとも特定のアプリケーションだけなのか、切り分ける事が重要です。</para>
				<para>日本語入力・変換が可能かどうか、複数のアプリケーションで確認してください。</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>エラーメッセージは出ていませんか?</term>
			<listitem>
				<para>日本語入力・変換をしたとき、何かエラーメッセージが出ませんでしたか。もし出ているならば、重要なヒントです。</para>
				<para>自力で解決できず、ML 等で尋ねる場合に備えて、メモを取るか、状況が許せば、コピー &amp; ペーストを利用してテキストファイルなどに保存しておくと良いでしょう。</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>kterm で日本語入力が出来ますか?</term>
			<listitem>
				<para>
					かな漢字変換システムの Canna や Wnn は、サーバ・クライアント方式を採用しています。サーバーはそれぞれ cannaserver と jserver です。
				</para>
				<para>クライアントについて言うと、Emacs は自前のかな漢字変換クライアントを持っていますが、kterm は kinput2 を利用します。また、kinput2 はほかの多くのアプリケーションでも日本語入力に利用されています。 </para>
				<para>Vine では最初から kterm と Emacs で日本語が使えるようになっています。</para>
				<para>
					そこで、kterm でなら日本語入力が出来るけれど、それ以外の特定のアプリケーションで日本語が使えないのなら、たぶんそのアプリケーションの問題です。日本語入力に対応していないのかもしれません。もっとよくあるのは、アプリケーションの設定が不適切な場合です。たとえば、/usr/X11R6/lib/X11/ja/app-defaults にあるリソースファイルで international、fontSet、inputMethod などの設定をしていないからということが考えられます。
				</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>Emacs で日本語入力ができますか?</term>
			<listitem>
				<para>
					Emacs で日本語入力が出来るのに、kterm では出来ないなら、kterm かkinput2 の問題です。kterm だけでなく、mozilla、sylpheed などでも日本語が使えないようなら、たぶん kinput2 の問題でしょう。
				</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>setime の状態は?</term>
			<listitem>
				<para>次のコマンドを実行します。</para>
				<screen>$ setime status</screen>
				<para>[現在の漢字入力システム]、[パッケージのインストール状況]、及び日本語変換に関係のある[環境変数]のいくつかを確認できます。</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>ログの内容は?</term>
			<listitem>
				<para>次のコマンドを実行してみて下さい。</para>
				<screen>$ less ~/.xwm.msgs</screen>
				<para>~/.xwm.msgs には、Vine の X 起動スクリプトが出すメッセージのうち、主に日本語入力関係のものが記録されています。かな漢字変換サーバが動いているかどうか、kinput2 の実行に成功しているかどうかがわかります。(参考:<xref linkend="pager" />)</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>プロセスの状態は?</term>
			<listitem>
				<para>念のため、以下のコマンドで状況を確認して下さい。</para>
				<example id="check-Canna-process">
					<title>Canna の場合</title>
<screen>$ ps axw | egrep 'cannaserver|kinput2'
934 ?        S      0:00 /usr/sbin/cannaserver
1127 tty1     S      0:00 kinput2 -canna -cannaserver localhost</screen>
				</example>
				<example id="check-Wnn-process">
					<title>Wnn の場合</title>
<screen>$ ps axw | egrep 'jserver|kinput2'
810 ?        S      0:00 /usr/bin/jserver
14973 pts/1    S      0:00 kinput2 -wnn -jserver localhost -wnnenvrc4 /etc/FreeWnn/ja/wnnenvrc</screen>
				</example>
				<para>上のような結果になれば、かな漢字変換サーバや kinput2 が動いています。結果が「ログの確認」と異なるときは、ネットワークに問題があることが疑われます。「ネットワーク設定の確認」の項を参照してください。</para>
				<para>かな漢字サーバが動作していない場合、その起動法については、<xref linkend="Start-Canna" />を見てください。 kinput2 が動作していない場合は、setime を使えば簡単に起動できます。</para>
<screen>$ setime canna
$ setime wnn</screen>
					<para>なお、コマンドラインで setime とだけ打ち込むと、使用法が表示されます。</para>
					<note>
						<para>setime は Vine Linux 独自のシェルスクリプトです。</para>
					</note>
				</listitem>
		</varlistentry>
		<varlistentry>
			<term>言語設定は?</term>
			<listitem>
				<para>次のコマンドの実行結果を確認して下さい。</para>
				<screen>$ echo $LANG</screen>
				<para>Vine の X 起動スクリプトは、環境変数 LANG が ja_JP.eucJP でないと、kinput2 を起動しないようになっています。<filename>/etc/sysconfig/i18n</filename> の内容をLANG="ja_JP.eucJP" に書き換えてください。</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>IMの確認</term>
			<listitem>
				<screen>$ echo $XMODIFIERS</screen>
				<para>kinput2 を使っている場合、結果が @im=kinput2 にならなかったら、ちょっと変です。Vine の X 起動スクリプトは、そうなるように書いてありますから(Vine 2.1.x は例外)。</para>
				<para>とりあえずの対処法は、<filename>~/.bash_profile</filename> に <screen>export XMODIFIERS="@im=kinput2"</screen> という行を書き込んで、ログインし直すことです。そのあとで、Vine の X  起動スクリプトを追ってみてください(テキストログインなら /etc/X11/xinit/xinitrc から、グラフィックログインなら  /etc/X11/wdm/Xsession などから)。どこかにおかしいところがあるのかもしれません。</para>
				<note>
					<title>VJE-Delta を使用している場合</title>
					<para>Vine 2.6 でVJE-Delta をご使用の方は、/usr/share/vine/imelib を見てください。XMODIfIERS="@im=vje" という行があるはずです。そこを XMODIFIERS="@im=vje" と修正してください。</para>
				</note>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>ネットワーク設定の確認</term>
			<listitem>
				<para>以下のコマンドの実行結果を確認して下さい。</para>
<screen>$ cat /etc/hosts
$ /sbin/ifconfig</screen>
				<para>Linux のかな漢字変換は、かな漢字変換サーバとクライアントとが通信し合うことで実現されています。そして、マシンが自分自身と通信するために使用するインターフェースが、ループバック・インターフェースなのです。</para>
				<para>ループバック・インターフェースは ifconfig では lo として表示され、そのアドレスが、127.0.0.1、ホスト名が localhost です。</para>
				<para>ですから、ifconfig の結果に lo の項目が表示されなければなりません。</para>
				<para>また、たいていの場合、/etc/hosts に <screen>127.0.0.1    localhost  localhost.localdomain</screen>といった行が存在する必要があります。</para>
				<para>ループバック・インターフェース lo の復活法については、<ulink url="http://vinelinux.org/faq.html#id2511091">Q: ifconfig を実行しても、lo の情報が表示されません。どうしたら、lo を復活させることが出来るでしょうか？</ulink>で説明しています。そちらをご覧ください。</para>
			</listitem>
		</varlistentry>
	</variablelist>
    <para>以上のことをやってみれば、問題点がかなり絞れるでしょう。うまくすると、解決してしまうかもしれません。もし、解決しなかった場合は、上に書いた検査の結果をつけて、vine-users ML で質問してみてください。</para>
</sect1>

<sect1 id="Start-Canna">
  <title>かな漢字変換サーバの起動</title>
  <para>かな漢字変換サーバを起動するには、ルートユーザになってから、以下のコマンドを実行します。</para>
  <example id="restart_Canna">
    <title>かな漢字変換システムが Canna の場合</title>
    <screen># /etc/rc.d/init.d/canna start</screen>
  </example>
  <example id="restart_FreeWnn">
    <title>かな漢字変換システムが FreeWnn の場合</title>
    <screen># /etc/rc.d/init.d/FreeWnn start</screen>
  </example>
  <para>ここでエラーメッセージが出るかもしれませんが、そのメッセージが解決の手がかりになります。</para>
  <para>
かな漢字変換サーバーをマシンの起動時から動くようにするには、以下のようにします。まず現在の状態を確かめてください。ここでは Canna を例に取ります。
  </para>
  <screen>
# /sbin/chkconfig --list canna
canna           0:off   1:off   2:off   3:off   4:off   5:off   6:off</screen>
  <para>上のようにすべて(とくに 3 と 5 が)off になっていたら、<screen># /sbin/chkconfig --add canna</screen>としてください。これでマシンの起動時からかな漢字変換サーバが動くようになります。</para>
  <para>FreeWnn を利用する場合、それぞれ canna を FreeWnn に置き換えて下さい。</para>
  <note>
    <para>
なお、Vine の X 起動スクリプトを使用している場合は(言い換えれば、X 起動スクリプトを自分で書いていない場合は)、かな漢字変換サーバが動いていれば、kinput2 は X を起動したときに自動的に実行されます。
    </para>
  </note>
</sect1>

</appendix>
