mod_autoindex.html revision db81e057b060e365d840d9a1d35a5797192efa81
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo BGCOLOR="#FFFFFF"
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo TEXT="#000000"
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo LINK="#0000FF"
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo VLINK="#000080"
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo ALINK="#FF0000"
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--#include virtual="header.html" -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis module is contained in the <code>mod_dir.c</code> file, and
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoois compiled in by default. It provides for directory indexing.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis module controls the directory indexing. The index of a directory
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoocan come from one of two sources:
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<li>A file written by the user, typically called <code>index.html</code>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThe <A HREF="#directoryindex">DirectoryIndex</A> directive sets the name
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooof this file.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<li>Otherwise, a listing generated by the server. The other directives
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoocontrol the format of this listing. The <A HREF="#addicon">AddIcon</A>,
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#addiconbyencoding">AddIconByEncoding</A> and
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#addiconbytype">AddIconByType</A> are used to set a list of
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooicons to display for various file types; for each file listed, the
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoofirst icon listed that matches the file is displayed.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<li><A HREF="#addaltbyencoding">AddAltByEncoding</A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<li><A HREF="#addiconbyencoding">AddIconByEncoding</A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddAlt} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddAlt <em>string file file...</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the alternate text to display for a file, instead of an icon, for
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#fancyindexing">FancyIndexing</A>. <em>File</em> is a file
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooextension, partial filename, wild-card expression or full filename for files
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooto describe. <em>String</em> is enclosed in double quotes
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(<code>"</code>). This alternate text is displayed if the client is
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooimage-incapable or has image loading disabled.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A name="addaltbyencoding"><h2>AddAltByEncoding</h2></A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddAltByEncoding} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddAltByEncoding <em>string MIME-encoding
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the alternate text to display for a file, instead of an icon, for
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#fancyindexing">FancyIndexing</A>. <em>MIME-encoding</em> is a
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoovalid content-encoding, such as <SAMP>x-compress</SAMP>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(<code>"</code>). This alternate text is displayed if the client is
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooimage-incapable or has image loading disabled.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddAltByType} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddAltByType <em>string MIME-type MIME-type...</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the alternate text to display for a file, instead of an icon, for
129881b9d52cbe45ed1e2529da980fa231c4e97eStéphane Graber<A HREF="#fancyindexing">FancyIndexing</A>. <em>MIME-type</em> is a
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoovalid content-type, such as <SAMP>text/html</SAMP>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(<code>"</code>). This alternate text is displayed if the client is
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooimage-incapable or has image loading disabled.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A name="adddescription"><h2>AddDescription</h2></A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddDescription} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddDescription <em>string file file...</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the description to display for a file, for
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#fancyindexing">FancyIndexing</A>. <em>File</em> is a file
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooextension, partial filename, wild-card expression or full filename for files
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooto describe. <em>String</em> is enclosed in double quotes
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<blockquote><code>AddDescription "The planet Mars" /web/pics/mars.gif
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddIcon} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddIcon <em>icon name name ...</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the icon to display next to a file ending in <em>name</em> for
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#fancyindexing">FancyIndexing</A>. <em>Icon</em> is either a
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(%-escaped) relative URL to the icon, or of the format
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag given
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoofor an icon for non-graphical browsers.<p>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<em>Name</em> is either ^^DIRECTORY^^ for directories, ^^BLANKICON^^ for
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooblank lines (to format the list correctly), a file extension, a wildcard
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooexpression, a partial filename or a complete filename. Examples:
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooAddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm <br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#addiconbytype">AddIconByType</A> should be used in preference to
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A name="addiconbyencoding"><h2>AddIconByEncoding</h2></A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddIconByEncoding} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddIconByEncoding <em>icon mime-encoding mime-encoding
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the icon to display next to files with
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<em>mime-encoding</em> for <A HREF="#fancyindexing">FancyIndexing</A>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<em>Icon</em> is either a (%-escaped) relative URL to the icon, or of the
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooformat (<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoogiven for an icon for non-graphical browsers.<p>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<em>Mime-encoding</em> is a wildcard expression matching required the
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoocontent-encoding. Examples:
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A name="addiconbytype"><h2>AddIconByType</h2></A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt AddIconByType} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> AddIconByType <em>icon mime-type mime-type ...</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis sets the icon to display next to files of type <em>mime-type</em> for
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A HREF="#fancyindexing">FancyIndexing</A>. <em>Icon</em> is either a
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(%-escaped) relative URL to the icon, or of the format
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(<em>alttext</em>,<em>url</em>) where <em>alttext</em> is the text tag given
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoofor an icon for non-graphical browsers.<p>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<em>Mime-type</em> is a wildcard expression matching required the mime types.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt DefaultIcon} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> DefaultIcon <em>url</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThe DefaultIcon directive sets the icon to display for files when no
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoospecific icon is known, for <A HREF="#fancyindexing">FancyIndexing</A>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<em>Url</em> is a (%-escaped) relative URL to the icon. Examples:
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<A name="directoryindex"><h2>DirectoryIndex</h2></A>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!--%plaintext <?INDEX {\tt DirectoryIndex} directive> -->
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Syntax:</strong> DirectoryIndex <em>local-url local-url ...</em><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<strong>Default:</strong> <code>DirectoryIndex index.html</code><br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<Strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThe DirectoryIndex directive sets the list of resources to look for,
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoowhen the client requests an index of the directory by specifying a /
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooat the end of the a directory name. <em>Local-url</em> is the
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(%-encoded) URL of a document on the server relative to the requested
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoodirectory; it is usually the name of a file in the directory. Several
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooURLs may be given, in which case the server will return the first one
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoothat it finds. If none of the resources exist and the
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<CODE>Indexes</CODE> option is set, the server will generate its own
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoolisting of the directory.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoothen a request for <code>http://myserver/docs/</code> would return
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<code>http://myserver/docs/index.html</code> if it exists, or would list
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoothe directory if it did not. <p>
<!--#include virtual="footer.html" -->