From d16c3dda9fc18adb5efedbc6188cefe519f4be9d Mon Sep 17 00:00:00 2001
From: Hiroaki Kawai <kawai@apache.org>
Date: Wed, 5 Nov 2008 03:02:47 +0000
Subject: [PATCH] Sync.

English Revision: 689261
Submitted by takashi
Reviewed by kawai


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@711496 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_autoindex.xml.ja | 128 +++++++++++++++++++--------
 1 file changed, 90 insertions(+), 38 deletions(-)

diff --git a/docs/manual/mod/mod_autoindex.xml.ja b/docs/manual/mod/mod_autoindex.xml.ja
index 11ef194de7d..085915b3f1f 100644
--- a/docs/manual/mod/mod_autoindex.xml.ja
+++ b/docs/manual/mod/mod_autoindex.xml.ja
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 420990:689261 (outdated) -->
+<!-- English Revision: 689261 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -30,7 +30,7 @@
 <sourcefile>mod_autoindex.c</sourcefile>
 <identifier>autoindex_module</identifier>
 
-<summary> 
+<summary>
       <p>ディレクトリのインデックスは二つの情報源のうちの
       一つから生成できます:</p>
 
@@ -368,7 +368,7 @@
       AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
       AddIcon /icons/backup.xbm *~
     </example>
-    
+
     <p>もし可能なら、
     <directive>AddIcon</directive>
     より
@@ -379,7 +379,7 @@
 
 <directivesynopsis>
 <name>AddIconByEncoding</name>
-<description>ファイルに表示するアイコンを MIME 
+<description>ファイルに表示するアイコンを MIME
 符号化方法で選択</description>
 <syntax>AddIconByEncoding <var>icon</var> <var>MIME-encoding</var>
 [<var>MIME-encoding</var>] ...</syntax>
@@ -398,8 +398,8 @@
     は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
     </p>
 
-    <p><var>MIME-encoding</var> は、要求されたエンコードに該当する
-    ワイルドカード表現です。</p>
+    <p><var>MIME-encoding</var> は、有効なコンテントエンコーディング、
+    例えば <code>x-compress</code>です。</p>
 
     <example><title>例</title>
       AddIconByEncoding /icons/compress.xbm x-compress
@@ -495,7 +495,7 @@ MIME タイプによって選択</description>
       <example><title>例</title>
         HeaderName /include/HEADER.html
       </example>
-      
+
       <p><var>filename</var> は
       メジャーコンテントタイプが "<code>text/*</code>" 
        (<em>例えば</em>、<code>text/html</code>, 
@@ -578,6 +578,36 @@ MIME タイプによって選択</description>
     <var>option</var> は次のどれかです:</p>
 
     <dl>
+      <dt><a name="indexoptions.charset"
+               id="indexoptions.charset"
+      >Charset=<var>character-set</var></a> (<em>Apache 2.0.61
+      以降</em>)</dt>
+
+      <dd><code>Charset</code> キーワードで、
+      生成されるページの文字セットを指定できます。
+      下位のファイルシステムが Unicode ベースかどうかに依存しますが、
+      デフォルト値は <var>ISO-8859-1</var> か <var>UTF-8</var>
+      になります。
+
+      <example><title>Example:</title>
+        IndexOptions Charset=UTF-8
+      </example>
+      </dd>
+
+      <dt><a name="indexoptions.type"
+               id="indexoptions.type"
+      >Type=<var>MIME content-type</var></a> (<em>Apache 2.0.61
+      以降</em>)</dt>
+
+      <dd><code>Type</code> キーワードで、
+      生成されるページの MIME コンテントタイプを指定できます。
+      デフォルト値は <var>text/html</var> になります。
+
+      <example><title>Example:</title>
+        IndexOptions Type=text/plain
+      </example>
+      </dd>
+
       <dt><a name="indexoptions.descriptionwidth"
                id="indexoptions.descriptionwidth"
       >DescriptionWidth=[<var>n</var> | *]</a>
@@ -609,8 +639,7 @@ MIME タイプによって選択</description>
       (<em>2.0.23 以降</em>)</dt>
 
       <dd>このオプションが有効になった場合、サブディレクトリの一覧は
-      <em>必ず</em>最初に現われて、そのディレクトリの通常のファイルは
-      その後に続きます。
+      <em>必ず</em>最初に現われて、通常のファイルはその後に続きます。
       一覧は基本的には、ファイルとディレクトリの二つの部分に分けられて、
       それぞれは別々にソートされ、その後サブディレクトリを先にして
       表示が行なわれます。例えばソート順が名前の降順になっていて、
@@ -620,13 +649,13 @@ MIME タイプによって選択</description>
       <code>Gamma</code> や <code>Alpha</code>
       よりも前にリストされます。<strong>このオプションは
       <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
-      も有効になっているときにのみ、効果があります。</strong></dd>
+      も有効になっているときにのみ有効です。</strong></dd>
 
       <dt><a name="indexoptions.htmltable"
                id="indexoptions.htmltable">HTMLTable</a> <em>(実験的、
       Apache 2.0.23 以降)</em></dt>
 
-      <dd>この実験的なオプションは FancyIndexing とともに指定することで、
+      <dd>この実験的なオプションは <code>FancyIndexing</code> とともに指定することで、
       飾りの付いたディレクトリ一覧のためにテーブルを使った単純な表を作ります。
       これは古いブラウザを混乱させるかもしれないことに注意してください。
       WinNT やその他 utf-8 
@@ -643,9 +672,9 @@ MIME タイプによって選択</description>
                id="indexoptions.iconheight">IconHeight[=<var
 	       >pixels</var>]</a></dt>
 
-      <dd>このオプションが、IconWidth とともに使われている場合は、
-      サーバはファイルアイコンのための <code>img</code>
-      タグに <code>height</code> と <code>width</code>
+      <dd>このオプションが、<code>IconWidth</code> とともに
+      使われている場合は、サーバはファイルアイコンのための
+      <code>img</code> タグに <code>height</code> と <code>width</code>
       属性を取り込むようになります。
       これによって、イメージ全てをロードし終わるまで待たなくても、
       ブラウザはページレイアウトをあらかじめ計算することができます。
@@ -671,7 +700,7 @@ MIME タイプによって選択</description>
                id="indexoptions.ignorecase">IgnoreCase</a></dt>
 
       <dd>このオプションが有効であると、ファイル名は大文字小文字を区別せずにソートされます。
-      例えばファイル名が昇順でソートされ、IgnoreCase が有効であれば、
+      例えばファイル名が昇順でソートされ、<code>IgnoreCase</code> が有効であれば、
       Zeta は alfa の後にリストされます
       (注意: GAMMA は常に gamma の前になります)。</dd>
 
@@ -683,7 +712,7 @@ MIME タイプによって選択</description>
       これはソート順も含みます。
       (つまり <code><a href="#indexoptions.suppresscolumnsorting"
       >SuppressColumnSorting</a></code>
-      を暗に意味します。)</dd>
+      も有効になります。)</dd>
 
       <dt><a name="indexoptions.namewidth"
                id="indexoptions.namewidth">NameWidth=[<var>n</var> 
@@ -715,9 +744,9 @@ MIME タイプによって選択</description>
       <dt><a name="indexoptions.showforbidden"
                id="indexoptions.showforbidden">ShowForbidden</a></dt>
 
-      <dd>指定した場合であっても、サブリクエストの結果が HTTP_UNAUTHORIZED や
-      HTTP_FORBIDDEN のファイルは通常通り隠された状態のまま、
-      ファイル一覧が生成されます。</dd>
+      <dd>通常 Apache はサブリクエストの結果が<code>HTTP_UNAUTHORIZED</code> や
+      <code>HTTP_FORBIDDEN</code> のファイルは一覧に表示しません。
+      このオプションを指定すると、そのようなファイルも一覧に表示します。</dd>
 
       <dt><a name="indexoptions.suppresscolumnsorting"
                id="indexoptions.suppresscolumnsorting"
@@ -733,8 +762,8 @@ MIME タイプによって選択</description>
       ソート文字列のためのクエリー引数の解析も無効にします。
       </strong>
       この挙動は Apache 2.0.23 では
-      <a href="#indexoptions.ignoreclient">IndexOptions
-      IgnoreClient</a> で制御されるようになっています。</dd>
+      <a href="#indexoptions.ignoreclient"><code>IndexOptions
+      IgnoreClient</code></a> で制御されるようになっています。</dd>
 
       <dt><a name="indexoptions.suppressdescription"
                id="indexoptions.suppressdescription"
@@ -775,7 +804,7 @@ MIME タイプによって選択</description>
       これは FancyIndexing の一覧からアイコンを消去します。
       <code>SuppressIcon</code> と <code>SuppressRules</code>
       と組合わせることによって正しい HTML 3.2 の出力が得られます。
-      正しい HTML 3.2 出力は、最終規格において <code>img</code> と <code>hr</code>
+      HTML 3.2 の最終規格は、 <code>img</code> と <code>hr</code>
       が <code>pre</code> ブロックに入る (FancyIndexing 一覧で書式に使われています) 
       ことを禁止しています。</dd>
 
@@ -792,7 +821,7 @@ MIME タイプによって選択</description>
       <dd>ディレクトリ一覧において水平区切り線 (<code>hr</code> タグ) を消去します。
       <code>SuppressIcon</code> と <code>SuppressRules</code>
       と組合わせることによって正しい HTML 3.2 の出力が得られます。
-      正しい HTML 3.2 出力は、最終規格において <code>img</code> と <code>hr</code>
+      HTML 3.2 の最終規格は、 <code>img</code> と <code>hr</code>
       が <code>pre</code> ブロックに入る (FancyIndexing 一覧で書式に使われています) 
       ことを禁止しています。</dd>
 
@@ -806,7 +835,8 @@ MIME タイプによって選択</description>
 	       (<em>Apache 2.0.23 以降</em>)</dt>
 
       <dd>これは HTTP ヘッダ中に、
-      リストされたディレクトリの最終更新日や ETag 値を含めます。
+      ディレクトリの <code>Last-Modified</code> や 
+      <code>ETag</code> を含めます。
       これは、オペレーティングシステムやファイルシステムが
       適切な stat() の返り値を返す場合にのみ有効です。
       いくつかの UNIX システム、OS2 の JFS や Win32 の NTFS
@@ -815,13 +845,13 @@ MIME タイプによって選択</description>
       この機能が有効になると、クライアントやプロキシは
       <code>HEAD</code> リクエストを行うことによって、
       ファイル一覧の変化を追跡することができるようになります。
-      いくつかのオペレーティングシステムは、新規ファイルや
+      オペレーティングシステムによっては、新規ファイルや
       移動ファイルは正しく追跡するけれども、
-      ディレクトリ中のファイルのサイズや日付は追跡ないということに
+      ディレクトリ中のファイルのサイズや日付は追跡しないということに
       注意してください。
       <strong>既に存在するファイルのサイズや日付のスタンプが変化しても、
       全ての Unix プラットホームでは、
-      最終更新日ヘッダーを更新しません。</strong>
+      <code>Last-Modified</code> ヘッダーを更新しません。</strong>
       もしこれが重要であれば、
       このオプションを無効のままにしてください。</dd>
 
@@ -863,7 +893,7 @@ MIME タイプによって選択</description>
     </dl>
 
    <!--
-     XXX: we should consider to allow sections inside <usage> 
+     XXX: we should consider to allow sections inside <usage>
      this would require some xslt changes...
    -->
    <dl><dt>増減指定できる IndexOptions</dt>
@@ -877,7 +907,6 @@ MIME タイプによって選択</description>
      <li>一つのディレクトリに対する複数の
      <directive>IndexOptions</directive> 
      ディレクティブは、現在では一つにマージされます。
-     上の例の結果は、
 
      <example>
        &lt;Directory /foo&gt;
@@ -888,7 +917,7 @@ MIME タイプによって選択</description>
        &lt;/Directory&gt;
      </example>
 
-     <p>と同一になります。</p>
+     <p>の結果は、次の指定と同一の結果になります。</p>
 
      <example>
        IndexOptions HTMLTable SuppressColumnsorting
@@ -913,16 +942,16 @@ MIME タイプによって選択</description>
        IndexOptions +SuppressSize
      </example>
 
-     <p>中身の効果は
+     <p>最終的な効果は
      <code>IndexOptions&nbsp;FancyIndexing&nbsp;+SuppressSize</code>
      と同一です。
      接頭辞の付かない <code>FancyIndexing</code>
-     でそれ以前の増減キーワードを無効にされて、
+     でそれ以前の増減キーワードは無効になり、
      その後の累積が始まるからです。</p>
 
-     <p>無条件に <directive>IndexOptions</directive>
-     をあるディレクトリで設定することによって
-     継承した設定を消去して、<code>+</code> や <code>-</code>
+     <p>あるディレクトリにおいて上位のディレクトリに指定された設定に影響されることなく
+     <directive>IndexOptions</directive> を設定したい場合、
+     <code>+</code> や <code>-</code>
      接頭辞の付かないキーワードで設定してください。</p>
    </dd>
    </dl>
@@ -945,7 +974,7 @@ Name|Date|Size|Description</syntax>
 <usage>
     <p><directive>IndexOrderDefault</directive> ディレクティブは
     <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
-    インデックスオプションと併せて用いれれます。
+    インデックスオプションと併せて用いられます。
     デフォルトでは、FancyIndexing 
     のディレクトリ一覧はファイル名の昇順で表示されます。
     <directive>IndexOrderDefault</directive>
@@ -956,8 +985,8 @@ Name|Date|Size|Description</syntax>
     <code>Ascending</code> か <code>Descending</code> のいずれかです。
     二つ目の引数は <code>Name</code>, <code>Date</code>,
     <code>Size</code> か <code>Description</code> 
-    のいずれか一つのキーワードであって、プライマリキーを指定します。
-    二つ目のキーは<em>常に</em>ファイル名の昇順になります。</p>
+    のいずれか一つのキーワードであって、1つ目のソートキーを指定します。
+    2つ目のソートキーは<em>常に</em>ファイル名の昇順になります。</p>
 
     <p>このディレクティブと <code><a
     href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
@@ -988,6 +1017,29 @@ Name|Date|Size|Description</syntax>
 </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>IndexHeadInsert</name>
+<description>インデックスページの HEAD セクションにテキストを挿入する</description>
+<syntax>IndexHeadInsert <var>"markup ..."</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+    <p>The <directive>IndexHeadInsert</directive> directive specifies a
+    string to insert in the <var>&lt;head&gt;</var> section of the HTML
+    generated for the index page.</p>
+    <p><directive>IndexHeadInsert</directive> ディレクティブを使って
+    インデックスとして生成されたHTMLの <var>&lt;head&gt;</var> セクションに
+    挿入する文字列を指定します。
+    <example>
+      <title>Example</title>
+      IndexHeadInsert "&lt;link rel=\"sitemap\" href=\"/sitemap.html\"&gt;"
+    </example>
+</usage>
+</directivesynopsis>
+
 <directivesynopsis>
 <name>ReadmeName</name>
 <description>インデックス一覧の最後に挿入されるファイルの名前</description>
-- 
2.47.3