argra****@users*****
argra****@users*****
2011年 2月 12日 (土) 03:15:36 JST
Index: docs/modules/CGI-3.49/CGI.pod
diff -u docs/modules/CGI-3.49/CGI.pod:1.1 docs/modules/CGI-3.49/CGI.pod:1.2
--- docs/modules/CGI-3.49/CGI.pod:1.1 Mon Jul 26 05:07:14 2010
+++ docs/modules/CGI-3.49/CGI.pod Sat Feb 12 03:15:36 2011
@@ -53,11 +53,12 @@
=end original
-CGI.pm is a stable, complete and mature solution for processing and preparing
-HTTP requests and responses. Major features including processing form
+CGI.pm は、HTML リクエストとレスポンスを処理したり準備したりするための、
+安定しており、完全で、枯れているソリューションです。
+Major features including processing form
submissions, file uploads, reading and writing cookies, query string generation
-and manipulation, and processing and preparing HTTP headers. Some HTML
-generation utilities are included as well.
+and manipulation, and processing and preparing HTTP headers.
+いくつかの HTML 生成ユーリティティも含んでいます。
(TBT)
=begin original
@@ -67,9 +68,8 @@
=end original
-CGI.pm performs very well in in a vanilla CGI.pm environment and also comes
-with built-in support for mod_perl and mod_perl2 as well as FastCGI.
-(TBT)
+CGI.pm は CGI.pm 単体の環境でとてもよく機能し、
+mod_perl や mod_perl2 および FastCGI 対応も内蔵しています。
=begin original
@@ -1631,11 +1631,9 @@
=end original
これは、CGI.pm が全てのパラメータを UTF-8 文字列として扱うようにします。
-Use this with
-care, as it will interfere with the processing of binary uploads. It
-is better to manually select which fields are expected to return utf-8
-strings and convert them using code like this:
-(TBT)
+これはバイナリアップロードの邪魔となるので、注意して使ってください。
+どのフィールドが utf-8 文字列を返すと想定されるかを自分で選択して、
+それを以下のようなコードで変換した方がよいです:
use Encode;
my $arg = decode utf8=>param('foo');
@@ -2171,10 +2169,9 @@
=end original
-The B<-p3p> parameter will add a P3P tag to the outgoing header. The
-parameter can be an arrayref or a space-delimited string of P3P tags.
-For example:
-(TBT)
+B<-p3p> パラメータは、出力ヘッダに P3P タグを追加します。
+引数は、P3P タグの、配列リファレンスか空白区切りの文字列です。
+例えば:
print header(-p3p=>[qw(CAO DSP LAW CURa)]);
print header(-p3p=>'CAO DSP LAW CURa');
@@ -2302,9 +2299,8 @@
=end original
-The B<-status> parameter will set the status of the redirect. HTTP
-defines three different possible redirection status codes:
-(TBT)
+B<-status> パラメータはリダイレクトするステータスを設定します。
+HTTP ではリダイレクトステータスコードとして三つの値を定義しています:
301 Moved Permanently
302 Found
@@ -3935,9 +3931,8 @@
=end original
-These are used to assign JavaScript event handlers. See the
-JavaScripting section for more details.
-(TBT)
+これらは JavaScript イベントハンドラを割り当てるために使われます。
+更なる詳細については JavaScript の章を参照してください。
=back
@@ -3949,10 +3944,8 @@
=end original
-Other common arguments are described in the next section. In addition
-to these, all attributes described in the HTML specifications are
-supported.
-(TBT)
+その他の一般的な引数は次の章で記述されています。
+これらに加えて、HTML 仕様で技術されている全ての属性に対応しています。
=head2 CREATING A TEXT FIELD
@@ -4219,8 +4212,12 @@
=head2 PROCESSING A FILE UPLOAD FIELD
+(ファイルアップロードフィールドの処理)
+
=head3 Basics
+(基本)
+
=begin original
When the form is processed, you can retrieve an L<IO::Handle> compatibile
@@ -4263,8 +4260,7 @@
=end original
-If you want the entered file name for the file, you can just call param():
-(TBT)
+入力されたファイル名がほしい場合は、単に param() を呼び出します:
$filename = $q->param('field_name');
@@ -4447,9 +4443,8 @@
=end original
-The C<< $data >> field is optional; it lets you pass configuration
-information (e.g. a database handle) to your hook callback.
-(TBT)
+C<< $data >> フィールドはオプションです; これにより、フックした
+コールバックに設定情報 (データベースハンドルなど) を渡せます。
=begin original
@@ -4475,9 +4470,8 @@
=end original
-If using the function-oriented interface, call the CGI::upload_hook()
-method before calling param() or any other CGI functions:
-(TBT)
+関数指向インターフェースを使う場合は、param() はその他の CGI 関数を
+呼び出す前に CGI::upload_hook() を呼び出します:
CGI::upload_hook(\&hook [,$data [,$use_tempfile]]);
@@ -4488,12 +4482,14 @@
=end original
-This method is not exported by default. You will have to import it
-explicitly if you wish to use it without the CGI:: prefix.
-(TBT)
+このメソッドはデフォルトではエクスポートされません。
+これを CGI:: 接頭辞なしで使いたいなら、明示的にインポートする必要が
+あります。
=head3 Troubleshooting file uploads on Windows
+(Windows でのファイルアップロードのトラブルシューティング)
+
=begin original
If you are using CGI.pm on a Windows platform and find that binary
@@ -4504,11 +4500,11 @@
=end original
-WindowsプラットホームでCGI.pmを使っていて、バイナリファイルがバイナリファイルは
+Windows プラットホームで CGI.pm を使っていて、バイナリファイルは
少し大きくなるのに、テキストファイルは同じままであることを発見したならば、
あなたは出力のファイルにバイナリモードを有効にすることを忘れています。
アップロードされたファイルをディスクに書き出すための全てのハンドルに
-binmode()を確実に呼び出してください。
+binmode() を確実に呼び出してください。
=head3 Older ways to process file uploads
@@ -5520,9 +5516,8 @@
=end original
-The optional B<-labelattributes> argument will contain attributes
-attached to the <label> element that surrounds each button.
-(TBT)
+オプションの B<-labelattributes> 引数は、それぞれのボタンを囲む
+<label> 要素に付加される属性を指定します。
=begin original
@@ -6191,9 +6186,8 @@
=end original
-If you call cookie() without any parameters, it will return a list of
-the names of all cookies passed to your script:
-(TBT)
+引数なしで cookie() を呼び出すと、スクリプトに渡された全てのクッキーの
+名前のリストが返されます:
@cookies = cookie();
@@ -6222,7 +6216,7 @@
CGI.pm スクリプトでは HTML4 フレーム機能を使って、たくさんのブラウザパネルと
ウィンドウに書き込むことができます。
プログラム的に新しいフレームを定義する
-ためには 3 つのテクニックがあります:
+ためには三つのテクニックがあります:
=over 4
@@ -6376,8 +6370,7 @@
=end original
-The browser is loading the current document. Valid in:
-(TBT)
+ブラウザは現在のドキュメントを読み込んでいます。有効なのは:
+ The HTML <BODY> section only.
@@ -6389,8 +6382,7 @@
=end original
-The browser is closing the current page or frame. Valid for:
-(TBT)
+ブラウザは現在のページ又はフレームを閉じようとしています。有効なのは:
+ The HTML <BODY> section only.
@@ -6526,8 +6518,7 @@
=end original
-The mouse has moved off an element.
-(TBT)
+マウスが要素から外れました。
+ Text fields
+ Text areas
@@ -6592,9 +6583,8 @@
=end original
-See the javascript.cgi script for a demonstration of how this all
-works.
-(TBT)
+これら全てがどのように働くかの例については javascript.cgi スクリプトを
+参照してください。
=head1 LIMITED SUPPORT FOR CASCADING STYLE SHEETS
@@ -6763,8 +6753,7 @@
=end original
-This will generate an HTML header that contains this:
-(TBT)
+これは、以下のものを含む HTML ヘッダを生成します:
<link rel="stylesheet" type="text/css" href="/server-common/css/core.css">
<style type="text/css">
@@ -6778,9 +6767,8 @@
=end original
-Any additional arguments passed in the -style value will be
-incorporated into the <link> tag. For example:
-(TBT)
+-style に渡される追加引数は <link> タグと関連づけられます。
+例えば:
start_html(-style=>{-src=>['/styles/print.css','/styles/layout.css'],
-media => 'all'});
@@ -6791,8 +6779,7 @@
=end original
-This will give:
-(TBT)
+これは以下のようになります:
<link rel="stylesheet" type="text/css" href="/styles/print.css" media="all"/>
<link rel="stylesheet" type="text/css" href="/styles/layout.css" media="all"/>
@@ -6804,7 +6791,6 @@
=end original
<p>
-(TBT)
=begin original
@@ -6813,9 +6799,8 @@
=end original
-To make more complicated <link> tags, use the Link() function
-and pass it to start_html() in the -head argument, as in:
-(TBT)
+より複雑な <link> タグを作るには、以下のように、Link() 関数を使って、
+それを start_html() の -head 引数として渡してください:
@h = (Link({-rel=>'stylesheet',-type=>'text/css',-src=>'/ss/ss.css',-media=>'all'}),
Link({-rel=>'stylesheet',-type=>'text/css',-src=>'/ss/fred.css',-media=>'paper'}));
@@ -6827,8 +6812,8 @@
=end original
-To create primary and "alternate" stylesheet, use the B<-alternate> option:
-(TBT)
+主スタイルシートと「代替」スタイルシートを作るには、
+B<-alternate> オプションを使います:
start_html(-style=>{-src=>[
{-src=>'/styles/print.css'},
@@ -7253,9 +7238,8 @@
=end original
-Like server_port() except that it takes virtual hosts into account.
-Use this when running with virtual hosts.
-(TBT)
+server_port() と似ていますが、これは仮想ホストも考慮に入れます。
+仮想ホストで実行しているときに使ってください。
=item B<server_software ()>