Apache モジュール mod_autoindex

この日本語訳はすでに古くなっている 可能性があります。 最近更新された内容を見るには英語版をご覧下さい。

説明:	Unix の ls コマンドや Win32 の dir シェルコマンドに似た ディレクトリインデックスを生成する
ステータス:	Base
モジュール識別子:	autoindex_module
ソースファイル:	mod_autoindex.c

概要

ディレクトリのインデックスは二つの情報源のうちの 一つから生成できます:

• 普通は index.html と呼ばれる ユーザによって書かれたファイル。 DirectoryIndex ディレクティブでこのファイル名を設定します。 これは mod_dir で制御されます。
• もしくは、サーバによって生成された一覧。 その他のディレクティブでこの一覧の書式を制御します。 AddIcon, AddIconByEncoding と AddIconByType を使うことで、様々なファイルタイプに対してアイコン一覧を セットします。つまり、リストされたファイル毎に、 ファイルにマッチした一番最初のアイコンが表示されます。 これらは mod_autoindex で制御されます。

望むならば、自動インデックス生成を完全に除去 (あるいは置換) できるように、この二つの機能は分離されています。

自動インデックス生成は Options +Indexes を使うことで有効になります。詳細については、 Options ディレクティブをご覧下さい。

もし FancyIndexingオプションが IndexOptions ディレクティブに与えられているならば、 列の先頭は表示の順番を制御するリンクになります。 先頭のリンクを選択すると、一覧は再生成されて その列の値でソートされます。 同じ先頭を続けて選択すると、交互に昇順と降順とになります。 これらの列の先頭のリンクは、 IndexOptions ディレクティブの SuppressColumnSorting オプションで消すことができます。

"Size" でソートした場合は、用いられるのは 実際のファイルのサイズであって、 表示の値ではないことに注意してください - たとえ両方ともが "1K" と表示されていたとしても、 1010 バイトのファイルは必ず 1011 バイトのファイルよりも前 (昇順の場合) に表示されます。

Autoindex リクエストクエリー引数

Apache 2.0.23 で、 コラムソートのためにクエリー引数を再編成して、 新しいクエリーオプションのグループを導入しました。 出力に対するクライアントのすべての制御を効率的に抹消 できるように、 IndexOptions IgnoreClient が導入されました。

コラムソートのヘッダそれ自体が、 下記のソートクエリーオプションを付加する 自分自身を参照するリンクです。 下記のオプションのどれでも、 ディレクトリリソースへのリクエストに加えることができます。

• C=N は、ファイル名でソートします。
• C=M は、更新日時、 ディレクトリ、ファイル名の順でソートします。
• C=S は、サイズ、 ディレクトリ、ファイル名の順でソートします。
• C=D は、説明、 ディレクトリ、ファイル名の順でソートします。
• O=A は、昇順で表をソートします。
• O=D は、降順で表をソートします。
• F=0 は、単純な表の書式にします。 (FancyIndex ではありません。)
• F=1 は、FancyIndex 表示の表の書式にします。
• F=2 は、表を HTML のテーブルを使った FancyIndex の書式にします。
• V=0 は、バージョンによるソートを無効にします。
• V=1 は、バージョンによるソートを有効にします。
• P=pattern は、与えられた pattern に適合したファイルのみを表示します。

"P (パターンの P)" クエリー引数は、 通常の IndexIgnore ディレクティブが処理された後に検査され、 ファイル名全てが、他の autoindex リスト処理と同様の判定基準下に置かれ続ける ことに注意してください。 mod_autoindex のクエリー引数パーサ (解析) は、 認識不能なオプションにぶつかると即座に停止します。 クエリー引数は上の表に従って 正しい形式になっていなければなりません。

下の単純な例は、これらのクエリーオプションを 表します。これをそのまま切り取って HEADER.html ファイルに保存することもできます。 mod_autoindex が X=Go 入力にぶつかる前に 引数が全て解釈されるように、 未知の引数 "X" はリストの最後に置かれています。

<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>

AddAlt ディレクティブ

説明:	アイコンの代わりに 表示される、ファイル名で選択された代替テキスト
構文:	AddAlt string file [file] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

AddAlt は、FancyIndexing において、アイコンの代わりに表示する代替テキストを提供します。 file は、説明するファイルのファイル拡張子、 ファイル名の一部、ワイルドカード表現、完全なファイル名の どれかになります。 string に空白がある場合は引用符 (" か ') で囲む必要があります。 この文字列は、クライアントが画像を表示できない場合や 画像のロードを無効にしている場合や アイコンの取得に失敗したときに表示されます。

AddAltByEncoding ディレクティブ

説明:	アイコンの代わりに表示される、MIME 符号化方法で選択された 代替テキスト
構文:	AddAltByEncoding string MIME-encoding [MIME-encoding] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

AddAltByEncoding は、 FancyIndexing において、アイコンの代わりに表示する代替文字列を提供します。 MIME-encoding は有効な符号化、例えば x-compress です。 string に空白があるときは、引用符 (" か ') で囲む必要があります。 この文字列は、クライアントが画像を表示できない場合や 画像のロードを無効にしている場合や アイコンの取得に失敗したときに表示されます。

AddAltByType ディレクティブ

説明:	アイコンの代わりに 表示される、MIME タイプで選択された代替テキスト
構文:	AddAltByType string MIME-type [MIME-type] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

AddAltByType は、 FancyIndexing において、アイコンの代わりに表示する代替文字列を設定します。 MIME-type は有効なタイプ、例えば text/html です。 string に空白があるときは、引用符 (" か ') で囲む必要があります。 この文字列は、クライアントが画像を表示できない場合や 画像のロードを無効にしている場合や アイコンの取得に失敗したときに表示されます。

AddDescription ディレクティブ

説明:	ファイルに対して表示する説明
構文:	AddDescription string file [file] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

FancyIndexing において、ファイルに対して表示する説明を設定します。 file は説明するファイルのファイル拡張子、 ファイル名の一部、ワイルドカード表現、完全なファイル名の どれかになります。 string は二重引用符 (") で囲まれます。

通常のデフォルトの説明領域は 23 バイトの幅です。 IndexOptions SuppressIcon オプションで 6 バイト追加、 IndexOptions SuppressSize オプションで 7 バイト追加、 IndexOptions SuppressLastModified オプションで 19 バイト追加されます。 ですから、デフォルトの説明コラムの最大幅は 55 バイトになります。

このコラムの大きさを上書きしたり、 説明が無制限長でもよいようにするための詳細に関しては、 DescriptionWidth という IndexOptions のキーワードをご覧下さい。

AddIcon ディレクティブ

説明:	ファイルに表示するアイコンを名前で選択
構文:	AddIcon icon name [name] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

FancyIndexing において、 name で終わるファイルの隣に表示するアイコンを設定します。 icon は、(% でエスケープされた) アイコンへの相対 URL か、他の書式 (alttext, url) です。 ここで alttext は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。

name は、ディレクトリに対応する ^^DIRECTORY^^ か、空白行に対応する ^^BLANKICON^^ (一覧が正しく表示されるために) か、 ファイル拡張子か、ワイルドカード表現か、ファイル名の一部か 完全なファイル名です。

もし可能なら、 AddIcon より AddIconByType を優先的に使うべきでしょう。

AddIconByEncoding ディレクティブ

説明:	ファイルに表示するアイコンを MIME 符号化方法で選択
構文:	AddIconByEncoding icon MIME-encoding [MIME-encoding] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

FancyIndexing において、ファイルの隣に表示するアイコンを設定します。 icon は、(% でエスケープされた) アイコンへの相対 URL か、他の書式 (alttext, url) です。 ここで alttext は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。

MIME-encoding は、有効なコンテントエンコーディング、 例えば x-compressです。

AddIconByType ディレクティブ

説明:	ファイルの隣に表示するアイコンを MIME タイプによって選択
構文:	AddIconByType icon MIME-type [MIME-type] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

FancyIndexing において、ファイルの隣に表示するアイコンを設定します。 icon は、(% でエスケープされた) アイコンへの相対 URL か、他の書式 (alttext, url) です。 ここで alttext は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。

MIME-type は、要求されたタイプに該当する ワイルドカード表現です。

DefaultIcon ディレクティブ

説明:	特定のアイコンが何も設定されていない時に ファイルに表示するアイコン
構文:	DefaultIcon url-path
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

FancyIndexing において、 特定のアイコンがない場合にファイルに表示するアイコンを設定します。 url-path は、(% でエスケープされた) アイコンへの相対 URL です。

HeaderName ディレクティブ

説明:	インデックス一覧の先頭に挿入されるファイルの名前
構文:	HeaderName filename
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

HeaderName ディレクティブは、 インデックス一覧の先頭に挿入するファイルの名前を設定します。 Filename は取り込むファイルの名前です。

もし HeaderName で指定されたファイルが HTML ドキュメントの開始部分 (<html>, <head>, 等) を含んでいたら、 IndexOptions +SuppressHTMLPreamble を設定して、これらのタグが繰り返されないようにしたいと思うでしょう。

IndexHeadInsert ディレクティブ

説明:	インデックスページの HEAD セクションにテキストを挿入する
構文:	IndexHeadInsert "markup ..."
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

IndexHeadInsert ディレクティブを使って インデックスとして生成されたHTMLの <head> セクションに 挿入する文字列を指定します。

IndexIgnore ディレクティブ

説明:	ディレクトリ一覧を行なう際に無視すべき ファイルリストに追加
構文:	IndexIgnore file [file] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

IndexIgnore ディレクティブは、 ディレクトリの一覧を行う際に無視すべきファイルリストに追加します。 file は、 シェル形式のワイルドカード表現か完全なファイル名です。 IndexIgnore が複数ある場合は、無視するリストに追加が行われ、 置換は行われません。デフォルトではリストには . (カレントディレクトリ) が含まれています。

IndexIgnore README .htaccess *.bak *~

IndexOptions ディレクティブ

説明:	ディレクトリインデックスの様々な設定項目
構文:	IndexOptions [+|-]option [[+|-]option] ...
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

IndexOptions は、ディレクトリインデックスの挙動を指定します。 option は次のどれかです:

Charset=character-set (Apache 2.0.61 以降)

Charset キーワードで、 生成されるページの文字セットを指定できます。 下位のファイルシステムが Unicode ベースかどうかに依存しますが、 デフォルト値は ISO-8859-1 か UTF-8 になります。

Example:

IndexOptions Charset=UTF-8

Type=MIME content-type (Apache 2.0.61 以降)

Type キーワードで、 生成されるページの MIME コンテントタイプを指定できます。 デフォルト値は text/html になります。

Example:

IndexOptions Type=text/plain

DescriptionWidth=[n | *] (2.0.23 以降)

DescriptionWidth キーワードは説明コラムの幅を文字数で指定することができます。

-DescriptionWidth (または非設定) で、 mod_autoindex が最適な幅を計算するようにできます。

DescriptionWidth=n で、コラム幅を n バイトに固定します。

DescriptionWidth=* は、最長の説明に合わせて必要な長さまでコラムを延ばします。

説明を丸め込んだ場合特有の危険については AddDescription セクションをお読み下さい。

FancyIndexing

飾り付きインデックスをオンにします。

FoldersFirst (2.0.23 以降)

このオプションが有効になった場合、サブディレクトリの一覧は 必ず最初に現われて、通常のファイルはその後に続きます。 一覧は基本的には、ファイルとディレクトリの二つの部分に分けられて、 それぞれは別々にソートされ、その後サブディレクトリを先にして 表示が行なわれます。例えばソート順が名前の降順になっていて、 FoldersFirst が有効になっている場合は、 サブディレクトリ Zed はサブディレクトリ Beta よりも前にリストされ、通常のファイル Gamma や Alpha よりも前にリストされます。このオプションは FancyIndexing も有効になっているときにのみ有効です。

HTMLTable (実験的、 Apache 2.0.23 以降)

この実験的なオプションは FancyIndexing とともに指定することで、 飾りの付いたディレクトリ一覧のためにテーブルを使った単純な表を作ります。 これは古いブラウザを混乱させるかもしれないことに注意してください。 WinNT やその他 utf-8 が有効なプラットホームのように、ファイル名や説明テキストが 右読みになったり左読みになりえる場合は特に必要です。

IconsAreLinks

これは、FancyIndexing において、 アイコンもファイル名へのリンクの一部にします。

IconHeight[=pixels]

このオプションが、IconWidth とともに 使われている場合は、サーバはファイルアイコンのための img タグに height と width 属性を取り込むようになります。 これによって、イメージ全てをロードし終わるまで待たなくても、 ブラウザはページレイアウトをあらかじめ計算することができます。 このオプションに何も値が与えられなければ、Apache ソフトウェアで提供されているアイコンの標準の高さが デフォルトなります。

IconWidth[=pixels]

このオプションが、IconHeight とともに使われている場合は、 サーバはファイルアイコンのための img タグに height と width 属性を取り込むようになります。 これによって、イメージ全てをロードし終わるまで待たなくても、 ブラウザはページレイアウトをあらかじめ計算することができます。 このオプションに何も値が与えられなければ、Apache ソフトウェアで提供されているアイコンの標準の高さが デフォルトなります。

IgnoreCase

このオプションが有効であると、ファイル名は大文字小文字を区別せずにソートされます。 例えばファイル名が昇順でソートされ、IgnoreCase が有効であれば、 Zeta は alfa の後にリストされます (注意: GAMMA は常に gamma の前になります)。

IgnoreClient

このオプションで mod_autoindex は、 クライアントからの全てのクエリー変数を無視するようになります。 これはソート順も含みます。 (つまり SuppressColumnSorting も有効になります。)

NameWidth=[n | *]

NameWidth キーワードでファイル名コラムの幅をバイト数で 指定できます。

-NameWidth (または非設定) で、 mod_autoindex が最適な幅を計算するようにできます。

NameWidth=n で、コラム幅を n バイトに固定します。

NameWidth=* は、必要な長さまでコラムを延ばします。

ScanHTMLTitles

FancyIndexing のために、 HTML ドキュメントからタイトルを取り出すことを可能にします。 もしファイルに AddDescription で説明が与えられていなければ、 httpd は title タグの値を読むためにドキュメントを読み始めます。 これは CPU や disk に負荷をかけます。

ShowForbidden

通常 Apache はサブリクエストの結果がHTTP_UNAUTHORIZED や HTTP_FORBIDDEN のファイルは一覧に表示しません。 このオプションを指定すると、そのようなファイルも一覧に表示します。

SuppressColumnSorting

もし指定されていれば、Apache は FancyIndexing で表示されているディレクトリ一覧での コラムの先頭を、ソートのためのリンクにしなくなります。 デフォルトの挙動は、リンクとします。 コラムの先頭を選ぶとコラムの値に従ってディレクトリリストを ソートします。 Apache 2.0.23 以前では、これは同時に ソート文字列のためのクエリー引数の解析も無効にします。 この挙動は Apache 2.0.23 では IndexOptions IgnoreClient で制御されるようになっています。

SuppressDescription

これは FancyIndexing におけるファイルの説明を消去します。 デフォルトでは、説明は定義されておらず、 このオプションを使うと他のために 23 文字の空白を稼ぐことができます。 ファイルの説明に関する情報は、 AddDescription をご覧下さい。また、説明のコラムサイズを制限する DescriptionWidth インデックスオプションもご覧下さい。

SuppressHTMLPreamble

通常、 HeaderName ディレクティブで指定したファイルを ディレクトリが実際に含んでいれば、標準的な HTML プリアンブル (<html>, <head>, 等) の後に、 モジュールはファイルの中身をインクルードします。 SuppressHTMLPreamble オプションは、 この挙動を無効にできて、 モジュールがヘッダーファイルの中身から表示を始めます。 この場合、ヘッダーファイルは正しい HTML 命令を含んでいなければなりません。 ヘッダーファイルが存在しない場合は、プリアンブルは通常通り 生成されます。

SuppressIcon (Apache 2.0.23 以降)

これは FancyIndexing の一覧からアイコンを消去します。 SuppressIcon と SuppressRules と組合わせることによって正しい HTML 3.2 の出力が得られます。 HTML 3.2 の最終規格は、 img と hr が pre ブロックに入る (FancyIndexing 一覧で書式に使われています) ことを禁止しています。

SuppressLastModified

FancyIndexing 一覧において最終更新日時の表示を消去します。

SuppressRules (Apache 2.0.23 以降)

ディレクトリ一覧において水平区切り線 (hr タグ) を消去します。 SuppressIcon と SuppressRules と組合わせることによって正しい HTML 3.2 の出力が得られます。 HTML 3.2 の最終規格は、 img と hr が pre ブロックに入る (FancyIndexing 一覧で書式に使われています) ことを禁止しています。

SuppressSize

FancyIndexing 一覧においてファイルサイズの表示を消去します。

TrackModified (Apache 2.0.23 以降)

これは HTTP ヘッダ中に、 ディレクトリの Last-Modified や ETag を含めます。 これは、オペレーティングシステムやファイルシステムが 適切な stat() の返り値を返す場合にのみ有効です。 いくつかの UNIX システム、OS2 の JFS や Win32 の NTFS ボリュームはそうなっています。 例えば、OS2 と Win32 FAT ボリュームはそうではありません。 この機能が有効になると、クライアントやプロキシは HEAD リクエストを行うことによって、 ファイル一覧の変化を追跡することができるようになります。 オペレーティングシステムによっては、新規ファイルや 移動ファイルは正しく追跡するけれども、 ディレクトリ中のファイルのサイズや日付は追跡しないということに 注意してください。 既に存在するファイルのサイズや日付のスタンプが変化しても、 全ての Unix プラットホームでは、 Last-Modified ヘッダーを更新しません。 もしこれが重要であれば、 このオプションを無効のままにしてください。

VersionSort (Apache 2.0a3 以降)

VersionSort キーワードはバージョン番号を含んだファイルが 自然な方法でソートされるようにします。 文字列は通常通りソートされ、 それ以外の、説明や名前中の数となる部分文字列は その数値で比較されます。

例:

foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12

番号が 0 から始まる場合は、端数と考えられます

foo-1.001
foo-1.002
foo-1.030
foo-1.04

XHTML (Apache 2.0.49 以降)

XHTML キーワードを指定すると、mod_autoindex は HTML 3.2 の代わりに XHTML 1.0 のコードを出力するようになります。

増減指定できる IndexOptions

Apache 1.3.3 では、 IndexOptions ディレクティブの扱いで幾つかの大きな変化が導入されました。 特に、

• 一つのディレクトリに対する複数の IndexOptions ディレクティブは、現在では一つにマージされます。

  <Directory /foo> IndexOptions HTMLTable
IndexOptions SuppressColumnsorting </Directory>

  の結果は、次の指定と同一の結果になります。

  IndexOptions HTMLTable SuppressColumnsorting

• 増減構文 (すなわち、'+' や '-' の接頭辞が付くキーワード) の追加。

'+' や '-' 接頭辞の付いたキーワードに出会うとそれは、 その時点での IndexOptions の設定 (これは上流のディレクトリを受け継ぎます) に対して適応されます。 しかしながら、接頭辞の付かないキーワードが処理された場合は、 受け継いだオプション全てとそれまで出会った増減設定全てが 消去されます。次の例を考えてみてください:

IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize

最終的な効果は IndexOptions FancyIndexing +SuppressSize と同一です。 接頭辞の付かない FancyIndexing でそれ以前の増減キーワードは無効になり、 その後の累積が始まるからです。

あるディレクトリにおいて上位のディレクトリに指定された設定に影響されることなく IndexOptions を設定したい場合、 + や - 接頭辞の付かないキーワードで設定してください。

IndexOrderDefault ディレクティブ

説明:	ディレクトリインデックスの標準の順番付けを設定
構文:	IndexOrderDefault Ascending|Descending Name|Date|Size|Description
デフォルト:	IndexOrderDefault Ascending Name
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

IndexOrderDefault ディレクティブは FancyIndexing インデックスオプションと併せて用いられます。 デフォルトでは、FancyIndexing のディレクトリ一覧はファイル名の昇順で表示されます。 IndexOrderDefault で、初期状態の表示順番を変えることができます。

IndexOrderDefault は二つの引数をとります。一つ目はソートの方向を指示する Ascending か Descending のいずれかです。 二つ目の引数は Name, Date, Size か Description のいずれか一つのキーワードであって、1つ目のソートキーを指定します。 2つ目のソートキーは常にファイル名の昇順になります。

このディレクティブと SuppressColumnSorting インデックスオプションとを組み合わせることで、 ディレクトリ一覧をある特定の順番でのみ表示するようにできます。 これは、 クライアントが別の順番でディレクトリ一覧をリクエストすることを防ぎます。

IndexStyleSheet ディレクティブ

説明:	ディレクトリインデックスに CSS スタイルシートを追加する
構文:	IndexStyleSheet url-path
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

IndexStyleSheet ディレクティブは インデックス表示に使用される CSS のファイル名を設定します。

ReadmeName ディレクティブ

説明:	インデックス一覧の最後に挿入されるファイルの名前
構文:	ReadmeName filename
コンテキスト:	サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
上書き:	Indexes
ステータス:	Base
モジュール:	mod_autoindex

ReadmeName ディレクティブは、 インデックスの終わりに付け加えられるファイルの名前を設定します。 filename は挿入するファイルの名前で、 一覧の行われている位置から相対的なものとして解釈されます。 filename がスラッシュで始まる場合は、 DocumentRoot からの相対パスとなります。

より詳細にまでこの挙動について記述している HeaderName もご覧下さい。