mod_autoindex.html.en

linux服务器 源码。。。。。。。。。。。。。。

    <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