Namazu-devel-ja(旧)


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: LANGUAGE 環境変数 (was Re: 2.0.6rc2)



>                                            千葉市中央区長洲
>                                                    藤原  誠
一応 patch を作って見ました。

commit はしていません。平文でお送りします。

Index: namazu/doc/ja/tutorial.html
===================================================================
RCS file: /storage/cvsroot/namazu/doc/ja/tutorial.html,v
retrieving revision 1.44.4.2
diff -u -r1.44.4.2 tutorial.html
--- namazu/doc/ja/tutorial.html	2001/07/11 23:58:33	1.44.4.2
+++ namazu/doc/ja/tutorial.html	2001/07/14 12:40:43
@@ -265,20 +265,73 @@
 </ul>
 
 <h2><a name="japanese">日本語環境での利用</a></h2>
+日本語の表示や、日本語の資料の索引を作るというような場合、
+Namazu 2.0.5 と Namazu 2.0.6 では少し変更があります。
+<p>
+2.0.5 
+では次の二つの設定(切換)を同じ変数で行っていました。
+
+<table cellspacing=0 cellpadding=3 border=0>
+<tr><td>【表示】</td><td> 様々な表示を何語にするか</td></tr>
 
+<tr><td>【処理】</td><td>
+索引 (index) を作る時、
+つまり mknmz を実行する時に何語として処理するか</td></tr>
+</table>
 <p>
-Namazu 2.0 を日本語環境で利用するには<code>環境変数
-LANG</code>の設定が必要です。Windows では ja_JP.SJIS と設定
-します。UNIX では <code>ja</code>, <code>ja_JP.eucJP</code>,
-<code>ja_JP.EUC</code>, <code>ja_JP.ujis</code>などを設定し
-ます。適切な設定はシステムによって異なります。もしわからない
-場合は <code>ja</code> を設定してください。
-</p>
+2.0.6 ではこれらの切換は、
+別の環境変数で行なわれます。
+<table cellspacing=0 cellpadding=3 border=1>
+<tr><td>【表示】</td>
+<td>NMZ_MESSAGES</td>
+<td>LANGUAGE</td>
+<td>LC_ALL</td>
+<td>LC_MESSAGE</td>
+<td>LANG</td></tr>
+<tr><td>【処理】</td>
+<td>NMZ_CTYPE</td>
+<td><br></td>
+<td>LC_ALL</td>
+<td> LC_CTYPE</td>
+<td>LANG</td></tr>
+</table>
+<p>
+それぞれ、以上に書いてある環境変数を
+(左から調べて)見て、
+それに何かが設定してあれば、その内容(変数の値)を使って切換えます。
+<p>
+日本語の表示が欲しい時や、日本語の処理をしたい時には、
+これらの変数に、
+<table cellspacing=0 cellpadding=3>
+<tr><td>Unix OS</td><td>ja</td></tr>
+<tr><td>Windows</td><td>ja_JP.SJIS</td></tr>
+</table>
+等と設定します。例えば次のような方法で 
+<p>
+<table cellspacing=0 cellpadding=3 border=1>
+<tr><td>csh 等</td><td>Bourn shell 等</td></tr>
+<tr><td><code>setenv LANG ja</code></td>
+<td><code>LANG=ja; export LANG</code></td></tr>
+</table>
+<p>
+LANG に ja を設定し、
+それ以外の変数に何も設定されていなければ、
+全て日本語の表示・処理になります。
+実際には設定されている値の文字列が 
+<code>ja/en/fr/es </code>
+などで始まっていればそれだけで設定され、
+後の字は無視されます。
+
+<code>ja</code> という値が適当でない時には
+<code>ja_JP.eucJP</code>,
+<code>ja_JP.EUC</code>, <code>ja_JP.ujis</code>
+などという値が必要とされる場合(システム)もあります。
 
+もし疑問のある場合には pl/util.pl を参照されるのも一方法です。
 
 <h2><a name="before-make-install">make install 前の確認</a></h2>
-<p>
-もし make install する前に mknmz を試してみたいという時には
+make が終了したが、その後で
+make install する前に mknmz を試してみたいという時には
 cd scripts してから ./mknmz と実行すると、
 (<code>/usr/local/share/namazu</code> でなく)
 すぐ隣にある ../pl/*.pl を参照します。
@@ -312,6 +365,8 @@
   <tr><td><code>--help</code></td><td>詳しい説明 <td>(他の引数・選択は無視される)</td></tr>
   <tr><td><code>-C </code>   </td><td>その時の構成<td> (他の引数・選択も意味がある)</td></tr>
   </table>
+-C を付ける場合、その -C を指定した左側までの設定が表示されるので、
+通常は -C は最後に付けます。
 
 <h2><a name="run-mknmz">動作確認 mknmz</a></h2>
 <p>
Index: namazu/doc/en/tutorial.html
===================================================================
RCS file: /storage/cvsroot/namazu/doc/en/tutorial.html,v
retrieving revision 1.9.4.3
diff -u -r1.9.4.3 tutorial.html
--- namazu/doc/en/tutorial.html	2001/07/11 23:58:34	1.9.4.3
+++ namazu/doc/en/tutorial.html	2001/07/14 12:40:45
@@ -270,18 +270,70 @@
 </ul>
 
 <h2><a name="japanese">Japanese Environment</a></h2>
-
+We have changes from 2.0.5 to 2.0.6 for Japanese Langage
+related behavior.
+<p>
+With version 2.0.5, we had only one switch on language
+for following two behavior.
+<table cellspacing=0 cellpadding=3 border=1>
+<tr><td>Messages</td>
+<td>help, warning, errors etc for various situation</td></tr>
+<tr>
+<td>Indexing</td>
+<td>segmentation at processing mknmz to generate index</td></tr>
+</table>
 <p>
-You will need to set up <code>LANG</code> environment
-variable to use Namazu 2.0 under Japanese environment. For
-Windows, LANG is set to ja_JP.SJIS. For Unix, LANG is set to
-<code>ja</code>, <code>ja_JP.eucJP</code>,
-<code>ja_JP.EUC</code>, or <code>ja_JP.ujis</code>. The
-appropriate LANG will depends on your system. If you have no
-clues, just set LANG to <code>ja</code>.
-</p>
+With version 2.0.6, these swithes will be done separately.
 
+<table cellspacing=0 cellpadding=3 border=1>
+<tr><td>Messages</td>
+<td>NMZ_MESSAGES</td>
+<td>LANGUAGE</td>
+<td>LC_ALL</td>
+<td>LC_MESSAGE</td>
+<td>LANG</td></tr>
+<tr><td>Indexing</td>
+<td>NMZ_CTYPE</td>
+<td><br></td>
+<td>LC_ALL</td>
+<td> LC_CTYPE</td>
+<td>LANG</td></tr>
+</table>
+<p>
+On above table, listed environmental variable are
+inspected from left to the right, and anything no blank
+set on the variable, the switch is made.
+<p>
+The typical example to process Japanese is to set
+following values, depending on your system environment.
+<table cellspacing=0 cellpadding=3>
+<tr><td>Unix OS</td><td>ja</td></tr>
+<tr><td>Windows</td><td>ja_JP.SJIS</td></tr>
+</table>
+<p>
+The actual command to set value may depend the shell,
+<p>
+<table cellspacing=0 cellpadding=3 border=1>
+<tr><td>csh etc</td><td>Bourn shell etc</td></tr>
+<tr><td><code>setenv LANG ja</code></td>
+<td><code>LANG=ja; export LANG</code></td></tr>
+</table>
+<p>
+With above example, value(ja) is set for LANG,
+and all the processing will be for Japanese.
+Some system may require
+<code>ja_JP.eucJP</code>,
+<code>ja_JP.EUC</code>, <code>ja_JP.ujis</code>
+instead of just <code>ja</code>.
 
+<p>
+Namazu internal processing will honor only beginning
+characters of the value, and if one of
+<code>ja/en/fr/es</code>
+is set, the switch is made and remaining characters
+will be ignored.
+<p>
+Refer pl/util.pl if you have question on this part.
 <h2><a name="before-make-install">Test before "make install"</a></h2>
 <p>
 If you wish to test <code>mknmz</code> before <code>make
Index: namazu/pl/util.pl
===================================================================
RCS file: /storage/cvsroot/namazu/pl/util.pl,v
retrieving revision 1.22.4.1
diff -u -r1.22.4.1 util.pl
--- namazu/pl/util.pl	2001/07/11 12:13:44	1.22.4.1
+++ namazu/pl/util.pl	2001/07/14 12:40:46
@@ -214,13 +214,13 @@
 }
 
 sub set_lang () {
-    for my $cand (("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LANG")) {
+    for my $cand (qw(NMZ_MESSAGES LANGUAGE LC_ALL LC_MESSAGES LANG)) {
 	if (defined($ENV{$cand})) {
 	    $LANG_MSG = $ENV{$cand};
 	    last;
 	}
     }
-    for my $cand (("LC_ALL", "LC_CTYPE", "LANG")) {
+    for my $cand (qw(NMZ_CTYPE LC_ALL LC_CTYPE LANG)) {
 	if (defined($ENV{$cand})) {
 	    $LANG = $ENV{$cand};
 	    last;

---
(藤原)
http://www.ki.nu/software/namazu/tutorial/