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