<em>Icon</em> is either a (%-escaped) relative URL to the icon,    or of the format (<em>alttext</em>,<em>url</em>) where    <em>alttext</em> is the text tag given for an icon for    non-graphical browsers.</p>    <p><em>Name</em> is either ^^DIRECTORY^^ for directories,    ^^BLANKICON^^ for blank lines (to format the list correctly), a    file extension, a wildcard expression, a partial filename or a    complete filename. Examples:</p>    <blockquote>      <code>AddIcon (IMG,/icons/image2.gif) .gif .jpg .png<br />       AddIcon /icons/dir.gif ^^DIRECTORY^^<br />       AddIcon /icons/backup.gif *~</code>    </blockquote>    <a href="#addiconbytype">AddIconByType</a> should be used in    preference to AddIcon, when possible.     <hr />    <h2><a id="addiconbyencoding"    name="addiconbyencoding">AddIconByEncoding</a> directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> AddIconByEncoding    <em>icon MIME-encoding</em> [<em>MIME-encoding</em>] ...<br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex     <p>This sets the icon to display next to files with    <em>MIME-encoding</em> for <a    href="#fancyindexing">FancyIndexing</a>. <em>Icon</em> is    either a (%-escaped) relative URL to the icon, or of the format    (<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the    text tag given for an icon for non-graphical browsers.</p>    <p><em>Mime-encoding</em> is a wildcard expression matching    required the content-encoding. Examples:</p>    <blockquote>      <code>AddIconByEncoding /icons/compressed.gif      x-compress</code>    </blockquote>    <hr />    <h2><a id="addiconbytype"    name="addiconbytype">AddIconByType</a> directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> AddIconByType <em>icon    MIME-type</em> [<em>MIME-type</em>] ...<br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex     <p>This sets the icon to display next to files of type    <em>MIME-type</em> for <a    href="#fancyindexing">FancyIndexing</a>. <em>Icon</em> is    either a (%-escaped) relative URL to the icon, or of the format    (<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the    text tag given for an icon for non-graphical browsers.</p>    <p><em>Mime-type</em> is a wildcard expression matching    required the mime types. Examples:</p>    <blockquote>      <code>AddIconByType (IMG,/icons/image3.gif) image/*</code>    </blockquote>    <hr />    <h2><a id="defaulticon" name="defaulticon">DefaultIcon</a>    directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> DefaultIcon    <em>url</em><br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex     <p>The DefaultIcon directive sets the icon to display for files    when no specific icon is known, for <a    href="#fancyindexing">FancyIndexing</a>. <em>Url</em> is a    (%-escaped) relative URL to the icon. Examples:</p>    <blockquote>      <code>DefaultIcon /icon/unknown.xbm</code>    </blockquote>    <hr />    <h2><a id="fancyindexing"    name="fancyindexing">FancyIndexing</a> directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> FancyIndexing    on|off<br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex     <p>The FancyIndexing directive sets the FancyIndexing option    for a directory. The <a href="#indexoptions">IndexOptions</a>    directive should be used in preference.</p>    <blockquote>      <strong>Note that in versions of Apache prior to 1.3.2, the      <samp>FancyIndexing</samp> and <samp>IndexOptions</samp>      directives will override each other. You should use      <samp>IndexOptions&nbsp;FancyIndexing</samp> in preference to      the standalone <samp>FancyIndexing</samp> directive. As of      Apache 1.3.2, a standalone <samp>FancyIndexing</samp>      directive is combined with any <samp>IndexOptions</samp>      directive already specified for the current scope.</strong>    </blockquote>    <hr />    <h2><a id="headername" name="headername">HeaderName</a>    directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> HeaderName    <em>filename</em><br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex <br />     <a href="directive-dict.html#Compatibility"    rel="Help"><strong>Compatibility:</strong></a> some features    only available after 1.3.6; see text     <p>The HeaderName directive sets the name of the file that will    be inserted at the top of the index listing. <em>Filename</em>    is the name of the file to include.</p>      <p>      <em>Filename</em> is treated as a URI path relative to the      one used to access the directory being indexed. Note that this      means that if <em>Filename</em> starts with a slash, it will be      taken to be relative to the <a      href="core.html#documentroot">DocumentRoot</a>.</p>            <p><em>Filename</em> must      resolve to a document with a major content type of      "<samp>text</samp>" (<em>e.g.</em>, <samp>text/html</samp>,      <samp>text/plain</samp>, <em>etc.</em>). This means that      <em>filename</em> may refer to a CGI script if the script's      actual file type (as opposed to its output) is marked as      <samp>text/html</samp> such as with a directive like: </p><pre>    AddType text/html .cgi</pre>      <a href="../content-negotiation.html">Content negotiation</a>      will be performed if the <samp>MultiViews</samp> <a      href="core.html#options">option</a> is enabled. If      <em>filename</em> resolves to a static <samp>text/html</samp>      document (not a CGI script) and the <samp>Includes</samp> <a      href="core.html#options">option</a> is enabled, the file will      be processed for server-side includes (see the <a      href="mod_include.html"><samp>mod_include</samp></a>      documentation).    <p>If the file specified by <samp>HeaderName</samp> contains    the beginnings of an HTML document (&lt;HTML&gt;, &lt;HEAD&gt;,    etc) then you will probably want to set <a    href="#indexoptions:suppresshtmlpreamble"><samp>IndexOptions    +SuppressHTMLPreamble</samp></a>, so that these tags are not    repeated.</p>    <blockquote>      <strong>Apache 1.3.6 and earlier:</strong> The module first      attempts to include <em>filename</em><code>.html</code> as an      HTML document, otherwise it will try to include      <em>filename</em> as plain text. <em>Filename</em> is treated      as a filesystem path relative to the directory being indexed.      In no case is SSI processing done. Example:       <blockquote>        <code>HeaderName HEADER</code>      </blockquote>      when indexing the directory <code>/web</code>, the server      will first look for the HTML file      <code>/web/HEADER.html</code> and include it if found,      otherwise it will include the plain text file      <code>/web/HEADER</code>, if it exists.    </blockquote>    <p>See also <a href="#readmename">ReadmeName</a>.</p>    <hr />    <h2><a id="indexignore" name="indexignore">IndexIgnore</a>    directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> IndexIgnore    <em>file</em> [<em>file</em>] ...<br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex     <p>The IndexIgnore directive adds to the list of files to hide    when listing a directory. <em>File</em> is a file extension,    partial filename, wildcard expression or full filename for    files to ignore. Multiple IndexIgnore directives add to the    list, rather than replacing the list of ignored files. By    default, the list contains `<code>.</code>'. Example:</p>    <blockquote>      <code>IndexIgnore README .htaccess *~</code>    </blockquote>    <hr />    <h2><a id="indexoptions" name="indexoptions">IndexOptions</a>    directive</h2>    <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> IndexOptions    <em>option</em> [<em>option</em>] ... (Apache 1.3.2 and    earlier) <br />     <a href="directive-dict.html#Syntax"    rel="Help"><strong>Syntax:</strong></a> IndexOptions    [+|-]<em>option</em> [[+|-]<em>option</em>] ... (Apache 1.3.3    and later) <br />     <a href="directive-dict.html#Context"    rel="Help"><strong>Context:</strong></a> server config, virtual    host, directory, .htaccess<br />     <a href="directive-dict.html#Override"    rel="Help"><strong>Override:</strong></a> Indexes<br />     <a href="directive-dict.html#Status"    rel="Help"><strong>Status:</strong></a> Base<br />     <a href="directive-dict.html#Module"    rel="Help"><strong>Module:</strong></a> mod_autoindex <br />     <a href="directive-dict.html#Compatibility"    rel="Help"><strong>Compatibility:</strong></a> '+/-' syntax and    merging of multiple <samp>IndexOptions</samp> directives is    only available with Apache 1.3.3 and later; the    <samp>FoldersFirst</samp> and <samp>DescriptionWidth</samp>    options are only available with Apache 1.3.10 and later; the    <samp>TrackModified</samp> option is only available with Apache    1.3.15 and later; the <samp>IgnoreCase</samp> option is only    available with Apache 1.3.24 and later    <p>The IndexOptions directive specifies the behavior of the    directory indexing. <em>Option</em> can be one of</p>    <dl>      <dt><a id="indexoptions:descriptionwidth"      name="indexoptions:descriptionwidth">DescriptionWidth=[<em>n</em>      | *] (<em>Apache 1.3.10 and later</em>)</a></dt>      <dd>The <samp>DescriptionWidth</samp> keyword allows you to      specify the width of the description column in characters. If      the keyword value is '<samp>*</samp>', then the column is      automatically sized to the length of the longest filename in      the display. <b>See the section on <a      href="#adddescription"><samp>AddDescription</samp></a> for      dangers inherent in truncating descriptions.</b></dd>      <dt><a id="indexoptions:fancyindexing"      name="indexoptions:fancyindexing">FancyIndexing</a></dt>      <dd>        This turns on fancy indexing of directories.         <blockquote>          <strong>Note that in versions of Apache prior to 1.3.2,          the <samp>FancyIndexing</samp> and          <samp>IndexOptions</samp> directives will override each          other. You should use          <samp>IndexOptions&nbsp;FancyIndexing</samp> in          preference to the standalone <samp>FancyIndexing</samp>          directive. As of Apache 1.3.2, a standalone          <samp>FancyIndexing</samp> directive is combined with any          <samp>IndexOptions</samp> directive already specified for          the current scope.</strong>        </blockquote>      </dd>      <dt><a id="indexoptions:foldersfirst"      name="indexoptions:foldersfirst">FoldersFirst (<i>Apache      1.3.10 and later</i>)</a></dt>      <dd>If this option is enabled, subdirectories in a      FancyIndexed listing will <i>always</i> appear first,      followed by normal files in the directory. The listing is