📄 mod_autoindex.html.en
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta name="generator" content="HTML Tidy, see www.w3.org" /> <title>Apache module mod_autoindex</title> </head> <!-- Background white, links blue (unvisited), navy (visited), red (active) --> <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#000080" alink="#FF0000"> <div align="CENTER"> <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> <h3>Apache HTTP Server Version 1.3</h3> <p><small><em>Is this the version you want? For more recent versions, check our <a href="/docs/">documentation index</a>.</em></small></p> </div> <h1 align="CENTER">Module mod_autoindex</h1> This module provides for automatic directory indexing. <p><a href="module-dict.html#Status" rel="Help"><strong>Status:</strong></a> Base<br /> <a href="module-dict.html#SourceFile" rel="Help"><strong>Source File:</strong></a> mod_autoindex.c<br /> <a href="module-dict.html#ModuleIdentifier" rel="Help"><strong>Module Identifier:</strong></a> autoindex_module</p> <h2>Summary</h2> The index of a directory can come from one of two sources: <ul> <li>A file written by the user, typically called <code>index.html</code>. The <a href="mod_dir.html#directoryindex">DirectoryIndex</a> directive sets the name of this file. This is controlled by <a href="mod_dir.html"><code>mod_dir</code></a>.</li> <li>Otherwise, a listing generated by the server. The other directives control the format of this listing. The <a href="#addicon">AddIcon</a>, <a href="#addiconbyencoding">AddIconByEncoding</a> and <a href="#addiconbytype">AddIconByType</a> are used to set a list of icons to display for various file types; for each file listed, the first icon listed that matches the file is displayed. These are controlled by <code>mod_autoindex</code>.</li> </ul> The two functions are separated so that you can completely remove (or replace) automatic index generation should you want to. <p>Automatic index generation is enabled with using <code>Options +Indexes</code>. See the <a href="core.html#options"><code>Options</code></a> directive for more details.</p> <p>If <a href="#fancyindexing"><samp>FancyIndexing</samp></a> is enabled, or the <samp>FancyIndexing</samp> keyword is present on the <a href="#indexoptions"><samp>IndexOptions</samp></a> directive, the column headers are links that control the order of the display. If you select a header link, the listing will be regenerated, sorted by the values in that column. Selecting the same header repeatedly toggles between ascending and descending order.</p> <p>Note that when the display is sorted by "Size", it's the <em>actual</em> size of the files that's used, not the displayed value - so a 1010-byte file will always be displayed before a 1011-byte file (if in ascending order) even though they both are shown as "1K".</p> <h2>Directives</h2> <ul> <li><a href="#addalt">AddAlt</a></li> <li><a href="#addaltbyencoding">AddAltByEncoding</a></li> <li><a href="#addaltbytype">AddAltByType</a></li> <li><a href="#adddescription">AddDescription</a></li> <li><a href="#addicon">AddIcon</a></li> <li><a href="#addiconbyencoding">AddIconByEncoding</a></li> <li><a href="#addiconbytype">AddIconByType</a></li> <li><a href="#defaulticon">DefaultIcon</a></li> <li><a href="#fancyindexing">FancyIndexing</a></li> <li><a href="#headername">HeaderName</a></li> <li><a href="#indexignore">IndexIgnore</a></li> <li><a href="#indexoptions">IndexOptions</a></li> <li><a href="#indexorderdefault">IndexOrderDefault</a></li> <li><a href="#readmename">ReadmeName</a></li> </ul> <p>See also: <a href="core.html#options">Options</a> and <a href="mod_dir.html#directoryindex">DirectoryIndex</a>.</p> <h2>Autoindex Request Query Arguments</h2> <p>The column sorting headers themselves are self-referencing hyperlinks that add the sort query options to reorder the directory listing. The query options are of the form <samp>X=Y</samp>, where <samp>X</samp> is one of <samp>N</samp> (file <em>N</em>ame), <samp>M</samp> (file last <em>M</em>odified date), <samp>S</samp> (file <em>S</em>ize), or <samp>D</samp> (file <em>D</em>escription), and <samp>Y</samp> is one of <samp>A</samp> (<em>A</em>scending) or <samp>D</samp> (<em>D</em>escending).</p> <p>When options other than the file name are used as the sorting key, the secondary key is always the file name. (When the file name is used to sort by, there is no need of a secondary sort key, since file names are guaranteed to be unique, and so the sort order is unambiguous.)</p> <p>Example:</p> <p>If the URL <samp>http://your.server.name/foo/</samp> produces a directory index, then the following URLs will produce different sort orders:</p> <ul> <li><samp>http://your.server.name/foo/?M=D</samp> sorts the directory by last modified date, descending.</li> <li><samp>http://your.server.name/foo/?D=A</samp> sorts the directory by file description, ascending.</li> <li><samp>http://your.server.name/foo/?S=A</samp> sorts the directory by file size, ascending.</li> </ul> <p>See <a href="#indexorderdefault"><samp>IndexOrderDefault</samp></a> to set the default directory ordering.</p> <p>Note also that when the directory listing is ordered in one direction (ascending or descending) by a particular column, the link at the top of that column then reverses, to allow sorting in the opposite direction by that same column.</p> <hr /> <h2><a id="addalt" name="addalt">AddAlt</a> directive</h2> <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntax:</strong></a> AddAlt <em>string 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>This sets the alternate text to display for a file, instead of an icon, for <a href="#fancyindexing">FancyIndexing</a>. <em>File</em> is a file extension, partial filename, wild-card expression or full filename for files to describe. <em>String</em> is enclosed in double quotes (<code>"</code>). This alternate text is displayed if the client is image-incapable or has image loading disabled.</p> <p>Examples:</p> <pre> AddAlt "PDF" *.pdf AddAlt "Compressed" *.gz *.zip *.Z </pre> <hr /> <h2><a id="addaltbyencoding" name="addaltbyencoding">AddAltByEncoding</a> directive</h2> <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntax:</strong></a> AddAltByEncoding <em>string 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 alternate text to display for a file, instead of an icon, for <a href="#fancyindexing">FancyIndexing</a>. <em>MIME-encoding</em> is a valid content-encoding, such as <samp>x-compress</samp>. <em>String</em> is enclosed in double quotes (<code>"</code>). This alternate text is displayed if the client is image-incapable or has image loading disabled.</p> <p>Example:</p> <pre> AddAltByEncoding "gzip" x-gzip </pre> <hr /> <h2><a id="addaltbytype" name="addaltbytype">AddAltByType</a> directive</h2> <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntax:</strong></a> AddAltByType <em>string 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 alternate text to display for a file, instead of an icon, for <a href="#fancyindexing">FancyIndexing</a>. <em>MIME-type</em> is a valid content-type, such as <samp>text/html</samp>. <em>String</em> is enclosed in double quotes (<code>"</code>). This alternate text is displayed if the client is image-incapable or has image loading disabled.</p> <p>Example:</p> <pre> AddAltByType "TXT" text/plain </pre> <hr /> <h2><a id="adddescription" name="adddescription">AddDescription</a> directive</h2> <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntax:</strong></a> AddDescription <em>"string" file|directory</em> [<em>file|directory</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 description to display for a file or directory, for <a href="#indexoptions">IndexOptions FancyIndexing</a>. <em>file|directory</em> is a file extension, partial filename or directory name, wild-card expression or full filename or directory name, for files or directories to describe. <em>String</em> is enclosed in double quotes (<code>"</code>). Example:</p> <blockquote> <code>AddDescription "The planet Mars" /web/pics/mars.gif</code> </blockquote> <p>The description field is 23 bytes wide. 7 more bytes may be added if the directory is covered by an <code>IndexOptions SuppressSize</code>, and 19 bytes may be added if <code>IndexOptions SuppressLastModified</code> is in effect. The widest this column can be is therefore 49 bytes.</p> <blockquote> As of Apache 1.3.10, the <a href="#indexoptions:descriptionwidth">DescriptionWidth</a> <samp>IndexOptions</samp> keyword allows you to adjust this width to any arbitrary size. </blockquote> <b>Caution:</b> Descriptive text defined with <samp>AddDescription</samp> may contain HTML markup, such as tags and character entities. If the width of the description column should happen to truncate a tagged element (such as cutting off the end of a bolded phrase), the results may affect the rest of the directory listing. <hr /> <h2><a id="addicon" name="addicon">AddIcon</a> directive</h2> <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntax:</strong></a> AddIcon <em>icon name</em> [<em>name</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 a file ending in <em>name</em> for <a href="#fancyindexing">FancyIndexing</a>.⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -