granicus.if.org Git - apache/blob - docs/manual/mod/mod_autoindex.html.ja.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_autoindex - Apache HTTP サーバ</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
  16 <p class="apache">Apache HTTP サーバ バージョン 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン
  21             2.3</a> &gt; <a href="./">モジュール</a></div>
  22 <div id="page-content">
  23 <div id="preamble"><h1>Apache モジュール mod_autoindex</h1>
  24 <div class="toplang">
  25 <p><span>言語: </span><a href="../en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  26 <a href="../fr/mod/mod_autoindex.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  27 <a href="../ja/mod/mod_autoindex.html" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="../ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  29 <a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  30 </div>
  31 <div class="outofdate">この日本語訳はすでに古くなっている可能性があります。
  32           更新された内容を見るには英語版をご覧下さい。</div>
  33 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>Unix の <code>ls</code> コマンドや
  34     Win32 の <code>dir</code> シェルコマンドに似た
  35     ディレクトリインデックスを生成する</td></tr>
  36 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
  37 <tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>autoindex_module</td></tr>
  38 <tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_autoindex.c</td></tr></table>
  39 <h3>概要</h3>
  40
  41       <p>ディレクトリのインデックスは二つの情報源のうちの
  42       一つから生成できます:</p>
  43
  44     <ul>
  45       <li>普通は <code>index.html</code> と呼ばれる
  46       ユーザによって書かれたファイル。
  47       <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
  48       ディレクティブでこのファイル名を設定します。
  49       これは <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> で制御されます。</li>
  50
  51       <li>もしくは、サーバによって生成された一覧。
  52       その他のディレクティブでこの一覧の書式を制御します。
  53       <code class="directive"><a href="#addicon">AddIcon</a></code>, <code class="directive"><a href="#addiconbyencoding">AddIconByEncoding</a></code> と
  54       <code class="directive"><a href="#addiconbytype">AddIconByType</a></code>
  55       を使うことで、様々なファイルタイプに対してアイコン一覧を
  56       セットします。つまり、リストされたファイル毎に、
  57       ファイルにマッチした一番最初のアイコンが表示されます。
  58       これらは <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> で制御されます。</li>
  59     </ul>
  60     <p>望むならば、自動インデックス生成を完全に除去 (あるいは置換)
  61     できるように、この二つの機能は分離されています。</p>
  62
  63     <p>自動インデックス生成は <code>Options +Indexes</code>
  64     を使うことで有効になります。詳細については、
  65     <code class="directive"><a href="../mod/core.html#options">Options</a></code>
  66     ディレクティブをご覧下さい。</p>
  67
  68     <p>もし <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>オプションが
  69     <code class="directive"><a href="../mod/autoindex.html#indexoptions">IndexOptions</a></code>
  70     ディレクティブに与えられているならば、
  71     列の先頭は表示の順番を制御するリンクになります。
  72     先頭のリンクを選択すると、一覧は再生成されて
  73     その列の値でソートされます。
  74     同じ先頭を続けて選択すると、交互に昇順と降順とになります。
  75     これらの列の先頭のリンクは、
  76     <code class="directive"><a href="#indexoptions">IndexOptions</a></code>
  77     ディレクティブの
  78     <code>SuppressColumnSorting</code>
  79     オプションで消すことができます。</p>
  80
  81     <p>"Size" でソートした場合は、用いられるのは
  82     <em>実際の</em>ファイルのサイズであって、
  83     表示の値ではないことに注意してください -
  84     たとえ両方ともが "1K" と表示されていたとしても、
  85     1010 バイトのファイルは必ず 1011
  86     バイトのファイルよりも前 (昇順の場合) に表示されます。</p>
  87 </div>
  88 <div id="quickview"><h3 class="directives">ディレクティブ</h3>
  89 <ul id="toc">
  90 <li><img alt="" src="../images/down.gif" /> <a href="#addalt">AddAlt</a></li>
  91 <li><img alt="" src="../images/down.gif" /> <a href="#addaltbyencoding">AddAltByEncoding</a></li>
  92 <li><img alt="" src="../images/down.gif" /> <a href="#addaltbytype">AddAltByType</a></li>
  93 <li><img alt="" src="../images/down.gif" /> <a href="#adddescription">AddDescription</a></li>
  94 <li><img alt="" src="../images/down.gif" /> <a href="#addicon">AddIcon</a></li>
  95 <li><img alt="" src="../images/down.gif" /> <a href="#addiconbyencoding">AddIconByEncoding</a></li>
  96 <li><img alt="" src="../images/down.gif" /> <a href="#addiconbytype">AddIconByType</a></li>
  97 <li><img alt="" src="../images/down.gif" /> <a href="#defaulticon">DefaultIcon</a></li>
  98 <li><img alt="" src="../images/down.gif" /> <a href="#headername">HeaderName</a></li>
  99 <li><img alt="" src="../images/down.gif" /> <a href="#indexheadinsert">IndexHeadInsert</a></li>
 100 <li><img alt="" src="../images/down.gif" /> <a href="#indexignore">IndexIgnore</a></li>
 101 <li><img alt="" src="../images/down.gif" /> <a href="#indexignorereset">IndexIgnoreReset</a></li>
 102 <li><img alt="" src="../images/down.gif" /> <a href="#indexoptions">IndexOptions</a></li>
 103 <li><img alt="" src="../images/down.gif" /> <a href="#indexorderdefault">IndexOrderDefault</a></li>
 104 <li><img alt="" src="../images/down.gif" /> <a href="#indexstylesheet">IndexStyleSheet</a></li>
 105 <li><img alt="" src="../images/down.gif" /> <a href="#readmename">ReadmeName</a></li>
 106 </ul>
 107 <h3>トピック</h3>
 108 <ul id="topics">
 109 <li><img alt="" src="../images/down.gif" /> <a href="#query">Autoindex リクエストクエリー引数</a></li>
 110 </ul></div>
 111 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 112 <div class="section">
 113 <h2><a name="query" id="query">Autoindex リクエストクエリー引数</a></h2>
 114
 115
 116     <p>Apache 2.0.23 で、
 117     コラムソートのためにクエリー引数を再編成して、
 118     新しいクエリーオプションのグループを導入しました。
 119     出力に対するクライアントのすべての制御を効率的に抹消
 120     できるように、
 121     <code><a href="#indexoptions.ignoreclient">IndexOptions
 122     IgnoreClient</a></code> が導入されました。</p>
 123
 124     <p>コラムソートのヘッダそれ自体が、
 125     下記のソートクエリーオプションを付加する
 126     自分自身を参照するリンクです。
 127     下記のオプションのどれでも、
 128     ディレクトリリソースへのリクエストに加えることができます。</p>
 129
 130     <ul>
 131       <li><code>C=N</code> は、ファイル名でソートします。</li>
 132
 133       <li><code>C=M</code> は、更新日時、
 134       ディレクトリ、ファイル名の順でソートします。</li>
 135
 136       <li><code>C=S</code> は、サイズ、
 137       ディレクトリ、ファイル名の順でソートします。</li>
 138
 139       <li class="separate"><code>C=D</code> は、説明、
 140       ディレクトリ、ファイル名の順でソートします。</li>
 141
 142       <li><code>O=A</code> は、昇順で表をソートします。</li>
 143
 144       <li class="separate"><code>O=D</code> は、降順で表をソートします。</li>
 145
 146       <li><code>F=0</code> は、単純な表の書式にします。
 147       (FancyIndex ではありません。)</li>
 148
 149       <li><code>F=1</code> は、FancyIndex
 150       表示の表の書式にします。</li>
 151
 152       <li><code>F=2</code> は、表を HTML
 153       のテーブルを使った FancyIndex の書式にします。</li>
 154
 155       <li><code>V=0</code>
 156       は、バージョンによるソートを無効にします。</li>
 157
 158       <li class="separate"><code>V=1</code>
 159       は、バージョンによるソートを有効にします。</li>
 160
 161       <li><code>P=<var>pattern</var></code>
 162       は、与えられた <var>pattern</var>
 163       に適合したファイルのみを表示します。</li>
 164     </ul>
 165
 166     <p>"P (パターンの P)" クエリー引数は、
 167     通常の <code class="directive"><a href="#indexignore">IndexIgnore</a></code>
 168     ディレクティブが処理された<em>後</em>に検査され、
 169     ファイル名全てが、他の autoindex
 170     リスト処理と同様の判定基準下に置かれ続ける
 171     ことに注意してください。
 172     <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> のクエリー引数パーサ (解析) は、
 173     認識不能なオプションにぶつかると即座に停止します。
 174     クエリー引数は上の表に従って
 175     正しい形式になっていなければなりません。</p>
 176
 177     <p>下の単純な例は、これらのクエリーオプションを
 178     表します。これをそのまま切り取って HEADER.html
 179     ファイルに保存することもできます。
 180     mod_autoindex が X=Go 入力にぶつかる前に
 181     引数が全て解釈されるように、
 182     未知の引数 "X" はリストの最後に置かれています。</p>
 183
 184     <div class="example"><p><code>
 185       &lt;form action="" method="get"&gt;<br />
 186       <span class="indent">
 187         Show me a &lt;select name="F"&gt;<br />
 188         <span class="indent">
 189           &lt;option value="0"&gt; Plain list&lt;/option&gt;<br />
 190           &lt;option value="1" selected="selected"&gt; Fancy list&lt;/option&gt;<br />
 191           &lt;option value="2"&gt; Table list&lt;/option&gt;<br />
 192         </span>
 193         &lt;/select&gt;<br />
 194         Sorted by &lt;select name="C"&gt;<br />
 195         <span class="indent">
 196           &lt;option value="N" selected="selected"&gt; Name&lt;/option&gt;<br />
 197           &lt;option value="M"&gt; Date Modified&lt;/option&gt;<br />
 198           &lt;option value="S"&gt; Size&lt;/option&gt;<br />
 199           &lt;option value="D"&gt; Description&lt;/option&gt;<br />
 200         </span>
 201         &lt;/select&gt;<br />
 202         &lt;select name="O"&gt;<br />
 203         <span class="indent">
 204           &lt;option value="A" selected="selected"&gt; Ascending&lt;/option&gt;<br />
 205           &lt;option value="D"&gt; Descending&lt;/option&gt;<br />
 206         </span>
 207         &lt;/select&gt;<br />
 208         &lt;select name="V"&gt;<br />
 209         <span class="indent">
 210           &lt;option value="0" selected="selected"&gt; in Normal order&lt;/option&gt;<br />
 211           &lt;option value="1"&gt; in Version order&lt;/option&gt;<br />
 212         </span>
 213         &lt;/select&gt;<br />
 214         Matching &lt;input type="text" name="P" value="*" /&gt;<br />
 215         &lt;input type="submit" name="X" value="Go" /&gt;<br />
 216       </span>
 217       &lt;/form&gt;
 218     </code></p></div>
 219
 220 </div>
 221 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 222 <div class="directive-section"><h2><a name="AddAlt" id="AddAlt">AddAlt</a> <a name="addalt" id="addalt">ディレクティブ</a></h2>
 223 <table class="directive">
 224 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>アイコンの代わりに
 225 表示される、ファイル名で選択された代替テキスト</td></tr>
 226 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddAlt <var>string</var> <var>file</var> [<var>file</var>] ...</code></td></tr>
 227 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 228 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 229 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 230 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 231 </table>
 232     <p><code class="directive">AddAlt</code> は、<code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 233     において、アイコンの代わりに表示する代替テキストを提供します。
 234     <var>file</var> は、説明するファイルのファイル拡張子、
 235     ファイル名の一部、ワイルドカード表現、完全なファイル名の
 236     どれかになります。
 237     <var>string</var> に空白がある場合は引用符  (<code>"</code>
 238     か <code>'</code>) で囲む必要があります。
 239     この文字列は、クライアントが画像を表示できない場合や
 240     画像のロードを無効にしている場合や
 241     アイコンの取得に失敗したときに表示されます。</p>
 242
 243     <div class="example"><h3>例</h3><p><code>
 244       AddAlt "PDF file" *.pdf<br />
 245       AddAlt Compressed *.gz *.zip *.Z
 246     </code></p></div>
 247
 248 </div>
 249 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 250 <div class="directive-section"><h2><a name="AddAltByEncoding" id="AddAltByEncoding">AddAltByEncoding</a> <a name="addaltbyencoding" id="addaltbyencoding">ディレクティブ</a></h2>
 251 <table class="directive">
 252 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>アイコンの代わりに表示される、MIME 符号化方法で選択された
 253 代替テキスト</td></tr>
 254 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddAltByEncoding <var>string</var> <var>MIME-encoding</var>
 255 [<var>MIME-encoding</var>] ...</code></td></tr>
 256 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 257 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 258 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 259 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 260 </table>
 261     <p><code class="directive">AddAltByEncoding</code> は、
 262     <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 263     において、アイコンの代わりに表示する代替文字列を提供します。
 264     <var>MIME-encoding</var> は有効な符号化、例えば
 265     <code>x-compress</code>
 266     です。
 267     <var>string</var> に空白があるときは、引用符 (<code>"</code> か
 268     <code>'</code>) で囲む必要があります。
 269     この文字列は、クライアントが画像を表示できない場合や
 270     画像のロードを無効にしている場合や
 271     アイコンの取得に失敗したときに表示されます。</p>
 272
 273     <div class="example"><h3>例</h3><p><code>
 274       AddAltByEncoding gzip x-gzip
 275     </code></p></div>
 276
 277 </div>
 278 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 279 <div class="directive-section"><h2><a name="AddAltByType" id="AddAltByType">AddAltByType</a> <a name="addaltbytype" id="addaltbytype">ディレクティブ</a></h2>
 280 <table class="directive">
 281 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>アイコンの代わりに
 282 表示される、MIME タイプで選択された代替テキスト</td></tr>
 283 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddAltByType <var>string</var> <var>MIME-type</var>
 284 [<var>MIME-type</var>] ...</code></td></tr>
 285 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 286 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 287 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 288 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 289 </table>
 290     <p><code class="directive">AddAltByType</code> は、
 291     <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 292     において、アイコンの代わりに表示する代替文字列を設定します。
 293     <var>MIME-type</var> は有効なタイプ、例えば
 294     <code>text/html</code>
 295     です。
 296     <var>string</var> に空白があるときは、引用符 (<code>"</code> か
 297     <code>'</code>) で囲む必要があります。
 298     この文字列は、クライアントが画像を表示できない場合や
 299     画像のロードを無効にしている場合や
 300     アイコンの取得に失敗したときに表示されます。</p>
 301
 302     <div class="example"><h3>例</h3><p><code>
 303       AddAltByType 'plain text' text/plain
 304     </code></p></div>
 305
 306 </div>
 307 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 308 <div class="directive-section"><h2><a name="AddDescription" id="AddDescription">AddDescription</a> <a name="adddescription" id="adddescription">ディレクティブ</a></h2>
 309 <table class="directive">
 310 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ファイルに対して表示する説明</td></tr>
 311 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddDescription <var>string</var> <var>file</var> [<var>file</var>] ...</code></td></tr>
 312 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 313 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 314 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 315 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 316 </table>
 317     <p><code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 318     において、ファイルに対して表示する説明を設定します。
 319     <var>file</var> は説明するファイルのファイル拡張子、
 320     ファイル名の一部、ワイルドカード表現、完全なファイル名の
 321     どれかになります。
 322     <var>string</var> は二重引用符 (<code>"</code>) で囲まれます。</p>
 323
 324     <div class="example"><h3>例</h3><p><code>
 325       AddDescription "The planet Mars" /web/pics/mars.gif
 326     </code></p></div>
 327
 328     <p>通常のデフォルトの説明領域は 23 バイトの幅です。
 329     <code><a href="#indexoptions.suppressicon">IndexOptions SuppressIcon</a></code>
 330     オプションで 6 バイト追加、
 331     <code><a href="#indexoptions.suppresssize">IndexOptions SuppressSize</a></code>
 332     オプションで 7 バイト追加、
 333     <code><a href="#indexoptions.suppresslastmodified">IndexOptions SuppressLastModified</a></code>
 334     オプションで 19 バイト追加されます。
 335     ですから、デフォルトの説明コラムの最大幅は
 336     55 バイトになります。</p>
 337
 338     <p>このコラムの大きさを上書きしたり、
 339     説明が無制限長でもよいようにするための詳細に関しては、
 340     <a href="#indexoptions.descriptionwidth">DescriptionWidth</a>
 341     という
 342     <code class="directive"><a href="#indexoptions">IndexOptions</a></code>
 343     のキーワードをご覧下さい。</p>
 344
 345     <div class="note"><h3>警告</h3>
 346       <p><code class="directive">AddDescription</code>
 347       で定義された説明テキストは、タグや文字列といった
 348       HTML マークアップを含むことができます。
 349       もし、説明コラムの幅によってタグ付けされた要素が丸め込まれた
 350        (太字の語句の最後が切れるといった) 場合、
 351       出力結果は、ディレクトリ一覧の残りの部分に影響を与えるでしょう。</p>
 352     </div>
 353
 354 </div>
 355 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 356 <div class="directive-section"><h2><a name="AddIcon" id="AddIcon">AddIcon</a> <a name="addicon" id="addicon">ディレクティブ</a></h2>
 357 <table class="directive">
 358 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ファイルに表示するアイコンを名前で選択</td></tr>
 359 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddIcon <var>icon</var> <var>name</var>
 360 [<var>name</var>] ...</code></td></tr>
 361 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 362 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 363 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 364 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 365 </table>
 366     <p><code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 367     において、
 368     <var>name</var> で終わるファイルの隣に表示するアイコンを設定します。
 369     <var>icon</var> は、(% でエスケープされた) アイコンへの相対 URL
 370     か、他の書式 (<var>alttext</var>, <var>url</var>) です。
 371     ここで <var>alttext</var>
 372     は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
 373     </p>
 374
 375     <p><var>name</var> は、ディレクトリに対応する <code>^^DIRECTORY^^</code>
 376     か、空白行に対応する <code>^^BLANKICON^^</code>  (一覧が正しく表示されるために) か、
 377     ファイル拡張子か、ワイルドカード表現か、ファイル名の一部か
 378     完全なファイル名です。</p>
 379
 380     <div class="example"><h3>例</h3><p><code>
 381       AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br />
 382       AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
 383       AddIcon /icons/backup.xbm *~
 384     </code></p></div>
 385
 386     <p>もし可能なら、
 387     <code class="directive">AddIcon</code>
 388     より
 389     <code class="directive"><a href="#addiconbytype">AddIconByType</a></code>
 390     を優先的に使うべきでしょう。</p>
 391
 392 </div>
 393 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 394 <div class="directive-section"><h2><a name="AddIconByEncoding" id="AddIconByEncoding">AddIconByEncoding</a> <a name="addiconbyencoding" id="addiconbyencoding">ディレクティブ</a></h2>
 395 <table class="directive">
 396 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ファイルに表示するアイコンを MIME
 397 符号化方法で選択</td></tr>
 398 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddIconByEncoding <var>icon</var> <var>MIME-encoding</var>
 399 [<var>MIME-encoding</var>] ...</code></td></tr>
 400 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 401 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 402 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 403 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 404 </table>
 405     <p><code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 406     において、ファイルの隣に表示するアイコンを設定します。
 407     <var>icon</var> は、(% でエスケープされた) アイコンへの相対 URL
 408     か、他の書式 <code>(<var>alttext</var>, <var>url</var>)</code> です。
 409     ここで <var>alttext</var>
 410     は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
 411     </p>
 412
 413     <p><var>MIME-encoding</var> は、有効なコンテントエンコーディング、
 414     例えば <code>x-compress</code>です。</p>
 415
 416     <div class="example"><h3>例</h3><p><code>
 417       AddIconByEncoding /icons/compress.xbm x-compress
 418     </code></p></div>
 419
 420 </div>
 421 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 422 <div class="directive-section"><h2><a name="AddIconByType" id="AddIconByType">AddIconByType</a> <a name="addiconbytype" id="addiconbytype">ディレクティブ</a></h2>
 423 <table class="directive">
 424 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ファイルの隣に表示するアイコンを
 425 MIME タイプによって選択</td></tr>
 426 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddIconByType <var>icon</var> <var>MIME-type</var>
 427 [<var>MIME-type</var>] ...</code></td></tr>
 428 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 429 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 430 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 431 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 432 </table>
 433     <p><code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 434     において、ファイルの隣に表示するアイコンを設定します。
 435     <var>icon</var> は、(% でエスケープされた) アイコンへの相対 URL
 436     か、他の書式 <code>(<var>alttext</var>, <var>url</var>)</code> です。
 437     ここで <var>alttext</var>
 438     は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
 439     </p>
 440
 441     <p><var>MIME-type</var> は、要求されたタイプに該当する
 442     ワイルドカード表現です。</p>
 443
 444     <div class="example"><h3>例</h3><p><code>
 445       AddIconByType (IMG,/icons/image.xbm) image/*
 446     </code></p></div>
 447
 448 </div>
 449 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 450 <div class="directive-section"><h2><a name="DefaultIcon" id="DefaultIcon">DefaultIcon</a> <a name="defaulticon" id="defaulticon">ディレクティブ</a></h2>
 451 <table class="directive">
 452 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>特定のアイコンが何も設定されていない時に
 453 ファイルに表示するアイコン</td></tr>
 454 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>DefaultIcon <var>url-path</var></code></td></tr>
 455 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 456 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 457 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 458 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 459 </table>
 460     <p><code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 461     において、
 462     特定のアイコンがない場合にファイルに表示するアイコンを設定します。
 463     <var>url-path</var> は、(% でエスケープされた) アイコンへの相対 URL
 464     です。</p>
 465
 466     <div class="example"><h3>例</h3><p><code>
 467       DefaultIcon /icon/unknown.xbm
 468     </code></p></div>
 469
 470 </div>
 471 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 472 <div class="directive-section"><h2><a name="HeaderName" id="HeaderName">HeaderName</a> <a name="headername" id="headername">ディレクティブ</a></h2>
 473 <table class="directive">
 474 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>
 475 インデックス一覧の先頭に挿入されるファイルの名前</td></tr>
 476 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>HeaderName <var>filename</var></code></td></tr>
 477 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 478 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 479 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 480 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 481 </table>
 482     <p><code class="directive">HeaderName</code>
 483     ディレクティブは、
 484     インデックス一覧の先頭に挿入するファイルの名前を設定します。
 485     <var>Filename</var> は取り込むファイルの名前です。</p>
 486
 487     <div class="example"><h3>例</h3><p><code>
 488       HeaderName HEADER.html
 489     </code></p></div>
 490
 491     <div class="note">
 492       <p>HeaderName も <code class="directive"><a href="#readmename">ReadmeName</a></code>
 493       も両方とも現在は、<var>filename</var>
 494       をインデックスされているディレクトリに用いられた URI
 495       に対する相対 URI パスとして扱います。
 496       <var>filename</var> がスラッシュで始まる場合は、
 497       <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
 498       からの相対パスとなります。</p>
 499
 500       <div class="example"><h3>例</h3><p><code>
 501         HeaderName /include/HEADER.html
 502       </code></p></div>
 503
 504       <p><var>filename</var> は
 505       メジャーコンテントタイプが "<code>text/*</code>"
 506        (<em>例えば</em>、<code>text/html</code>,
 507       <code>text/plain</code> 等です。)
 508       のドキュメントとして解決
 509       されなければなりません。これはつまり、
 510       もし CGI スクリプトの実際のファイルタイプが
 511       次のディレクティブのようにして実際の出力とは異なって
 512       <code>text/html</code> としてマークされている場合、
 513       <var>filename</var>
 514       は CGI スクリプトを参照するかも知れない、
 515       ということを意味します:</p>
 516
 517       <div class="example"><p><code>
 518         AddType text/html .cgi
 519       </code></p></div>
 520
 521       <p><code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>MultiViews</code> が
 522       有効になっている場合は、
 523       <a href="../content-negotiation.html">コンテントネゴシエーション</a>
 524       が行なわれます。
 525       もし <var>filename</var> が (CGI スクリプトでない) 静的な
 526       <code>text/html</code> ドキュメントで解決され、
 527       <code class="directive"><a href="../mod/core.html#options">options</a></code>
 528       <code>Includes</code> か <code>IncludesNOEXEC</code>
 529       が有効になっている場合は、
 530       ファイルはサーバーサイドインクルードで処理されます
 531       (<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ドキュメントを参照して下さい)。</p>
 532     </div>
 533
 534     <p>もし <code class="directive">HeaderName</code> で指定されたファイルが
 535     HTML ドキュメントの開始部分 (&lt;html&gt;, &lt;head&gt;,
 536     等) を含んでいたら、
 537     <a href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions
 538     +SuppressHTMLPreamble</code></a>
 539     を設定して、これらのタグが繰り返されないようにしたいと思うでしょう。</p>
 540
 541 </div>
 542 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 543 <div class="directive-section"><h2><a name="IndexHeadInsert" id="IndexHeadInsert">IndexHeadInsert</a> <a name="indexheadinsert" id="indexheadinsert">ディレクティブ</a></h2>
 544 <table class="directive">
 545 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>インデックスページの HEAD セクションにテキストを挿入する</td></tr>
 546 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>IndexHeadInsert <var>"markup ..."</var></code></td></tr>
 547 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 548 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 549 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 550 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 551 </table>
 552     <p><code class="directive">IndexHeadInsert</code> ディレクティブを使って
 553     インデックスとして生成されたHTMLの <var>&lt;head&gt;</var> セクションに
 554     挿入する文字列を指定します。</p>
 555     <div class="example"><h3>Example</h3><p><code>
 556
 557       IndexHeadInsert "&lt;link rel=\"sitemap\" href=\"/sitemap.html\"&gt;"
 558     </code></p></div>
 559
 560 </div>
 561 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 562 <div class="directive-section"><h2><a name="IndexIgnore" id="IndexIgnore">IndexIgnore</a> <a name="indexignore" id="indexignore">ディレクティブ</a></h2>
 563 <table class="directive">
 564 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディレクトリ一覧を行なう際に無視すべき
 565 ファイルリストに追加</td></tr>
 566 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>IndexIgnore <var>file</var> [<var>file</var>] ...</code></td></tr>
 567 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 568 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 569 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 570 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 571 </table>
 572     <p><code class="directive">IndexIgnore</code> ディレクティブは、
 573     ディレクトリの一覧を行う際に無視すべきファイルリストに追加します。
 574     <var>file</var> は、
 575     シェル形式のワイルドカード表現か完全なファイル名です。
 576     IndexIgnore が複数ある場合は、無視するリストに追加が行われ、
 577     置換は行われません。デフォルトではリストには <code>.</code>
 578     (カレントディレクトリ) が含まれています。</p>
 579
 580     <div class="example"><p><code>
 581       IndexIgnore README .htaccess *.bak *~
 582     </code></p></div>
 583
 584 </div>
 585 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 586 <div class="directive-section"><h2><a name="IndexIgnoreReset" id="IndexIgnoreReset">IndexIgnoreReset</a> <a name="indexignorereset" id="indexignorereset">ディレクティブ</a></h2>
 587 <table class="directive">
 588 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Empties the list of files to hide when listing
 589 a directory</td></tr>
 590 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>IndexIgnoreReset ON|OFF</code></td></tr>
 591 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 592 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 593 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 594 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 595 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.3.10 and later</td></tr>
 596 </table><p>The documentation of this directive was not translated yet.
 597             Please refer to the English version.</p></div>
 598 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 599 <div class="directive-section"><h2><a name="IndexOptions" id="IndexOptions">IndexOptions</a> <a name="indexoptions" id="indexoptions">ディレクティブ</a></h2>
 600 <table class="directive">
 601 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディレクトリインデックスの様々な設定項目
 602 </td></tr>
 603 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>IndexOptions  [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
 604 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 605 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 606 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 607 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 608 </table>
 609     <p><code class="directive">IndexOptions</code>
 610     は、ディレクトリインデックスの挙動を指定します。
 611     <var>option</var> は次のどれかです:</p>
 612
 613     <dl>
 614       <dt><a name="indexoptions.charset" id="indexoptions.charset">Charset=<var>character-set</var></a> (<em>Apache 2.0.61
 615       以降</em>)</dt>
 616
 617       <dd><code>Charset</code> キーワードで、
 618       生成されるページの文字セットを指定できます。
 619       下位のファイルシステムが Unicode ベースかどうかに依存しますが、
 620       デフォルト値は <var>ISO-8859-1</var> か <var>UTF-8</var>
 621       になります。
 622
 623       <div class="example"><h3>Example:</h3><p><code>
 624         IndexOptions Charset=UTF-8
 625       </code></p></div>
 626       </dd>
 627
 628       <dt><a name="indexoptions.type" id="indexoptions.type">Type=<var>MIME content-type</var></a> (<em>Apache 2.0.61
 629       以降</em>)</dt>
 630
 631       <dd><code>Type</code> キーワードで、
 632       生成されるページの MIME コンテントタイプを指定できます。
 633       デフォルト値は <var>text/html</var> になります。
 634
 635       <div class="example"><h3>Example:</h3><p><code>
 636         IndexOptions Type=text/plain
 637       </code></p></div>
 638       </dd>
 639
 640       <dt><a name="indexoptions.descriptionwidth" id="indexoptions.descriptionwidth">DescriptionWidth=[<var>n</var> | *]</a>
 641       (<em>2.0.23 以降</em>)</dt>
 642
 643       <dd><code>DescriptionWidth</code>
 644       キーワードは説明コラムの幅を文字数で指定することができます。</dd>
 645
 646       <dd><code>-DescriptionWidth</code> (または非設定) で、
 647       <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> が最適な幅を計算するようにできます。</dd>
 648
 649       <dd><code>DescriptionWidth=<var>n</var></code>
 650       で、コラム幅を <var>n</var> バイトに固定します。</dd>
 651
 652       <dd><code>DescriptionWidth=*</code>
 653       は、最長の説明に合わせて必要な長さまでコラムを延ばします。</dd>
 654
 655       <dd><strong>説明を丸め込んだ場合特有の危険については
 656       <code class="directive"><a href="#adddescription">AddDescription</a></code>
 657       セクションをお読み下さい。</strong></dd>
 658
 659       <dt><a name="indexoptions.fancyindexing" id="indexoptions.fancyindexing">FancyIndexing</a></dt>
 660
 661       <dd>飾り付きインデックスをオンにします。</dd>
 662
 663       <dt><a name="indexoptions.foldersfirst" id="indexoptions.foldersfirst">FoldersFirst</a>
 664       (<em>2.0.23 以降</em>)</dt>
 665
 666       <dd>このオプションが有効になった場合、サブディレクトリの一覧は
 667       <em>必ず</em>最初に現われて、通常のファイルはその後に続きます。
 668       一覧は基本的には、ファイルとディレクトリの二つの部分に分けられて、
 669       それぞれは別々にソートされ、その後サブディレクトリを先にして
 670       表示が行なわれます。例えばソート順が名前の降順になっていて、
 671       <code>FoldersFirst</code> が有効になっている場合は、
 672       サブディレクトリ <code>Zed</code> はサブディレクトリ
 673       <code>Beta</code> よりも前にリストされ、通常のファイル
 674       <code>Gamma</code> や <code>Alpha</code>
 675       よりも前にリストされます。<strong>このオプションは
 676       <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
 677       も有効になっているときにのみ有効です。</strong></dd>
 678
 679       <dt><a name="indexoptions.htmltable" id="indexoptions.htmltable">HTMLTable</a> <em>(実験的、
 680       Apache 2.0.23 以降)</em></dt>
 681
 682       <dd>この実験的なオプションは <code>FancyIndexing</code> とともに指定することで、
 683       飾りの付いたディレクトリ一覧のためにテーブルを使った単純な表を作ります。
 684       これは古いブラウザを混乱させるかもしれないことに注意してください。
 685       WinNT やその他 utf-8
 686       が有効なプラットホームのように、ファイル名や説明テキストが
 687       右読みになったり左読みになりえる場合は特に必要です。</dd>
 688
 689       <dt><a name="indexoptions.iconsarelinks" id="indexoptions.iconsarelinks">IconsAreLinks</a></dt>
 690
 691       <dd>これは、FancyIndexing において、
 692       アイコンもファイル名へのリンクの一部にします。</dd>
 693
 694       <dt><a name="indexoptions.iconheight" id="indexoptions.iconheight">IconHeight[=<var>pixels</var>]</a></dt>
 695
 696       <dd>このオプションが、<code>IconWidth</code> とともに
 697       使われている場合は、サーバはファイルアイコンのための
 698       <code>img</code> タグに <code>height</code> と <code>width</code>
 699       属性を取り込むようになります。
 700       これによって、イメージ全てをロードし終わるまで待たなくても、
 701       ブラウザはページレイアウトをあらかじめ計算することができます。
 702       このオプションに何も値が与えられなければ、Apache
 703       ソフトウェアで提供されているアイコンの標準の高さが
 704       デフォルトなります。</dd>
 705
 706       <dt><a name="indexoptions.iconwidth" id="indexoptions.iconwidth">IconWidth[=<var>pixels</var>]</a></dt>
 707
 708       <dd>このオプションが、<code>IconHeight</code> とともに使われている場合は、
 709       サーバはファイルアイコンのための <code>img</code>
 710       タグに <code>height</code> と <code>width</code>
 711       属性を取り込むようになります。
 712       これによって、イメージ全てをロードし終わるまで待たなくても、
 713       ブラウザはページレイアウトをあらかじめ計算することができます。
 714       このオプションに何も値が与えられなければ、Apache
 715       ソフトウェアで提供されているアイコンの標準の高さが
 716       デフォルトなります。</dd>
 717
 718       <dt><a name="indexoptions.ignorecase" id="indexoptions.ignorecase">IgnoreCase</a></dt>
 719
 720       <dd>このオプションが有効であると、ファイル名は大文字小文字を区別せずにソートされます。
 721       例えばファイル名が昇順でソートされ、<code>IgnoreCase</code> が有効であれば、
 722       Zeta は alfa の後にリストされます
 723       (注意: GAMMA は常に gamma の前になります)。</dd>
 724
 725       <dt><a name="indexoptions.ignoreclient" id="indexoptions.ignoreclient">IgnoreClient</a></dt>
 726
 727       <dd>このオプションで <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> は、
 728       クライアントからの全てのクエリー変数を無視するようになります。
 729       これはソート順も含みます。
 730       (つまり <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
 731       も有効になります。)</dd>
 732
 733       <dt><a name="indexoptions.namewidth" id="indexoptions.namewidth">NameWidth=[<var>n</var>
 734                | *]</a></dt>
 735
 736       <dd><code>NameWidth</code> キーワードでファイル名コラムの幅をバイト数で
 737       指定できます。</dd>
 738
 739       <dd><code>-NameWidth</code> (または非設定) で、
 740       <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> が最適な幅を計算するようにできます。</dd>
 741
 742       <dd><code>NameWidth=<var>n</var></code>
 743       で、コラム幅を <var>n</var> バイトに固定します。</dd>
 744
 745       <dd><code>NameWidth=*</code>
 746       は、必要な長さまでコラムを延ばします。</dd>
 747
 748       <dt><a name="indexoptions.scanhtmltitles" id="indexoptions.scanhtmltitles">ScanHTMLTitles</a></dt>
 749
 750       <dd>FancyIndexing のために、
 751        HTML ドキュメントからタイトルを取り出すことを可能にします。
 752       もしファイルに
 753       <code class="directive"><a href="#adddescription">AddDescription</a></code>
 754       で説明が与えられていなければ、
 755       httpd は <code>title</code> タグの値を読むためにドキュメントを読み始めます。
 756       これは CPU や disk に負荷をかけます。</dd>
 757
 758       <dt><a name="indexoptions.showforbidden" id="indexoptions.showforbidden">ShowForbidden</a></dt>
 759
 760       <dd>通常 Apache はサブリクエストの結果が<code>HTTP_UNAUTHORIZED</code> や
 761       <code>HTTP_FORBIDDEN</code> のファイルは一覧に表示しません。
 762       このオプションを指定すると、そのようなファイルも一覧に表示します。</dd>
 763
 764       <dt><a name="indexoptions.suppresscolumnsorting" id="indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></dt>
 765
 766       <dd>もし指定されていれば、Apache は
 767       FancyIndexing で表示されているディレクトリ一覧での
 768       コラムの先頭を、ソートのためのリンクにしなくなります。
 769       デフォルトの挙動は、リンクとします。
 770       コラムの先頭を選ぶとコラムの値に従ってディレクトリリストを
 771       ソートします。
 772       <strong>Apache 2.0.23 以前では、これは同時に
 773       ソート文字列のためのクエリー引数の解析も無効にします。
 774       </strong>
 775       この挙動は Apache 2.0.23 では
 776       <a href="#indexoptions.ignoreclient"><code>IndexOptions
 777       IgnoreClient</code></a> で制御されるようになっています。</dd>
 778
 779       <dt><a name="indexoptions.suppressdescription" id="indexoptions.suppressdescription">SuppressDescription</a></dt>
 780
 781       <dd>これは FancyIndexing におけるファイルの説明を消去します。
 782       デフォルトでは、説明は定義されておらず、
 783       このオプションを使うと他のために 23
 784       文字の空白を稼ぐことができます。 ファイルの説明に関する情報は、
 785       <code class="directive"><a href="#adddescription">AddDescription</a></code>
 786       をご覧下さい。また、説明のコラムサイズを制限する
 787       <code><a href="#indexoptions.descriptionwidth">DescriptionWidth</a></code>
 788       インデックスオプションもご覧下さい。</dd>
 789
 790       <dt><a name="indexoptions.suppresshtmlpreamble" id="indexoptions.suppresshtmlpreamble">SuppressHTMLPreamble</a></dt>
 791
 792       <dd>通常、
 793       <code class="directive"><a href="#headername">HeaderName</a></code>
 794       ディレクティブで指定したファイルを
 795       ディレクトリが実際に含んでいれば、標準的な HTML プリアンブル
 796       (<code>&lt;html&gt;</code>, <code>&lt;head&gt;</code>, <em>等</em>) の後に、
 797       モジュールはファイルの中身をインクルードします。
 798       <code>SuppressHTMLPreamble</code> オプションは、
 799       この挙動を無効にできて、
 800       モジュールがヘッダーファイルの中身から表示を始めます。
 801       この場合、ヘッダーファイルは正しい HTML
 802       命令を含んでいなければなりません。
 803       ヘッダーファイルが存在しない場合は、プリアンブルは通常通り
 804       生成されます。</dd>
 805
 806       <dt><a name="indexoptions.suppressicon" id="indexoptions.suppressicon">SuppressIcon</a> (<em>Apache
 807       2.0.23 以降</em>)</dt>
 808
 809       <dd>
 810       これは FancyIndexing の一覧からアイコンを消去します。
 811       <code>SuppressIcon</code> と <code>SuppressRules</code>
 812       と組合わせることによって正しい HTML 3.2 の出力が得られます。
 813       HTML 3.2 の最終規格は、 <code>img</code> と <code>hr</code>
 814       が <code>pre</code> ブロックに入る (FancyIndexing 一覧で書式に使われています)
 815       ことを禁止しています。</dd>
 816
 817       <dt><a name="indexoptions.suppresslastmodified" id="indexoptions.suppresslastmodified">SuppressLastModified</a></dt>
 818
 819       <dd>FancyIndexing 一覧において最終更新日時の表示を消去します。</dd>
 820
 821       <dt><a name="indexoptions.suppressrules" id="indexoptions.suppressrules">SuppressRules</a>
 822        (<em>Apache 2.0.23 以降</em>) </dt>
 823
 824       <dd>ディレクトリ一覧において水平区切り線 (<code>hr</code> タグ) を消去します。
 825       <code>SuppressIcon</code> と <code>SuppressRules</code>
 826       と組合わせることによって正しい HTML 3.2 の出力が得られます。
 827       HTML 3.2 の最終規格は、 <code>img</code> と <code>hr</code>
 828       が <code>pre</code> ブロックに入る (FancyIndexing 一覧で書式に使われています)
 829       ことを禁止しています。</dd>
 830
 831       <dt><a name="indexoptions.suppresssize" id="indexoptions.suppresssize">SuppressSize</a></dt>
 832
 833       <dd>FancyIndexing 一覧においてファイルサイズの表示を消去します。</dd>
 834
 835       <dt><a name="indexoptions.trackmodified" id="indexoptions.trackmodified">TrackModified</a>
 836                (<em>Apache 2.0.23 以降</em>)</dt>
 837
 838       <dd>これは HTTP ヘッダ中に、
 839       ディレクトリの <code>Last-Modified</code> や
 840       <code>ETag</code> を含めます。
 841       これは、オペレーティングシステムやファイルシステムが
 842       適切な stat() の返り値を返す場合にのみ有効です。
 843       いくつかの UNIX システム、OS2 の JFS や Win32 の NTFS
 844       ボリュームはそうなっています。
 845       例えば、OS2 と Win32 FAT ボリュームはそうではありません。
 846       この機能が有効になると、クライアントやプロキシは
 847       <code>HEAD</code> リクエストを行うことによって、
 848       ファイル一覧の変化を追跡することができるようになります。
 849       オペレーティングシステムによっては、新規ファイルや
 850       移動ファイルは正しく追跡するけれども、
 851       ディレクトリ中のファイルのサイズや日付は追跡しないということに
 852       注意してください。
 853       <strong>既に存在するファイルのサイズや日付のスタンプが変化しても、
 854       全ての Unix プラットホームでは、
 855       <code>Last-Modified</code> ヘッダーを更新しません。</strong>
 856       もしこれが重要であれば、
 857       このオプションを無効のままにしてください。</dd>
 858
 859       <dt><a name="indexoptions.versionsort" id="indexoptions.versionsort">VersionSort</a>
 860       (<em>Apache 2.0a3 以降</em>)</dt>
 861
 862       <dd><code>VersionSort</code> キーワードはバージョン番号を含んだファイルが
 863       自然な方法でソートされるようにします。
 864       文字列は通常通りソートされ、
 865       それ以外の、説明や名前中の数となる部分文字列は
 866       その数値で比較されます。
 867
 868       <div class="example"><h3>例:</h3><p><code>
 869         foo-1.7<br />
 870         foo-1.7.2<br />
 871         foo-1.7.12<br />
 872         foo-1.8.2<br />
 873         foo-1.8.2a<br />
 874         foo-1.12
 875       </code></p></div>
 876
 877       <p>番号が 0 から始まる場合は、端数と考えられます</p>
 878
 879       <div class="example"><p><code>
 880         foo-1.001<br />
 881         foo-1.002<br />
 882         foo-1.030<br />
 883         foo-1.04
 884       </code></p></div>
 885       </dd>
 886
 887       <dt><a name="indexoptions.xhtml" id="indexoptions.xhtml">XHTML</a>
 888       (<em>Apache 2.0.49 以降</em>)</dt>
 889
 890       <dd><code>XHTML</code> キーワードを指定すると、<code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>
 891       は HTML 3.2 の代わりに XHTML 1.0 のコードを出力するようになります。</dd>
 892     </dl>
 893
 894
 895    <dl><dt>増減指定できる IndexOptions</dt>
 896    <dd>
 897      <p>Apache 1.3.3 では、
 898      <code class="directive">IndexOptions</code>
 899      ディレクティブの扱いで幾つかの大きな変化が導入されました。
 900      特に、</p>
 901
 902      <ul>
 903      <li>一つのディレクトリに対する複数の
 904      <code class="directive">IndexOptions</code>
 905      ディレクティブは、現在では一つにマージされます。
 906
 907      <div class="example"><p><code>
 908        &lt;Directory /foo&gt;
 909        <span class="indent">
 910          IndexOptions HTMLTable<br />
 911          IndexOptions SuppressColumnsorting
 912        </span>
 913        &lt;/Directory&gt;
 914      </code></p></div>
 915
 916      <p>の結果は、次の指定と同一の結果になります。</p>
 917
 918      <div class="example"><p><code>
 919        IndexOptions HTMLTable SuppressColumnsorting
 920      </code></p></div>
 921      </li>
 922
 923      <li>増減構文
 924      (<em>すなわち</em>、'+' や '-'
 925      の接頭辞が付くキーワード) の追加。</li>
 926      </ul>
 927
 928      <p>'+' や '-' 接頭辞の付いたキーワードに出会うとそれは、
 929      その時点での <code class="directive">IndexOptions</code>
 930      の設定 (これは上流のディレクトリを受け継ぎます)
 931      に対して適応されます。
 932      しかしながら、接頭辞の付かないキーワードが処理された場合は、
 933      受け継いだオプション全てとそれまで出会った増減設定全てが
 934      消去されます。次の例を考えてみてください:</p>
 935
 936      <div class="example"><p><code>
 937        IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
 938        IndexOptions +SuppressSize
 939      </code></p></div>
 940
 941      <p>最終的な効果は
 942      <code>IndexOptions&nbsp;FancyIndexing&nbsp;+SuppressSize</code>
 943      と同一です。
 944      接頭辞の付かない <code>FancyIndexing</code>
 945      でそれ以前の増減キーワードは無効になり、
 946      その後の累積が始まるからです。</p>
 947
 948      <p>あるディレクトリにおいて上位のディレクトリに指定された設定に影響されることなく
 949      <code class="directive">IndexOptions</code> を設定したい場合、
 950      <code>+</code> や <code>-</code>
 951      接頭辞の付かないキーワードで設定してください。</p>
 952    </dd>
 953    </dl>
 954
 955 </div>
 956 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 957 <div class="directive-section"><h2><a name="IndexOrderDefault" id="IndexOrderDefault">IndexOrderDefault</a> <a name="indexorderdefault" id="indexorderdefault">ディレクティブ</a></h2>
 958 <table class="directive">
 959 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>
 960 ディレクトリインデックスの標準の順番付けを設定</td></tr>
 961 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>IndexOrderDefault Ascending|Descending
 962 Name|Date|Size|Description</code></td></tr>
 963 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>IndexOrderDefault Ascending Name</code></td></tr>
 964 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 965 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 966 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 967 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
 968 </table>
 969     <p><code class="directive">IndexOrderDefault</code> ディレクティブは
 970     <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>
 971     インデックスオプションと併せて用いられます。
 972     デフォルトでは、FancyIndexing
 973     のディレクトリ一覧はファイル名の昇順で表示されます。
 974     <code class="directive">IndexOrderDefault</code>
 975     で、初期状態の表示順番を変えることができます。</p>
 976
 977     <p><code class="directive">IndexOrderDefault</code>
 978     は二つの引数をとります。一つ目はソートの方向を指示する
 979     <code>Ascending</code> か <code>Descending</code> のいずれかです。
 980     二つ目の引数は <code>Name</code>, <code>Date</code>,
 981     <code>Size</code> か <code>Description</code>
 982     のいずれか一つのキーワードであって、1つ目のソートキーを指定します。
 983     2つ目のソートキーは<em>常に</em>ファイル名の昇順になります。</p>
 984
 985     <p>このディレクティブと <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
 986     インデックスオプションとを組み合わせることで、
 987     ディレクトリ一覧をある特定の順番でのみ表示するようにできます。
 988     これは、
 989     クライアントが別の順番でディレクトリ一覧をリクエストすることを防ぎます。</p>
 990
 991 </div>
 992 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 993 <div class="directive-section"><h2><a name="IndexStyleSheet" id="IndexStyleSheet">IndexStyleSheet</a> <a name="indexstylesheet" id="indexstylesheet">ディレクティブ</a></h2>
 994 <table class="directive">
 995 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディレクトリインデックスに CSS スタイルシートを追加する</td></tr>
 996 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>IndexStyleSheet <var>url-path</var></code></td></tr>
 997 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
 998 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
 999 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
1000 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
1001 </table>
1002     <p><code class="directive">IndexStyleSheet</code> ディレクティブは
1003     インデックス表示に使用される CSS のファイル名を設定します。
1004     </p>
1005     <div class="example"><h3>例</h3><p><code>
1006
1007       IndexStyleSheet "/css/style.css"
1008     </code></p></div>
1009
1010 </div>
1011 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1012 <div class="directive-section"><h2><a name="ReadmeName" id="ReadmeName">ReadmeName</a> <a name="readmename" id="readmename">ディレクティブ</a></h2>
1013 <table class="directive">
1014 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>インデックス一覧の最後に挿入されるファイルの名前</td></tr>
1015 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ReadmeName <var>filename</var></code></td></tr>
1016 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1017 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Indexes</td></tr>
1018 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
1019 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_autoindex</td></tr>
1020 </table>
1021     <p><code class="directive">ReadmeName</code> ディレクティブは、
1022     インデックスの終わりに付け加えられるファイルの名前を設定します。
1023     <var>filename</var> は挿入するファイルの名前で、
1024     一覧の行われている位置から相対的なものとして解釈されます。
1025     <var>filename</var> がスラッシュで始まる場合は、
1026     <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
1027     からの相対パスとなります。</p>
1028
1029     <div class="example"><h3>例</h3><p><code>
1030       ReadmeName FOOTER.html
1031     </code></p></div>
1032
1033     <div class="example"><h3>例 2</h3><p><code>
1034     ReadmeName /include/FOOTER.html
1035     </code></p></div>
1036
1037     <p>より詳細にまでこの挙動について記述している <code class="directive"><a href="#headername">HeaderName</a></code>
1038     もご覧下さい。</p>
1039
1040 </div>
1041 </div>
1042 <div class="bottomlang">
1043 <p><span>言語: </span><a href="../en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
1044 <a href="../fr/mod/mod_autoindex.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
1045 <a href="../ja/mod/mod_autoindex.html" title="Japanese">&nbsp;ja&nbsp;</a> |
1046 <a href="../ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
1047 <a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
1048 </div><div id="footer">
1049 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
1050 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div>
1051 </body></html>