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