argra****@users*****
argra****@users*****
2011年 5月 26日 (木) 01:05:13 JST
Index: docs/modules/CGI-3.49/CGI.pod diff -u docs/modules/CGI-3.49/CGI.pod:1.2 docs/modules/CGI-3.49/CGI.pod:1.3 --- docs/modules/CGI-3.49/CGI.pod:1.2 Sat Feb 12 03:15:36 2011 +++ docs/modules/CGI-3.49/CGI.pod Thu May 26 01:05:13 2011 @@ -55,11 +55,9 @@ 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. +主な機能としては、フォームの処理、ファイルアップロード、クッキーの読み書き、 +クエリ文字列の生成と操作、HTML ヘッダの処理と準備などがあります。 いくつかの HTML 生成ユーリティティも含んでいます。 -(TBT) =begin original @@ -80,11 +78,10 @@ =end original -It has the benefit of having developed and refined over 10 years with input -from dozens of contributors and being deployed on thousands of websites. +数十人の貢献者によって 10 年以上開発と精製されてきたという利点があり、 +何千ものウェブサイトで使われています。 CGI.pm は Perl 5.4 から Perl 配布に含まれていて、デファクトスタンダードに なっています。 -(TBT) =head2 PROGRAMMING STYLE @@ -1544,12 +1541,13 @@ =end original -By default the CGI module implements a state-preserving behavior -called "sticky" fields. The way this works is that if you are +デフォルトでは CGI モジュールは "sticky" フィールドと呼ばれる、 +ステート保存の振る舞いを実装します。 +The way this works is that if you are regenerating a form, the methods that generate the form field values will interrogate param() to see if similarly-named parameters are -present in the query string. If they find a like-named parameter, they -will use it to set their default values. +present in the query string. +似たような名前のパラメータを見つけると、それをデフォルト値として使います。 (TBT) =begin original @@ -1560,10 +1558,9 @@ =end original -Sometimes this isn't what you want. The B<-nosticky> pragma prevents -this behavior. You can also selectively change the sticky behavior in -each element that you generate. -(TBT) +これがあなたの望んでいるものではない場合もあるでしょう。 +B<-nosticky> プラグマはこの振る舞いを抑制します。 +生成した要素毎に sticky な振る舞いを変更することもできます。 =item -tabindex @@ -1575,10 +1572,9 @@ =end original -Automatically add tab index attributes to each form field. With this -option turned off, you can still add tab indexes manually by passing a --tabindex option to each field-generating method. -(TBT) +フォームフィールドのそれぞれに自動的にタブインデックス属性を追加します。 +このオプションをオフにしても、それぞれのフィールド生成メソッドに +-tabindex オプションを渡すことで手動でタブインデックスを追加できます。 =item -no_undef_params @@ -2947,13 +2943,14 @@ =end original -If Apache's mod_rewrite is turned on, then the script name and path -info probably won't match the request that the user sent. Set +Apache の mod_rewrite が有効の場合、スクリプト名とパス情報はおそらく +ユーザーが送ったリクエストと一致しないでしょう。 +Set -rewrite=>1 (default) to return URLs that match what the user sent (the original request URI). Set -rewrite=>0 to return URLs that match -the URL after mod_rewrite's rules have run. Because the additional -path information only makes sense in the context of the rewritten URL, --rewrite is set to false when you request path info in the URL. +the URL after mod_rewrite's rules have run. +追加のパス情報は書き換えられたコンテキストでのみ意味があるので、 +URL のパス情報を要求する場合は -rewrite に偽を設定します。 (TBT) =back @@ -3406,7 +3403,8 @@ =end original -C<escapeHTML()> expects the supplied string to be a character string. This means you +C<escapeHTML()> は、与えられる文字列がテキスト文字列であることを仮定しています。 +This means you should Encode::decode data received from "outside" and Encode::encode your strings before sending them back outside. If your source code UTF-8 encoded and you want to upgrade string literals in your source to character strings, you @@ -3575,8 +3573,8 @@ =end original Note that autoEscape() is exclusively used to effect the behavior of how some -CGI.pm HTML generation fuctions handle escaping. Calling escapeHTML() -explicitly will always escape the HTML. +CGI.pm HTML generation fuctions handle escaping. +明示的に escapeHTML() を呼び出すと、常に HTML をエスケープします。 (TBT) =begin original @@ -3594,8 +3592,9 @@ multiple tags. In a scalar context, the tags will be concatenated together with spaces, or whatever is the current value of the $" global. In a list context, the methods will return a list of -elements, allowing you to modify them if you wish. Usually you will -not notice this behavior, but beware of this: +elements, allowing you to modify them if you wish. +普通はこの振る舞いに気付くことはないでしょうが、以下のようなものには +注意してください: (TBT) printf("%s\n",end_form()) @@ -3841,10 +3840,10 @@ =end original After starting a form, you will typically create one or more -textfields, popup menus, radio groups and other form elements. Each -of these elements takes a standard set of named arguments. Some -elements also have optional arguments. The standard arguments are as -follows: +textfields, popup menus, radio groups and other form elements. +これらの要素のそれぞれは標準セットの名前付き引数を取ります。 +要素によってはオプションの引数もあります。 +標準的な引数は以下のようなものです: (TBT) =over 4 @@ -3903,9 +3902,7 @@ =end original -A string identifier that can be used to identify this element to -JavaScript and DHTML. -(TBT) +要素を JavaScript や DHTML で識別するために使われる識別文字列。 =item B<-override> @@ -4225,7 +4222,8 @@ =end original -When the form is processed, you can retrieve an L<IO::Handle> compatibile +フォームを処理するときに、 +you can retrieve an L<IO::Handle> compatibile handle for a file upload field like this: (TBT) @@ -4333,12 +4331,13 @@ =end original -When processing an uploaded file, CGI.pm creates a temporary file on your hard -disk and passes you a file handle to that file. After you are finished with the -file handle, CGI.pm unlinks (deletes) the temporary file. If you need to you -can access the temporary file directly. You can access the temp file for a file -upload by passing the file name to the tmpFileName() method: -(TBT) +アップロードされたファイルを処理するときに、CGI.pm はハードディスクに +一時ファイルを作って、あなたにそのファイルのファイルハンドルを返します。 +あなたがファイルハンドルを使い終わった後、CGI.pm は一時ファイルを +削除します。 +もし必要なら、一時ファイルに直接アクセすることもできます。 +ファイルアップロードの一時ファイルには、tmpFileName() メソッドに +ファイル名を渡すことでアクセスできます: $filename = $query->param('uploaded_file'); $tmpfilename = $query->tmpFileName($filename); @@ -4352,11 +4351,11 @@ =end original -The temporary file will be deleted automatically when your program exits unless -you manually rename it. On some operating systems (such as Windows NT), you -will need to close the temporary file's filehandle before your program exits. -Otherwise the attempt to delete the temporary file will fail. -(TBT) +一時ファイルは、あなたが手動で名前を変えない限り、プログラムの終了時に +自動的に削除されます。 +(Windows NT のような)一部の OS では、プログラムの終了前に一時ファイルの +ファイルハンドルを閉じる必要があります。 +さもなければ一時ファイルの削除に失敗します。 =head3 Handling interrupted file uploads @@ -6396,10 +6395,10 @@ =end original -The user has pressed the submit button of a form. This event happens -just before the form is submitted, and your function can return a -value of false in order to abort the submission. Valid for: -(TBT) +ユーザーがフォームの送信ボタンを押しました。 +このイベントはフォームが送信される直前に起こり、送信を中断するために +偽の値を返すこともできます。 +有効なのは: + Forms only. @@ -6411,8 +6410,8 @@ =end original -The mouse has clicked on an item in a fill-out form. Valid for: -(TBT) +入力フォーjむのアイテムがクリックされました。 +有効なのは: + Buttons (including submit, reset, and image buttons) + Checkboxes @@ -6426,8 +6425,8 @@ =end original -The user has changed the contents of a field. Valid for: -(TBT) +ユーザーがフィールドの内容を変更しました。 +有効なのは: + Text fields + Text areas @@ -6444,8 +6443,8 @@ =end original -The user has selected a field to work with. Valid for: -(TBT) +ユーザーがフィールドを選択しました。 +有効なのは: + Text fields + Text areas @@ -6463,9 +6462,8 @@ =end original -The user has deselected a field (gone to work somewhere else). Valid -for: -(TBT) +ユーザーがフィールドから離れました(ほかのものを選択しました)。 +有効なのは: + Text fields + Text areas @@ -6483,9 +6481,8 @@ =end original -The user has changed the part of a text field that is selected. Valid -for: -(TBT) +ユーザーが選択していたテキストフィールドの一部を変更しました。 +有効なのは: + Text fields + Text areas @@ -6500,8 +6497,7 @@ =end original -The mouse has moved over an element. -(TBT) +マウスが要素の上に移動しました。 + Text fields + Text areas