From 09423b30d69cb17b3ea403b340bb472bc00d1a09 Mon Sep 17 00:00:00 2001 From: Yoshiki Hayashi Date: Fri, 28 Nov 2003 22:26:13 +0000 Subject: [PATCH] Update Japanese translations. Submitted by: Hiroaki KAWAI Reviewed by: Yoshiki Hayashi git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@101915 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/howto/cgi.xml.ja | 160 ++++++++++++++++++++--------------- docs/manual/howto/ssi.xml.ja | 3 +- 2 files changed, 94 insertions(+), 69 deletions(-) diff --git a/docs/manual/howto/cgi.xml.ja b/docs/manual/howto/cgi.xml.ja index f73a30d61f..0503f930e6 100644 --- a/docs/manual/howto/cgi.xml.ja +++ b/docs/manual/howto/cgi.xml.ja @@ -2,7 +2,8 @@ - + + How-To / チュートリアル Apache Tutorial: CGI による動的コンテンツ @@ -12,15 +13,12 @@ mod_alias - mod_cgi AddHandler - Options - ScriptAlias @@ -55,19 +53,23 @@

ScriptAlias ディレクティブは以下のように使用します:

- ScriptAlias /cgi-bin/ /usr/local/apache/cgi-bin/ + + ScriptAlias /cgi-bin/ /usr/local/apache/cgi-bin/ +

デフォルト位置に Apache をインストールしたならば、 この例はデフォルト状態の httpd.conf - 設定ファイルに含まれています。ScriptAlias + 設定ファイルに含まれています。 + ScriptAlias ディレクティブは、URL の前に付加するディレクトリを定義する - Alias ディレクティブとかなり似ています。 - Alias と ScriptAlias は通常、 - DocumentRoot + Alias + ディレクティブとかなり似ています。 + Alias と ScriptAlias + は通常、DocumentRoot ディレクトリ外のディレクトリのために使用されます。 - Alias と ScriptAlias との差は、 - ScriptAlias が接頭辞で始まるすべての URL は - CGI プログラムとみなされるという追加の意味を含んでいることです。 + Alias と ScriptAlias + との差は、ScriptAlias が接頭辞で始まるすべての + URL は CGI プログラムとみなされるという追加の意味を含んでいることです。 従って、上記の例では、/cgi-bin/ で始まるリソースへのあらゆるリクエストに対して、ディレクトリ /usr/local/apache/cgi-bin/ から提供し、それらを @@ -84,13 +86,14 @@

ScriptAlias ディレクトリ外の CGI -

CGI プログラムは、セキュリティ上の理由から ScriptAlias +

CGI プログラムは、セキュリティ上の理由から + ScriptAlias されたディレクトリに制限されることがしばしばあります。この方法により、 CGI プログラムを使用できるユーザを管理者が厳しく制御することができます。 しかしながら、適切なセキュリティ事前対策がとられるならば、CGI プログラムを任意のディレクトリで実行できないようにする理由はありません。 - 例えば、ユーザに UserDir ディレクティブで - 彼らのホームディレクトリ配下にウェブコンテンツを持たせたいとします。 + 例えば、ユーザに UserDir + ディレクティブで彼らのホームディレクトリ配下にウェブコンテンツを持たせたいとします。 もし、彼らが CGI プログラムを持つことを望んでいても、メインの cgi-bin ディレクトリへのアクセスができない場合、 CGI プログラムを実行することができる他の場所が必要になります。

@@ -99,48 +102,61 @@
CGI の実行を可能にするために Options を明示的に使用する -

サーバのメインの設定ファイル中で Options +

サーバのメインの設定ファイル中で Options ディレクティブを明示的に使用することで、特定のディレクトリ配下で CGI の実行を許可するように指定することができます:

- <Directory /usr/local/apache/htdocs/somedir>
- Options +ExecCGI
- </Directory> + + <Directory /usr/local/apache/htdocs/somedir>
+ + Options +ExecCGI
+ + </Directory> +

上記ディレクティブは、CGI ファイルの実行を可能にするよう Apache に伝えます。また、どのファイルが CGI ファイルかを - サーバに伝える必要があります。次の AddHandler + サーバに伝える必要があります。次の + AddHandler ディレクティブの例では、cgi または pl を拡張子に持つすべてのファイルを CGI プログラムとしてみなすことをサーバに伝えます:

- AddHandler cgi-script cgi pl + + AddHandler cgi-script cgi pl +
.htaccess files -

.htaccess - ファイルは、ディレクトリ毎にディレクティブを指定する方法です。 +

.htaccess + ファイルは、ディレクトリ毎にディレクティブを指定する方法です。 Apache は、リソースを提供するときに、 提供するファイルが置かれているディレクトリ中の .htaccess というファイルを参照します。そのファイルを発見したら、 その中で発見されたディレクティブが適用されます。 - .htaccess ファイルは、AllowOverride + + .htaccess ファイルは、 + AllowOverride ディレクティブの指定により使えるようになります。 - AllowOverride ディレクティブは、.htaccess - ファイルで設定できるディレクティブのタイプを指定します。 - AllowOverride ディレクティブの指定がない場合、 - まったく使えません。CGI の実行を許可するために必要となる - ディレクティブを指定可能にするには、 - 以下の設定がサーバのメインの設定で必要になります:

+ AllowOverride + ディレクティブは、.htaccess + ファイルで、どのタイプのディレクティブが設定できるか、 + あるいは全く指定できないかを指定します。 + この目的に必要になるディレクティブを使用できるようにするには、 + サーバのメインの設定で、以下の設定が必要になります:

- AllowOverride Options + + AllowOverride Options +

.htaccess ファイルでは、次のディレクティブが必要となります:

- Options +ExecCGI + + Options +ExecCGI +

この設定では、このディレクトリにおける CGI プログラムの実行を許可するよう Apache に伝えます。

@@ -158,7 +174,9 @@ これはどのような種類のコンテンツを受け取っているかをクライアントに示す HTTP ヘッダです。ほとんどの場合では、次のように出力します:

- Content-type: text/html + + Content-type: text/html +

もう一つは、出力を HTML か、ブラウザが表示することができる何か他の形式にする必要があります。 @@ -176,9 +194,10 @@ というファイルに保存し、それを cgi-bin ディレクトリに置いてください。

- #!/usr/bin/perl
- print "Content-type: text/html\n\n";
- print "Hello, World."; + + #!/usr/bin/perl
+ print "Content-type: text/html\n\n";
+ print "Hello, World.";

Perl に精通していなくても、 @@ -189,12 +208,14 @@ 示します。2 行目は、前述したとおり content-type の定義を印字します。 これには復帰改行の二つの組を後に付加します。 これにより、ヘッダの終りに空行が置かれ、HTTP - ヘッダの終りとボディの始まりを示します。3 行目は、``Hello, World.'' + ヘッダの終りとボディの始まりを示します。3 行目は、"Hello, World." という文字列を印字し、これで終りとなります。

好みのブラウザを開き、アドレス

- http://www.example.com/cgi-bin/first.pl + + http://www.example.com/cgi-bin/first.pl +

あるいはファイルを置いたロケーションを指定すると、 Hello, World. @@ -213,13 +234,10 @@

CGI プログラムの出力
- -
素晴らしい ! それはすべてがうまく動いたことを意味します。 -
+
素晴らしい ! それはすべてがうまく動いたことを意味します。
CGI プログラムのソースコード、または "POST Method Not Allowed" というメッセージ
-
これは、CGI プログラムを処理できるよう Apache を適切に設定していなかったことを意味します。「CGI を許可するように @@ -228,7 +246,6 @@
メッセージが "Forbidden" で始まっている
-
これはパーミッションの問題ということを意味します。 Apache のエラーログと、後述の「ファイルのパーミッション」 @@ -236,7 +253,6 @@
"Internal Server Error" というメッセージ
-
Apache のエラーログをチェックすると、"Premature end of script headers" というログが記録されていると思います。そして、おそらく CGI @@ -250,13 +266,15 @@ ファイルのパーミッション

サーバはあなたの権限で実行されていないのを忘れないように。 - つまり、起動するとき、サーバは特権をもたないユーザ - 通常 ``nobody'' - や ``www'' の権限で実行されます。したがって、あなたが所有する + つまり、起動するとき、サーバは特権をもたないユーザ - 通常 nobody + や www の権限で実行されます。したがって、あなたが所有する ファイルを実行するには別のパーミッションが必要となります。 - 通常、``nobody'' が実行するのに十分なパーミッションを与える方法は、 + 通常、nobody が実行するのに十分なパーミッションを与える方法は、 ファイルに誰でも実行可能とするパーミッションを与えることです:

- chmod a+x first.pl + + chmod a+x first.pl +

また、もしあなたのプログラムが他のファイルを読み書きするならば、 それらのファイルは、これが可能となる正しいパーミッション @@ -291,7 +309,9 @@

同様なことは、スクリプトのインタプリタ (しばしば perl) へのパスで、CGI プログラムの 1 行目に次のように示されます:

- #!/usr/bin/perl + + #!/usr/bin/perl +

これがインタープリタへの実際のパスであることを確実にしておきます。

@@ -323,11 +343,11 @@
裏で何が起こっているのか? -

CGI プログラミングに熟達すると、 - 裏で起こっていることについて更に理解することは有益になるでしょう。 +

CGI プログラミングに習熟すると、 + 裏で起こっていることについて更に理解すること役に立ちます。 ブラウザとサーバがどのように相互通信するかについては特にそうです。 - なぜなら、``Hello, World.'' - を印字するプログラムを書くことはまことに結構ですが、 + なぜなら、"Hello, World." + を印字するプログラムを書くことはおおいに結構ですが、 それは特に有益ではありません。

@@ -338,16 +358,16 @@ それらは、パス (コマンドをタイプしたときに実行する実際のファイルを探し出すところ)、 ユーザ名、端末型などのような便利なものです。 - 通常の、毎日の環境変数の完全なリストを調べるには、コマンドプロンプトで - env を入力します。

+ 通常、普段使用している環境変数の完全なリストを調べるには、 + コマンドプロンプトで env を入力します。

CGI の処理中、サーバとブラウザも環境変数を設定し、 それにより相互に通信することができるようになります。 その環境変数は、ブラウザタイプ (Netscape, IE, Lynx)、サーバタイプ (Apache, IIS, WebSite)、実行されている CGI - プログラムの名前などのようなものです。

+ プログラムの名前などです。

-

これらの変数は CGI プログラマが使用することができます。 +

これらの変数は CGI プログラマが使用できます。 そして、それはクライアントとサーバの通信の話の半分です。 必要な変数の完全なリストは - #!/usr/bin/perl
- print "Content-type: text/html\n\n";
- foreach $key (keys %ENV) {
- print "$key --> $ENV{$key}<br>";
- } + #!/usr/bin/perl
+ print "Content-type: text/html\n\n";
+ foreach $key (keys %ENV) {
+ + print "$key --> $ENV{$key}<br>";
+ + } +

@@ -394,7 +417,7 @@

- name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey + name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey

時々、このような文字列が URL @@ -420,22 +443,23 @@

Perl で CGI プログラムを書いているなら、モジュールは CPAN で提供されています。 - この目的のための最も普及しているモジュールは CGI.pm です。 - CGI::Lite も検討しましょう。これは、ほとんどのプログラム + この目的のための最も普及しているモジュールは CGI.pm です。 + CGI::Lite も検討しましょう。これは、ほとんどのプログラム において必要とするすべての機能の最小セットの実装です。

C で CGI プログラムを書いているなら、いろいろな オプションがあります。これらの内の一つは http://www.boutell.com/cgic/ - で提供されている CGIC ライブラリです。

+ で提供されている CGIC ライブラリです。

更なる情報

CGI に関する情報はウェブで数多く提供されています。CGI - の問題については Usenet の comp.infosystems.www.authoring.cgi - で、他のユーザと論議することができます。HTML Writers Guide の + の問題については Usenet の comp.infosystems.www.authoring.cgi で、 + 他のユーザと論議することができます。HTML Writers Guide の -servers メーリングリストは、あなたの質問に回答してくれる偉大なリソースです。 http://www.hwg.org/lists/hwg-servers/ diff --git a/docs/manual/howto/ssi.xml.ja b/docs/manual/howto/ssi.xml.ja index f1b962d051..f8ffb6d3df 100644 --- a/docs/manual/howto/ssi.xml.ja +++ b/docs/manual/howto/ssi.xml.ja @@ -2,7 +2,8 @@ - +How-To / チュートリアル + Apache チュートリアル: Server Side Includes 入門 -- 2.40.0