mod_autoindex.html revision 4ed1b0d51faaa03eab8a00036dd0f7a829811adc
bcb4e51a409d94ae670de96afb8483a4f7855294Stephan Bosch<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen BGCOLOR="#FFFFFF"
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen TEXT="#000000"
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen LINK="#0000FF"
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen VLINK="#000080"
7a60e1dc9e93ef3f7c7fe1af6385a0bfa1e31bc3Timo Sirainen ALINK="#FF0000"
c4c8182e19f1a74706473ee88aa4701458ea5b1dTimo Sirainen<!--#include virtual="header.html" -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis module is contained in the <code>mod_autoindex.c</code> file, and
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenis compiled in by default. It provides for automatic directory indexing.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThe index of a directory can come from one of two sources:
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<li>A file written by the user, typically called <code>index.html</code>.
a175496735a7a4c9536cdc217c1c9990c1df81c1Timo SirainenThe <A HREF="mod_dir.html#directoryindex">DirectoryIndex</A> directive sets
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainenthe name of this file.
a175496735a7a4c9536cdc217c1c9990c1df81c1Timo SirainenThis is controlled by <a href="mod_dir.html"><code>mod_dir</code></a>.
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<li>Otherwise, a listing generated by the server. The other directives
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainencontrol the format of this listing. The <A HREF="#addicon">AddIcon</A>,
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<A HREF="#addiconbyencoding">AddIconByEncoding</A> and
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<A HREF="#addiconbytype">AddIconByType</A> are used to set a list of
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainenicons to display for various file types; for each file listed, the
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenfirst icon listed that matches the file is displayed. These
0dffa25d211be541ee3c953b23566a1a990789dfTimo SirainenThe two functions are separated so that you can completely remove
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen(or replace) automatic index generation should you want to.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<li><A HREF="#addaltbyencoding">AddAltByEncoding</A>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<li><A HREF="#adddescription">AddDescription</A>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<li><A HREF="#addiconbyencoding">AddIconByEncoding</A>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt AddAlt} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> AddAlt <em>string file file...</em><br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis sets the alternate text to display for a file, instead of an icon, for
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<A HREF="#fancyindexing">FancyIndexing</A>. <em>File</em> is a file
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenextension, partial filename, wild-card expression or full filename for files
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainento describe. <em>String</em> is enclosed in double quotes
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen(<code>"</code>). This alternate text is displayed if the client is
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenimage-incapable or has image loading disabled.
ab90f702ceedb7ba445a9a592be0b213b27cbafaStephan Bosch<A name="addaltbyencoding"><h2>AddAltByEncoding</h2></A>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt AddAltByEncoding} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> AddAltByEncoding <em>string MIME-encoding
191153d1a5b0eb0c129139570e3aa5212f28d2acJosef 'Jeff' Sipek<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo SirainenThis sets the alternate text to display for a file, instead of an icon, for
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen<A HREF="#fancyindexing">FancyIndexing</A>. <em>MIME-encoding</em> is a
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainenvalid content-encoding, such as <SAMP>x-compress</SAMP>.
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen(<code>"</code>). This alternate text is displayed if the client is
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainenimage-incapable or has image loading disabled.
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen<A name="addaltbytype"><h2>AddAltByType</h2></A>
7891c8e6debdcfec552cb1beea2a0230fe89957bTimo Sirainen<!--%plaintext <?INDEX {\tt AddAltByType} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> AddAltByType <em>string MIME-type MIME-type...</em><br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo SirainenThis sets the alternate text to display for a file, instead of an icon, for
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<A HREF="#fancyindexing">FancyIndexing</A>. <em>MIME-type</em> is a
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainenvalid content-type, such as <SAMP>text/html</SAMP>.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen(<code>"</code>). This alternate text is displayed if the client is
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenimage-incapable or has image loading disabled.
5f1d689131a75c39f064cbd4202373e7edf78f18Josef 'Jeff' Sipek<A name="adddescription"><h2>AddDescription</h2></A>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt AddDescription} directive> -->
be5773cb4d6edae8a5d9f300c3c7375cdd33826eJosef 'Jeff' Sipek<strong>Syntax:</strong> AddDescription <em>string file file...</em><br>
be5773cb4d6edae8a5d9f300c3c7375cdd33826eJosef 'Jeff' Sipek<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis sets the description to display for a file, for
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<A HREF="#fancyindexing">FancyIndexing</A>. <em>File</em> is a file
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenextension, partial filename, wild-card expression or full filename for files
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainento describe. <em>String</em> is enclosed in double quotes
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<blockquote><code>AddDescription "The planet Mars" /web/pics/mars.gif
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt AddIcon} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> AddIcon <em>icon name name ...</em><br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis sets the icon to display next to a file ending in <em>name</em> for
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<A HREF="#fancyindexing">FancyIndexing</A>. <em>Icon</em> is either a
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen(%-escaped) relative URL to the icon, or of the format
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen(<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag given
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenfor an icon for non-graphical browsers.<p>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<em>Name</em> is either ^^DIRECTORY^^ for directories, ^^BLANKICON^^ for
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenblank lines (to format the list correctly), a file extension, a wildcard
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenexpression, a partial filename or a complete filename. Examples:
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenAddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm <br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<A HREF="#addiconbytype">AddIconByType</A> should be used in preference to
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<A name="addiconbyencoding"><h2>AddIconByEncoding</h2></A>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<!--%plaintext <?INDEX {\tt AddIconByEncoding} directive> -->
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<strong>Syntax:</strong> AddIconByEncoding <em>icon mime-encoding mime-encoding
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo SirainenThis sets the icon to display next to files with
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<em>mime-encoding</em> for <A HREF="#fancyindexing">FancyIndexing</A>.
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<em>Icon</em> is either a (%-escaped) relative URL to the icon, or of the
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainenformat (<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag
a75d470c9223a75801418fcdda258885c36317e0Timo Sirainengiven for an icon for non-graphical browsers.<p>
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen<em>Mime-encoding</em> is a wildcard expression matching required the
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainencontent-encoding. Examples:
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo SirainenAddIconByEncoding /icons/compress.xbm x-compress
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<A name="addiconbytype"><h2>AddIconByType</h2></A>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<!--%plaintext <?INDEX {\tt AddIconByType} directive> -->
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<strong>Syntax:</strong> AddIconByType <em>icon mime-type mime-type ...</em><br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo SirainenThis sets the icon to display next to files of type <em>mime-type</em> for
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<A HREF="#fancyindexing">FancyIndexing</A>. <em>Icon</em> is either a
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen(%-escaped) relative URL to the icon, or of the format
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen(<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag given
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainenfor an icon for non-graphical browsers.<p>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<em>Mime-type</em> is a wildcard expression matching required the mime types.
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainen<!--%plaintext <?INDEX {\tt DefaultIcon} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> DefaultIcon <em>url</em><br>
a75d470c9223a75801418fcdda258885c36317e0Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo SirainenThe DefaultIcon directive sets the icon to display for files when no
871c55e1dc8e7f84dced2e9b22225d261747bb63Timo Sirainenspecific icon is known, for <A HREF="#fancyindexing">FancyIndexing</A>.
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<em>Url</em> is a (%-escaped) relative URL to the icon. Examples:
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<A name="fancyindexing"><h2>FancyIndexing</h2></A>
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<!--%plaintext <?INDEX {\tt FancyIndexing} directive> -->
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<strong>Syntax:</strong> FancyIndexing <em>boolean</em><br>
a75d470c9223a75801418fcdda258885c36317e0Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
f1dd517d17d5d294cd17fa32304714c22e617f87Timo SirainenThe FancyIndexing directive sets the FancyIndexing option for a directory.
e599fa1e10c2880627927750daa20c9c2f22612bTimo Sirainen<em>Boolean</em> can be <code>on</code> or <code>off</code>. The
e599fa1e10c2880627927750daa20c9c2f22612bTimo Sirainen<A HREF="#indexoptions">IndexOptions</A> directive should be used in
e599fa1e10c2880627927750daa20c9c2f22612bTimo Sirainen<!--%plaintext <?INDEX {\tt HeaderName} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> HeaderName <em>filename</em><br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThe HeaderName directive sets the name of the file that will be inserted
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenat the top of the index listing. <em>Filename</em> is the name of the file
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainento include, and is taken to be relative to the directory being indexed.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThe server first attempts to include <em>filename</em><code>.html</code>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenas an HTML document, otherwise it will include <em>filename</em> as plain
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainentext. Example:
7a60e1dc9e93ef3f7c7fe1af6385a0bfa1e31bc3Timo Sirainen<blockquote><code>HeaderName HEADER</code></blockquote>
9261dbf0675204898c6557591c7aa376e23a52b2Timo Sirainenwhen indexing the directory <code>/web</code>, the server will first look for
9261dbf0675204898c6557591c7aa376e23a52b2Timo Sirainenthe HTML file <code>/web/HEADER.html</code> and include it if found, otherwise
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenit will include the plain text file <code>/web/HEADER</code>, if it exists.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<p>See also <A HREF="#readmename">ReadmeName</A>.<p><hr>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt IndexIgnore} directive> -->
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<strong>Syntax:</strong> IndexIgnore <em>file file ...</em><br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThe IndexIgnore directive adds to the list of files to hide when listing
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainena directory. <em>File</em> is a file extension, partial filename,
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenwildcard expression or full filename for files to ignore. Multiple
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenIndexIgnore directives add to the list, rather than the replacing the list
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenof ignored files. By default, the list contains `<code>.</code>'. Example:
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenIndexIgnore README .htaccess *~
9261dbf0675204898c6557591c7aa376e23a52b2Timo Sirainen<A name="indexoptions"><h2>IndexOptions</h2></A>
9261dbf0675204898c6557591c7aa376e23a52b2Timo Sirainen<!--%plaintext <?INDEX {\tt IndexOptions} directive> -->
9261dbf0675204898c6557591c7aa376e23a52b2Timo Sirainen<strong>Syntax:</strong> IndexOptions <em>option option ...</em><br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo SirainenThe IndexOptions directive specifies the behavior of the directory indexing.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<dt>FancyIndexing
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<dd><!--%plaintext <?INDEX {\tt FancyIndexing} index option> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis turns on fancy indexing of directories.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<dt>IconsAreLinks
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<!--%plaintext <?INDEX {\tt IconsAreLinks} index option> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis makes the icons part of the anchor for the filename, for
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenfancy indexing.
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<dt>ScanHTMLTitles
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<dd><!--%plaintext <?INDEX {\tt ScanHTMLTitles} index option> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis enables the extraction of the title from HTML documents for fancy
7a60e1dc9e93ef3f7c7fe1af6385a0bfa1e31bc3Timo Sirainenindexing. If the file does not have a description given by
9261dbf0675204898c6557591c7aa376e23a52b2Timo Sirainen<A HREF="#adddescription">AddDescription</A> then httpd will read the
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainendocument for the value of the TITLE tag. This is CPU and disk intensive.
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<dt>SuppressLastModified
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<!--%plaintext <?INDEX {\tt SuppressLastModified} index option> -->
3b22894b8805b186c73d8b754001e8d7e944be85Timo SirainenThis will suppress the display of the last modification date, in fancy
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainenindexing listings.
3b22894b8805b186c73d8b754001e8d7e944be85Timo Sirainen<dt>SuppressSize
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt SuppressSize} index option> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThis will suppress the file size in fancy indexing listings.
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen<dt>SuppressDescription
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen<!--%plaintext <?INDEX {\tt SuppressDescription} index option> -->
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo SirainenThis will suppress the file description in fancy indexing listings.
5226c54b854ddb27f0004c73fcc2eb837c4efe53Timo Sirainen<dt>IconHeight[=pixels] (<EM>Apache 1.3 and later</EM>)
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainen<!--%plaintext <?INDEX {\tt IconHeight} index option> -->
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo SirainenPresence of this option, when used with IconWidth, will cause the server
bdb9f7f7fbf828fb85a393bd2803167b1bb8ff0dTimo Sirainento include <SAMP>HEIGHT</SAMP> and <SAMP>WIDTH</SAMP> attributes in the
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<SAMP>IMG</SAMP> tag for the file icon. This allows browser to
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenprecalculate the page layout without having to wait until all the
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenimages have been loaded. If no value is given for the option, it
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainendefaults to the standard height of the icons supplied with the Apache
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<dt>IconWidth[=pixels] (<EM>Apache 1.3 and later</EM>)
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt IconWidth} index option> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenPresence of this option, when used with IconHeight, will cause the server
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainento include <SAMP>HEIGHT</SAMP> and <SAMP>WIDTH</SAMP> attributes in the
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<SAMP>IMG</SAMP> tag for the file icon. This allows browser to
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenprecalculate the page layout without having to wait until all the
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenimages have been loaded. If no value is given for the option, it
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainendefaults to the standard width of the icons supplied with the Apache
c4c8182e19f1a74706473ee88aa4701458ea5b1dTimo SirainenThis default is that no options are enabled. If multiple IndexOptions
c4c8182e19f1a74706473ee88aa4701458ea5b1dTimo Sirainencould apply to a directory, then the most specific one is taken complete;
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenthe options are not merged. For example:
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenIndexOptions FancyIndexing <br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen</Directory><br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenIndexOptions ScanHTMLTitles <br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen</Directory>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenthen only <code>ScanHTMLTitles</code> will be set for the /web/docs/spec
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<!--%plaintext <?INDEX {\tt ReadmeName} directive> -->
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<strong>Syntax:</strong> ReadmeName <em>filename</em><br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThe ReadmeName directive sets the name of the file that will be appended
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainento the end of the index listing. <em>Filename</em> is the name of the file
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainento include, and is taken to be relative to the directory being indexed.
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo SirainenThe server first attempts to include <em>filename</em><code>.html</code>
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainenas an HTML document, otherwise it will include <em>filename</em> as plain
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainentext. Example:
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<blockquote><code>ReadmeName README</code></blockquote>
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainenwhen indexing the directory <code>/web</code>, the server will first look for
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainenthe HTML file <code>/web/README.html</code> and include it if found, otherwise
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainenit will include the plain text file <code>/web/README</code>, if it exists.
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<p>See also <A HREF="#headername">HeaderName</A>.<p>
f1dd517d17d5d294cd17fa32304714c22e617f87Timo Sirainen<!--#include virtual="footer.html" -->