httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From erikab...@apache.org
Subject cvs commit: httpd-2.0/docs/manual/howto htaccess.html.en htaccess.xml public_html.html.en
Date Thu, 05 Sep 2002 23:12:59 GMT
erikabele    2002/09/05 16:12:58

  Modified:    docs/manual/howto htaccess.html.en htaccess.xml
                        public_html.html.en
  Log:
  Updated XML plus transformations
  
  Revision  Changes    Path
  1.3       +62 -63    httpd-2.0/docs/manual/howto/htaccess.html.en
  
  Index: htaccess.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/howto/htaccess.html.en,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- htaccess.html.en	23 Aug 2002 21:07:51 -0000	1.2
  +++ htaccess.html.en	5 Sep 2002 23:12:58 -0000	1.3
  @@ -1,13 +1,15 @@
  -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><!--
  +<?xml version="1.0" encoding="ISO-8859-1"?>
  +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
           XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                 This file is generated from xml source: DO NOT EDIT
           XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  -      --><title>Apache Tutorial: .htaccess files - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"></head><body><blockquote><div align="center"><img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]"><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Tutorial: .htaccess files</h1>
  +      --><title>Apache Tutorial: .htaccess files - Apache HTTP Server</title><link href="../style/css/manual-sbar-right-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - blue (font 100%)" /><link href="../style/css/manual-sbar-right-90pc.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - blue (font 90%)" /><link href="../style/css/manual-sbar-right-fix15.css" rel="stylesheet" media="all" type="text/css" title="right sidebar - blue (font fix 15)" /><link href="../style/css/manual-sbar-right-fix13.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - blue (font fix 13)" /><link href="../style/css/manual-sbar-right-100pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font 100%)" /><link href="../style/css/manual-sbar-right-90pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font 90%)" /><link href="../style/css/manual-sbar-right-fix15-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font fix 15)" /><link href="../style/css/manual-sbar-right-fix13-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font fix 13)" /><link href="../style/css/manual-sbar-left-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font 100%)" /><link href="../style/css/manual-sbar-left-90pc.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font 90%)" /><link href="../style/css/manual-sbar-left-fix15.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font fix 15)" /><link href="../style/css/manual-sbar-left-fix13.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font fix 13)" /><link href="../style/css/manual-sbar-left-100pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font 100%)" /><link href="../style/css/manual-sbar-left-90pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font 90%)" /><link href="../style/css/manual-sbar-left-fix15-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font fix 15)" /><link href="../style/css/manual-sbar-left-fix13-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font fix 13)" /><link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font 100%)" /><link href="../style/css/manual-loose-90pc.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font 90%)" /><link href="../style/css/manual-loose-fix15.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font fix 15)" /><link href="../style/css/manual-loose-fix13.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font fix 13)" /><link href="../style/css/manual-loose-100pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font 100%)" /><link href="../style/css/manual-loose-90pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font 90%)" /><link href="../style/css/manual-loose-fix15-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font fix 15)" /><link href="../style/css/manual-loose-fix13-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font fix 13)" /><link href="../images/favicon.ico" rel="shortcut icon" /></head><body id="manual-page"><div id="page-header"><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="../images/feather.gif" /></div><div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.0</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: .htaccess files</h1>
   <p><code>.htaccess</code> files provide a way to make configuration
   changes on a per-directory basis.</p>
  -<ul><li><a href="#related">.htaccess files</a></li><li><a href="#what">What they are/How to use them</a></li><li><a href="#when">When (not) to use .htaccess files</a></li><li><a href="#how">How directives are applied</a></li><li><a href="#auth">Authentication example</a></li><li><a href="#ssi">Server side includes example</a></li><li><a href="#cgi">CGI example</a></li><li><a href="#troubleshoot">Troubleshooting</a></li></ul><hr><h2><a name="related">.htaccess files</a></h2>
  -    <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br><code><a href="../mod/core.html">core</a></code><br><code><a href="../mod/mod_auth.html">mod_auth</a></code><br><code><a href="../mod/mod_cgi.html">mod_cgi</a></code><br><code><a href="../mod/mod_include.html">mod_include</a></code><br><code><a href="../mod/mod_mime.html">mod_mime</a></code><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="../mod/core.html#accessfilename" class="directive"><code class="directive">AccessFileName</code></a><br><a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a><br><a href="../mod/core.html#options" class="directive"><code class="directive">Options</code></a><br><a href="../mod/mod_mime.html#addhandler" class="directive"><code class="directive">AddHandler</code></a><br><a href="../mod/core.html#sethandler" class="directive"><code class="directive">SetHandler</code></a><br><a href="../mod/core.html#authtype" class="directive"><code class="directive">AuthType</code></a><br><a href="../mod/core.html#authname" class="directive"><code class="directive">AuthName</code></a><br><a href="../mod/mod_auth.html#authuserfile" class="directive"><code class="directive">AuthUserFile</code></a><br><a href="../mod/mod_auth.html#authgroupfile" class="directive"><code class="directive">AuthGroupFile</code></a><br><a href="../mod/core.html#require" class="directive"><code class="directive">Require</code></a><br></td></tr></table>
  -<h2><a name="what">What they are/How to use them</a></h2>
  +</div><div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">.htaccess files</a></li><li><img alt="" src="../images/down.gif" /> <a href="#what">What they are/How to use them</a></li><li><img alt="" src="../images/down.gif" /> <a href="#when">When (not) to use .htaccess files</a></li><li><img alt="" src="../images/down.gif" /> <a href="#how">How directives are applied</a></li><li><img alt="" src="../images/down.gif" /> <a href="#auth">Authentication example</a></li><li><img alt="" src="../images/down.gif" /> <a href="#ssi">Server side includes example</a></li><li><img alt="" src="../images/down.gif" /> <a href="#cgi">CGI example</a></li><li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Troubleshooting</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="related" id="related">.htaccess files</a></h2>
  +    <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_auth.html">mod_auth</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_auth.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_auth.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li></ul></td></tr></table>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="what" id="what">What they are/How to use them</a></h2>
   
   
       <p><code>.htaccess</code> files (or "distributed configuration files")
  @@ -16,36 +18,34 @@
       particular document directory, and the directives apply to that
       directory, and all subdirectories thereof.</p>
   
  -<blockquote><table><tr><td bgcolor="#e0e5f5">
  +<div class="note">
       <p>Note: If you want to call your <code>.htaccess</code> file something
       else, you can change the name of the file using the <code><a href="../mod/core.html#accessfilename">AccessFileName</a></code>
       directive. For example, if you would rather call the file
       <code>.config</code> then you can put the following in your server
       configuration file:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
       AccessFileName .config
  -    </code></td></tr></table></blockquote>
  -</td></tr></table></blockquote>
  +    </code></p></div>
  +</div>
   
  -    <p>What you can put in these files is determined by the <a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a>
  +    <p>What you can put in these files is determined by the <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
       directive. This directive specifies, in categories, what directives
       will be honored if they are found in a <code>.htaccess</code> file. If
       a directive is permitted in a <code>.htaccess</code> file, the
       documentation for that directive will contain an Override section,
  -    specifying what value must be in <a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a> in order
  +    specifying what value must be in <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> in order
       for that directive to be permitted.</p>
   
  -    <p>For example, if you look at the documentation for the <a href="../mod/core.html#adddefaultcharset" class="directive"><code class="directive">AddDefaultCharset</code></a>
  +    <p>For example, if you look at the documentation for the <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>
       directive, you will find that it is permitted in <code>.htaccess</code>
       files. (See the Context line in the directive summary.) The <a href="../mod/directive-dict.html#Context">Override</a> line reads
       "<code>FileInfo</code>". Thus, you must have at least
       "<code>AllowOverride FileInfo</code>" in order for this directive to be
       honored in <code>.htaccess</code> files.</p>
   
  -<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Example:</strong></p><code>
  -
  -      <table>
  +<div class="example"><h3>Example:</h3><table>
           <tr>
             <td><a href="../mod/directive-dict.html#Context">Context:</a></td>
   
  @@ -57,14 +57,13 @@
   
             <td>FileInfo</td>
           </tr>
  -      </table>
  -</code></td></tr></table></blockquote>
  +      </table></div>
   
   
       <p>If you are unsure whether a particular directive is permitted in a
       <code>.htaccess</code> file, look at the documentation for that
       directive, and check the Context line for ".htaccess."</p>
  -    <h2><a name="when">When (not) to use .htaccess files</a></h2>
  +    </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="when" id="when">When (not) to use .htaccess files</a></h2>
       
   
       <p>In general, you should never use <code>.htaccess</code> files unless
  @@ -88,13 +87,13 @@
       <p>However, in general, use of <code>.htaccess</code> files should be
       avoided when possible. Any configuration that you would consider
       putting in a <code>.htaccess</code> file, can just as effectively be
  -    made in a <a href="../mod/core.html#directory" class="directive"><code class="directive">&lt;Directory&gt;</code></a> section in your main server 
  +    made in a <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> section in your main server 
       configuration file.</p>
   
       <p>There are two main reasons to avoid the use of
       <code>.htaccess</code> files.</p>
   
  -    <p>The first of these is performance. When <a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a>
  +    <p>The first of these is performance. When <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
       is set to allow the use of <code>.htaccess</code> files, Apache will
       look in every directory for <code>.htaccess</code> files. Thus,
       permitting <code>.htaccess</code> files causes a performance hit,
  @@ -109,12 +108,12 @@
       directory <code>/www/htdocs/example</code>, Apache must look for the
       following files:</p>
   
  -   <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -      /.htaccess<br>
  -      /www/.htaccess<br>
  -      /www/htdocs/.htaccess<br>
  +   <div class="example"><p><code>
  +      /.htaccess<br />
  +      /www/.htaccess<br />
  +      /www/htdocs/.htaccess<br />
         /www/htdocs/example/.htaccess
  -   </code></td></tr></table></blockquote>
  +   </code></p></div>
   
       <p>And so, for each file access out of that directory, there are 4
       additional file-system accesses, even if none of those files are
  @@ -138,17 +137,17 @@
   
       <p><code>.htaccess</code> file in <code>/www/htdocs/example</code>:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Contents of .htaccess file in
  -    <code>/www/htdocs/example</code></strong></p><code>
  +    <div class="example"><h3>Contents of .htaccess file in
  +    <code>/www/htdocs/example</code></h3><p><code>
           AddType text/example .exm
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><p align="center"><strong>Section from your <code>httpd.conf</code>
  -    file</strong></p><code>
  -          &lt;Directory /www/htdocs/example&gt;<br>
  -           AddType text/example .exm<br>
  +    <div class="example"><h3>Section from your <code>httpd.conf</code>
  +    file</h3><p><code>
  +          &lt;Directory /www/htdocs/example&gt;<br />
  +           AddType text/example .exm<br />
              &lt;/Directory&gt;
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>However, putting this configuration in your server configuration
       file will result in less of a performance hit, as the configuration is
  @@ -158,10 +157,10 @@
       <p>The use of <code>.htaccess</code> files can be disabled completely
       by setting the <code>AllowOverride</code> directive to "none"</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
         AllowOverride None
  -    </code></td></tr></table></blockquote>
  -<h2><a name="how">How directives are applied</a></h2>
  +    </code></p></div>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="how" id="how">How directives are applied</a></h2>
   
       <p>The configuration directives found in a <code>.htaccess</code> file
       are applied to the directory in which the <code>.htaccess</code> file
  @@ -179,27 +178,27 @@
       <p>In the directory <code>/www/htdocs/example1</code> we have a
       <code>.htaccess</code> file containing the following:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
          Options +ExecCGI
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>(Note: you must have "<code>AllowOverride Options</code>" in effect
  -    to permit the use of the "<a href="../mod/core.html#options" class="directive"><code class="directive">Options</code></a>" directive in
  +    to permit the use of the "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" directive in
       <code>.htaccess</code> files.)</p>
   
       <p>In the directory <code>/www/htdocs/example1/example2</code> we have
       a <code>.htaccess</code> file containing:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
          Options Includes
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>Because of this second <code>.htaccess</code> file, in the directory
       <code>/www/htdocs/example1/example2</code>, CGI execution is not
       permitted, as only <code>Options Includes</code> is in effect, which
       completely overrides any earlier setting that may have been in
       place.</p>
  -<h2><a name="auth">Authentication example</a></h2>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="auth" id="auth">Authentication example</a></h2>
   
       <p>If you jumped directly to this part of the document to find out how
       to do authentication, it is important to note one thing. There is a
  @@ -221,31 +220,31 @@
   
       <p><code>.htaccess</code> file contents:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -          AuthType Basic<br>
  -           AuthName "Password Required"<br>
  -           AuthUserFile /www/passwords/password.file<br>
  -           AuthGroupFile /www/passwords/group.file<br>
  +    <div class="example"><p><code>
  +          AuthType Basic<br />
  +           AuthName "Password Required"<br />
  +           AuthUserFile /www/passwords/password.file<br />
  +           AuthGroupFile /www/passwords/group.file<br />
              Require Group admins
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>Note that <code>AllowOverride AuthConfig</code> must be in effect
       for these directives to have any effect.</p>
   
       <p>Please see the <a href="auth.html">authentication tutorial</a> for a
       more complete discussion of authentication and authorization.</p>
  -<h2><a name="ssi">Server side includes example</a></h2>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="ssi" id="ssi">Server side includes example</a></h2>
   
       <p>Another common use of <code>.htaccess</code> files is to enable
       Server Side Includes for a particular directory. This may be done with
       the following configuration directives, placed in a
       <code>.htaccess</code> file in the desired directory:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -       Options +Includes<br>
  -       AddType text/html shtml<br>
  +    <div class="example"><p><code>
  +       Options +Includes<br />
  +       AddType text/html shtml<br />
          AddHandler server-parsed shtml
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>Note that <code>AllowOverride Options</code> and <code>AllowOverride
       FileInfo</code> must both be in effect for these directives to have any
  @@ -253,25 +252,25 @@
   
       <p>Please see the <a href="ssi.html">SSI tutorial</a> for a more
       complete discussion of server-side includes.</p>
  -<h2><a name="cgi">CGI example</a></h2>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="cgi" id="cgi">CGI example</a></h2>
   
       <p>Finally, you may wish to use a <code>.htaccess</code> file to permit
       the execution of CGI programs in a particular directory. This may be
       implemented with the following configuration:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -       Options +ExecCGI<br>
  +    <div class="example"><p><code>
  +       Options +ExecCGI<br />
          AddHandler cgi-script cgi pl
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>Alternately, if you wish to have all files in the given directory be
       considered to be CGI programs, this may be done with the following
       configuration:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -       Options +ExecCGI<br>
  +    <div class="example"><p><code>
  +       Options +ExecCGI<br />
          SetHandler cgi-script
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>Note that <code>AllowOverride Options</code> must be in effect for
       these directives to have any effect.</p>
  @@ -279,13 +278,13 @@
       <p>Please see the <a href="cgi.html">CGI tutorial</a> for a more
       complete discussion of CGI programming and configuration.</p>
   
  -<h2><a name="troubleshoot">Troubleshooting</a></h2>
  +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="troubleshoot" id="troubleshoot">Troubleshooting</a></h2>
   
       <p>When you put configuration directives in a <code>.htaccess</code>
       file, and you don't get the desired effect, there are a number of
       things that may be going wrong.</p>
   
  -    <p>Most commonly, the problem is that <a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a> is not
  +    <p>Most commonly, the problem is that <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> is not
       set such that your configuration directives are being honored. Make
       sure that you don't have a <code>AllowOverride None</code> in effect
       for the file scope in question. A good test for this is to put garbage
  @@ -299,4 +298,4 @@
       Alternately, it may tell you that you had a syntax error, which you
       will then need to fix.</p>
   
  -  <hr></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="../images/index.gif" alt="Index"></a><a href="../"><img src="../images/home.gif" alt="Home"></a></body></html>
  \ No newline at end of file
  +  </div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div></body></html>
  \ No newline at end of file
  
  
  
  1.3       +0 -1      httpd-2.0/docs/manual/howto/htaccess.xml
  
  Index: htaccess.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/howto/htaccess.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- htaccess.xml	23 Aug 2002 21:07:51 -0000	1.2
  +++ htaccess.xml	5 Sep 2002 23:12:58 -0000	1.3
  @@ -79,7 +79,6 @@
       honored in <code>.htaccess</code> files.</p>
   
   <example><title>Example:</title>
  -
         <table>
           <tr>
             <td><a
  
  
  
  1.2       +35 -33    httpd-2.0/docs/manual/howto/public_html.html.en
  
  Index: public_html.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/howto/public_html.html.en,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- public_html.html.en	15 Aug 2002 15:47:10 -0000	1.1
  +++ public_html.html.en	5 Sep 2002 23:12:58 -0000	1.2
  @@ -1,22 +1,24 @@
  -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><!--
  +<?xml version="1.0" encoding="ISO-8859-1"?>
  +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
           XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                 This file is generated from xml source: DO NOT EDIT
           XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  -      --><title>Per-user web directories - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"></head><body><blockquote><div align="center"><img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]"><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Per-user web directories</h1>
  +      --><title>Per-user web directories - Apache HTTP Server</title><link href="../style/css/manual-sbar-right-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - blue (font 100%)" /><link href="../style/css/manual-sbar-right-90pc.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - blue (font 90%)" /><link href="../style/css/manual-sbar-right-fix15.css" rel="stylesheet" media="all" type="text/css" title="right sidebar - blue (font fix 15)" /><link href="../style/css/manual-sbar-right-fix13.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - blue (font fix 13)" /><link href="../style/css/manual-sbar-right-100pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font 100%)" /><link href="../style/css/manual-sbar-right-90pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font 90%)" /><link href="../style/css/manual-sbar-right-fix15-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font fix 15)" /><link href="../style/css/manual-sbar-right-fix13-b.css" rel="alternate stylesheet" media="all" type="text/css" title="right sidebar - black (font fix 13)" /><link href="../style/css/manual-sbar-left-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font 100%)" /><link href="../style/css/manual-sbar-left-90pc.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font 90%)" /><link href="../style/css/manual-sbar-left-fix15.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font fix 15)" /><link href="../style/css/manual-sbar-left-fix13.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - blue (font fix 13)" /><link href="../style/css/manual-sbar-left-100pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font 100%)" /><link href="../style/css/manual-sbar-left-90pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font 90%)" /><link href="../style/css/manual-sbar-left-fix15-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font fix 15)" /><link href="../style/css/manual-sbar-left-fix13-b.css" rel="alternate stylesheet" media="all" type="text/css" title="left sidebar - black (font fix 13)" /><link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font 100%)" /><link href="../style/css/manual-loose-90pc.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font 90%)" /><link href="../style/css/manual-loose-fix15.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font fix 15)" /><link href="../style/css/manual-loose-fix13.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - blue (font fix 13)" /><link href="../style/css/manual-loose-100pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font 100%)" /><link href="../style/css/manual-loose-90pc-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font 90%)" /><link href="../style/css/manual-loose-fix15-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font fix 15)" /><link href="../style/css/manual-loose-fix13-b.css" rel="alternate stylesheet" media="all" type="text/css" title="loose style - black (font fix 13)" /><link href="../images/favicon.ico" rel="shortcut icon" /></head><body id="manual-page"><div id="page-header"><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="../images/feather.gif" /></div><div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.0</a></div><div id="page-content"><div id="preamble"><h1>Per-user web directories</h1>
   <p>On systems with multiple users, each user can be permitted to have a
  -    web site in their home directory using the <a href="../mod/mod_userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a> directive. Visitors
  +    web site in their home directory using the <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive. Visitors
       to a URL <code>http://example.com/~username/</code> will get content
       out of the home directory of the user "<code>username</code>", out of
  -    the subdirectory specified by the <a href="../mod/mod_userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a> directive.</p>
  +    the subdirectory specified by the <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive.</p>
   
  -<ul><li><a href="#related">Per-user web directories</a></li><li><a href="#userdir">Setting the file path with <a href="../mod/mod_userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a></a></li><li><a href="#enable">Restricting what users are permitted to use this 
  -    feature</a></li><li><a href="#cgi">Enabling a cgi directory for each user</a></li><li><a href="#htaccess">Allowing users to alter configuration</a></li></ul><hr><h2><a name="related">Per-user web directories</a></h2>
  +</div><div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Per-user web directories</a></li><li><img alt="" src="../images/down.gif" /> <a href="#userdir">Setting the file path with <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></a></li><li><img alt="" src="../images/down.gif" /> <a href="#enable">Restricting what users are permitted to use this 
  +    feature</a></li><li><img alt="" src="../images/down.gif" /> <a href="#cgi">Enabling a cgi directory for each user</a></li><li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Allowing users to alter configuration</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="related" id="related">Per-user web directories</a></h2>
       
  -    <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br><code><a href="../mod/mod_userdir.html">mod_userdir</a></code><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="../mod/mod_userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a><br><a href="../mod/core.html#directorymatch" class="directive"><code class="directive">DirectoryMatch</code></a><br><a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a><br></td></tr></table>
  -    <h2><a name="userdir">Setting the file path with <a href="../mod/mod_userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a></a></h2>
  +    <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
  +    </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="userdir" id="userdir">Setting the file path with <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></a></h2>
       
   
  -    <p>The <a href="../mod/mod_userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a>
  +    <p>The <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
       directive specifies a directory out of which per-user
       content is loaded. This directive may take several different forms.</p>
   
  @@ -24,9 +26,9 @@
       assumed to be a directory path relative to the home directory of the
       specified user. Given this configuration:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
         UserDir public_html
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>the URL <code>http://example.com/~rbowen/file.html</code> will be
       translated to the file path
  @@ -36,9 +38,9 @@
       constructed using that path, plus the username specified. Given this
       configuration:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
         UserDir /var/html
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>the URL <code>http://example.com/~rbowen/file.html</code> will be
       translated to the file path <code>/var/html/rbowen/file.html</code></p>
  @@ -47,62 +49,62 @@
       in which the asterisk is replaced with the username. Given this
       configuration:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  +    <div class="example"><p><code>
         UserDir /var/www/*/docs
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>the URL <code>http://example.com/~rbowen/file.html</code> will be
       translated to the file path
       <code>/var/www/rbowen/docs/file.html</code></p>
   
  -  <h2><a name="enable">Restricting what users are permitted to use this 
  +  </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="enable" id="enable">Restricting what users are permitted to use this 
       feature</a></h2>
       
   
       <p>Using the syntax show in the UserDir documentation, you can restrict
       what users are permitted to use this functionality:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -      UserDir enabled<br>
  +    <div class="example"><p><code>
  +      UserDir enabled<br />
         UserDir disabled root jro fish
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
       <p>The configuration above will enable the feature for all users
       except for those listed in the <code>disabled</code> statement.
       You can, likewise, disable the feature for all but a few users by
       using a configuration like the following:</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -      UserDir disabled<br>
  +    <div class="example"><p><code>
  +      UserDir disabled<br />
         UserDir enabled rbowen krietz
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
  -    <p>See <a href="../mod/userdir.html#userdir" class="directive"><code class="directive">UserDir</code></a>
  +    <p>See <code class="directive"><a href="../mod/userdir.html#userdir">UserDir</a></code>
       documentation for additional examples.</p>
   
  -  <h2><a name="cgi">Enabling a cgi directory for each user</a></h2>
  +  </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="cgi" id="cgi">Enabling a cgi directory for each user</a></h2>
     
   
      <p>In order to give each user their own cgi-bin directory, you can use
  -    a <a href="../mod/core.html#directorymatch" class="directive"><code class="directive">DirectoryMatch</code></a>
  +    a <code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code>
       directive to make a particular subdirectory of a user's home directory
       cgi-enabled.</p>
   
  -    <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
  -      &lt;DirectoryMatch /home/*/cgi-bin/&gt;<br>
  -       Options +ExecCGI<br>
  -       SetHandler cgi-script<br>
  +    <div class="example"><p><code>
  +      &lt;DirectoryMatch /home/*/cgi-bin/&gt;<br />
  +       Options +ExecCGI<br />
  +       SetHandler cgi-script<br />
          &lt;/DirectoryMatch&gt;
  -    </code></td></tr></table></blockquote>
  +    </code></p></div>
   
  -    <h2><a name="htaccess">Allowing users to alter configuration</a></h2>
  +    </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="htaccess" id="htaccess">Allowing users to alter configuration</a></h2>
       
   
       <p>If you want to allows users to modify the server configuration in
       their web space, they will need to use <code>.htaccess</code> files to
  -    make these changed. Ensure that you have set <a href="../mod/core.html#allowoverride" class="directive"><code class="directive">AllowOverride</code></a> to a
  +    make these changed. Ensure that you have set <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> to a
       value sufficient for the directives that you want to permit the users
       to modify. See the <a href="htaccess.html">.htaccess tutorial</a> for
       additional details on how this works.</p>
   
  -  <hr></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="../images/index.gif" alt="Index"></a><a href="../"><img src="../images/home.gif" alt="Home"></a></body></html>
  \ No newline at end of file
  +  </div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div></body></html>
  \ No newline at end of file
  
  
  

Mime
View raw message