Commit b15fe983 authored by Andre Malo's avatar Andre Malo
Browse files

update transformation 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@151033 13f79535-47bb-0310-9956-ffa450edef68
parent 30540b73

docs/manual/mod/core.html.ja.euc-jp

+87 −71
Changes for docs/manual/mod/core.html.ja.euc-jp: 87 added lines, 71 removed lines.
Original line number Diff line number Diff line
@@ -25,8 +25,6 @@ 
<a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |

<a href="../ja/mod/core.html" title="Japanese">&nbsp;ja&nbsp;</a></p>

</div>

<div class="outofdate">This translation may be out of date. Check the

            English version for recent changes.</div>

<table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>常に使用可能な Apache HTTP サーバのコア機能</td></tr>

<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Core</td></tr></table>

</div>
@@ -201,8 +199,8 @@ 
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">ディレクティブ</a></h2>

<table class="directive">

<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>明示的に文字セットを指定していない応答に追加される

デフォルトの文字セット</td></tr>

<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>レスポンスのコンテントタイプが <code>text/plain</code> あるいは

<code>text/html</code> の場合に追加するデフォルトの charset パラメータ</td></tr>

<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>

<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AddDefaultCharset Off</code></td></tr>

<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
@@ -210,19 +208,41 @@ 
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>

<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>

</table>

    <p>このディレクティブは、HTTP ヘッダにコンテントタイプパラメータを

    持たない応答に追加される文字セットの名前を指定します。

    これは、ドキュメント内の META タグで指定されたどのような文字セット

    も無効にします。

    <code>AddDefaultCharset Off</code> という設定により、この機能は無効になります。

    <code>AddDefaultCharset On</code> にすれば、ディレクティブの要求通り

    Apache 内部のデフォルト文字セット <code>iso-8859-1</code> に設定します。

    また、他の <var>charset</var> も指定できます。例えば:</p>

    <p>レスポンスのコンテントタイプが <code>text/plain</code> 

    あるいは <code>text/html</code> 

    の場合に限りますが、レスポンスに追加するメディアタイプの文字セットパラメータ

    (文字エンコーディングの名前) のデフォルト値を、このディレクティブで指定します。

    これはレスポンス <span class="transnote">(<em>訳注:</em> レスポンスの HTML)</span> 内で <code>META</code> 

    要素で指定された、どのような文字セットも無効にしますが、

    最終的な挙動はユーザのクライアント側の設定で決まります。

    この機能は <code>AddDefaultCharset Off</code> という設定で無効になります。

    <code>AddDefaultCharset On</code> にすれば、

    Apache 内部のデフォルト文字セット <code>iso-8859-1</code> に設定されます。

    その他 <var>charset</var> に指定できる値であれば、どんな値でも使えます。

    指定する値は、MIME メディアタイプとして使われる

    <a href="http://www.iana.org/assignments/character-sets">IANA 

    に登録されている文字セット名</a>のうちの一つにすべきです。

    例えば:</p>



    <div class="example"><p><code>

      AddDefaultCharset utf-8

    </code></p></div>



    <p><code class="directive">AddDefaultCharset</code> を使うときは、全てのテキストリソースが

    指定する文字エンコードになっていると分かっていて、かつ、

    リソースの個々に文字セットを指定するのが大変な場合のみです。

    例を挙げると、レガシーな CGI スクリプトなどの、動的に生成される

    コンテンツを含むリソースに文字セットパラメータを追加する場合で、

    ユーザの入力データが出力に入り、クロスサイトスクリプティングが

    引き起こされうる場合です。デフォルト文字セットをセットしたとしても、

    ブラウザの "文字エンコードの自動選択" 機能が有効になっているユーザを

    守ることにはならないので、もちろんより良い解決策は単にスクリプトを修正

    (あるいは削除) することです。</p>



<h3>参照</h3>

<ul>

<li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>

</ul>

</div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">ディレクティブ</a></h2>
@@ -365,7 +385,7 @@ 
      <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,

      <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,

      <code class="directive"><a href="#authname">AuthName</a></code>, 

      <code class="directive"><a href="#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="#require">Require</a></code> <em>など。</em>)。</dd>

      <code class="directive"><a href="#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="#require">Require</a></code> <em>など</em>)。</dd>



      <dt>FileInfo</dt>
@@ -373,7 +393,7 @@ 
      ドキュメントタイプを制御するためのディレクティブの使用を許可する (<code class="directive"><a href="#defaulttype">DefaultType</a></code>, <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,

      <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, 

      <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> の Add* と Remove*

      ディレクティブ<em>など。</em>)。</dd>

      ディレクティブ<em>など</em>)。</dd>



      <dt>Indexes</dt>
@@ -383,7 +403,7 @@ 
      <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>,

      <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,

      <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>

      <em>など。</em>)。</dd>

      <em>など</em>)。</dd>



      <dt>Limit</dt>
@@ -731,7 +751,7 @@ Apache 
    しかし、このディレクティブは引数として正規表現をとります。例えば:</p>



    <div class="example"><p><code>

      &lt;DirectoryMatch "^/www/.*/[0-9]{3}"&gt;

      &lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}"&gt;

    </code></p></div>



    <p>は /www/ 以下にある数字 3 文字のディレクトリにマッチします。</p>
@@ -1720,21 +1740,20 @@ Apache 
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>

<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>

</table>

    <p>このディレクティブは、HTTP リクエストヘッダ内に含めることのできる

    バイト数、<var>bytes</var> を

    0 からコンパイル時に定義される定数

    <code>DEFAULT_LIMIT_REQUEST_FIELDSIZE</code> (配布時には 8192 と指定)

    で指定された値までの数字で指定します。</p>

    <p>このディレクティブは、HTTP リクエストヘッダ一つで受付ける

    バイト数 <var>bytes</var> を指定します。</p>



    <p><code class="directive">LimitRequestFieldSize</code> ディレクティブは、

    サーバのコンパイル時に指定したインプットバッファ容量以下に

    HTTP リクエストヘッダの許容されるサイズを制限することができます。

    HTTP リクエストヘッダで許容されるサイズを増減させることができます。

    サーバは、このディレクティブの値として、

    通常のクライアントリクエストから送られた個々のヘッダフィールドに

    十分足る大きさを必要とします。

    普通のリクエストヘッダのサイズは、個々のクライアントにより大きく変わり、

    詳細なコンテントネゴシエーションをするためのブラウザの設定までにも

    影響されることがあります。</p>

    一般的なクライアントからリクエストが送られた際に、そのリクエストに

    付属しているどのヘッダフィールドについても、

    十分足りる大きさになっていなければなりません。

    一般的なリクエストヘッダのサイズといっても、その大きさは個々の

    クライアントの実装によって大きく異なり、

    詳細なコンテントネゴシエーションをサポートするかどうかの、

    ブラウザの設定にも影響されたりします。

    SPENGO 認証ヘッダでは 12392 バイトにまで及ぶことすらあります。</p>



    <p>このディレクティブは、

    管理者にクライアントからの異常なリクエストを制御できるようにし、
@@ -1761,13 +1780,10 @@ Apache 
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>

</table>

    <p>このディレクティブは、HTTP リクエスト行内で許容されるバイト数

    <var>bytes</var> を 0 からコンパイル時の定数

    <code>DEFAULT_LIMIT_REQUEST_LINE</code> (配布時には 8190 と指定)

    で指定された値までの数字で指定します。</p>

    <var>bytes</var> を指定します。</p>



    <p><code class="directive">LimitRequestLine</code> ディレクティブにより、サーバ管理者は

    サーバのコンパイル時に指定したインプットバッファ容量以下に

    クライアントからの HTTP リクエスト行のサイズの制限を行なうことができます。 

    <p><code class="directive">LimitRequestLine</code> ディレクティブにより、

    クライアントからの HTTP リクエスト行の許容サイズを増減できます。 

    リクエスト行は、HTTPメソッド、URI、プロトコルバージョンから成っており、

    <code class="directive">LimitRequestLine</code> はサーバへのリクエストに対して

    許容するリクエスト URI の長さを制限することになります。
@@ -2320,7 +2336,7 @@ Apache 
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>

<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>

</table>

    <p>このディレクティブは、どの認証済みのユーザがディレクトリに

    <p>このディレクティブは、どの認証済みのユーザがリソースに

    アクセスすることができるかを指定します。

    以下のような構文になります。</p>
@@ -2346,7 +2362,7 @@ Apache 


    <div class="example"><p><code>

       AuthType Basic<br />

       AuthName "Restricted Directory"<br />

       AuthName "Restricted Resource"<br />

       AuthUserFile /web/users<br />

       AuthGroupFile /web/groups<br />

       Require group admin
@@ -2989,49 +3005,49 @@ Apache 
</table>

    <p>多くの状況で Apache は<em>自己参照</em> URL、すなわち

    同じサーバを指す URL、を作成する必要があります。

    <code>UseCanonicalName On</code> を使うと (1.3 より前の

    すべてのバージョンでも) Apache は <a href="#servername">ServerName</a> ディレクティブと <a href="#port">Port</a>

    ディレクティブを使ってサーバの正式な名前を作成します。

    この名前がすべての自己参照 URL で使われ、CGI の <code>SERVER_NAME</code>

    と <code>SERVER_PORT</code> にも使われます。</p>



    <p><code>UseCanonicalName Off</code> では Apache は

    クライアントがホスト名とポートを提供した場合には自己参照 URL を

    それらを元に作成します (提供されていない場合は上で定義されているように

    正式な名前を使います)。

    <code>UseCanonicalName On</code> の場合は、<code class="directive"><a href="#servername">ServerName</a></code> ディレクティブで指定されている

    ホスト名とポート番号を使って、その正規名 (自己参照の名前) を生成します。

    この名前は、すべての自己参照 URL で使われますし、CGI の 

    <code>SERVER_NAME</code> と <code>SERVER_PORT</code> でも使われます。</p>



    <p><code>UseCanonicalName Off</code> の場合、

    クライアントがホスト名とポートを指定したときには、

    それらを元に自己参照 URL を作成します (指定がなかったときは

    上の定義と同様にして正規名を解決します)。

    これらの値は<a href="../vhosts/name-based.html">名前ベースの

    バーチャルホスト</a>を実装するのに使われているのと同じ値で、

    同じクライアントから取得できる値です。CGI 変数 <code>SERVER_NAME</code>

    と <code>SERVER_PORT</code> もクライアントから与えられた値から

    作成されます。</p>



    <p>これが有用な場合の例は、イントラネットのサーバで、<code>www</code> の

    ような短い名前でユーザがマシンに接続しているときです。

    ユーザが短い名前を入力して、URL が<em>最後のスラッシュ無しの</em>ディレクトリ

    へのものであるときに、Apache はリクエストを

    <code>http://www.domain.com/splat/</code> へリダイレクトすることに

    気付くでしょう。認証をするように設定していると、この場合

    バーチャルホスト</a>を実装で使われているのと同じ値で、

    同じクライアントで取得できる値になっています。

    CGI 変数 <code>SERVER_NAME</code> と <code>SERVER_PORT</code> 

    もクライアントから与えられた値から作成されます。</p>



    <p>このような挙動が便利な例は、イントラネットのサーバで <code>www</code>

    のような短い名前でユーザがマシンに接続するときです。

    ユーザの入力で短いホスト名が使われていて、URL が<em>最後のスラッシュ無しの</em>

    ディレクトリになっている <code>http://www/splat</code> のようなとき、

    Apache はリクエストを <code>http://www.domain.com/splat/</code> 

    へリダイレクトします。

    認証をするように設定していると、この場合

    ユーザは 2 回認証をしなければならなくなります (<code>www</code> に

    対して 1 回、<code>www.domain.com</code> に対してもう一回 -- 

    より詳しい情報は <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">この話題の

    対して 1 回、<code>www.domain.com</code> に対してもう 1 回 -- 

    詳細は <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">この話題の

    FAQ</a> を参照してください)。

    しかし、<code class="directive">UseCanonicalName</code> が <code>Off</code> になっていると、

    Apache は <code>htttp://www/splat/</code> にリダイレクトします。</p>

    しかし <code class="directive">UseCanonicalName</code> が <code>Off</code> になっていると、

    Apache は <code>http://www/splat/</code> にリダイレクトします。</p>



    <p>三つ目のオプション <code>UseCanonicalName DNS</code> は、

    <code>Host:</code> ヘッダを提供しない古いクライアントをサポートした

    大規模な IP ベースのバーチャルホスティングで使用されることを

    意図しています。このオプションでは、Apache はクライアントが

    接続した IP アドレスに DNS の逆引きを行なって自己参照 URL を

    作成します。</p>

    大規模な IP ベースのバーチャルホスティングで、

    <code>Host:</code> ヘッダを提供しない古いクライアントを

    サポートする場合を想定しています。

    このオプションでは Apache は、クライアントが接続した IP アドレスに対して

    DNS の逆引きを行なって、自己参照 URL を作成します。</p>



    <div class="warning"><h3>警告</h3>

    <p>CGI が <code>SERVER_NAME</code> に

    関する仮定を行なっているときは、このオプションの設定で動作しなく

    なるかもしれません。クライアントは実質的にはホスト名にとして

    <p>CGI が <code>SERVER_NAME</code> に関して何らかの前提条件を

    仮定しているときには、このオプションの設定によっては動作しなく

    なるかもしれません。クライアントは実質的にはホスト名として

    何でも望みの値を指定することができます。CGI が

    <code>SERVER_NAME</code> のみを使って自己参照 URL を作成している

    場合はどの設定を行なっても大丈夫なはずです。</p></div>

    <code>SERVER_NAME</code> を使って自己参照 URL を作成することしかしない

    場合は、どの設定を行なっても大丈夫なはずです。</p></div>



<h3>参照</h3>

<ul>

docs/manual/mod/core.xml.meta

+1 −1
Changes for docs/manual/mod/core.xml.meta: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -8,6 +8,6 @@ 
  <variants>

    <variant outdated="yes">de</variant>

    <variant>en</variant>

    <variant outdated="yes">ja</variant>

    <variant>ja</variant>

  </variants>

</metafile>

docs/manual/mod/directives.html.de

+2 −0
Changes for docs/manual/mod/directives.html.de: 2 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -124,6 +124,8 @@ 
<li><a href="mod_disk_cache.html#cacheminfilesize">CacheMinFileSize</a></li>

<li><a href="mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></li>

<li><a href="mod_disk_cache.html#cacheroot">CacheRoot</a></li>

<li><a href="mod_cache.html#cachestorenostore">CacheStoreNoStore</a></li>

<li><a href="mod_cache.html#cachestoreprivate">CacheStorePrivate</a></li>

<li><a href="core.html#cgimapextension">CGIMapExtension</a></li>

<li><a href="mod_charset_lite.html#charsetdefault">CharsetDefault</a></li>

<li><a href="mod_charset_lite.html#charsetoptions">CharsetOptions</a></li>

docs/manual/mod/directives.html.en

+2 −0
Changes for docs/manual/mod/directives.html.en: 2 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -125,6 +125,8 @@ 
<li><a href="mod_disk_cache.html#cacheminfilesize">CacheMinFileSize</a></li>

<li><a href="mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></li>

<li><a href="mod_disk_cache.html#cacheroot">CacheRoot</a></li>

<li><a href="mod_cache.html#cachestorenostore">CacheStoreNoStore</a></li>

<li><a href="mod_cache.html#cachestoreprivate">CacheStorePrivate</a></li>

<li><a href="core.html#cgimapextension">CGIMapExtension</a></li>

<li><a href="mod_charset_lite.html#charsetdefault">CharsetDefault</a></li>

<li><a href="mod_charset_lite.html#charsetoptions">CharsetOptions</a></li>

docs/manual/mod/directives.html.es

+2 −0
Changes for docs/manual/mod/directives.html.es: 2 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -127,6 +127,8 @@ 
<li><a href="mod_disk_cache.html#cacheminfilesize">CacheMinFileSize</a></li>

<li><a href="mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></li>

<li><a href="mod_disk_cache.html#cacheroot">CacheRoot</a></li>

<li><a href="mod_cache.html#cachestorenostore">CacheStoreNoStore</a></li>

<li><a href="mod_cache.html#cachestoreprivate">CacheStorePrivate</a></li>

<li><a href="core.html#cgimapextension">CGIMapExtension</a></li>

<li><a href="mod_charset_lite.html#charsetdefault">CharsetDefault</a></li>

<li><a href="mod_charset_lite.html#charsetoptions">CharsetOptions</a></li>