You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by er...@apache.org on 2002/09/06 01:12:59 UTC
cvs commit: httpd-2.0/docs/manual/howto htaccess.html.en htaccess.xml public_html.html.en
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="<-" alt="<-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <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"><Directory></code></a> section in your main server
+ made in a <code class="directive"><a href="../mod/core.html#directory"><Directory></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>
- <Directory /www/htdocs/example><br>
- AddType text/example .exm<br>
+ <div class="example"><h3>Section from your <code>httpd.conf</code>
+ file</h3><p><code>
+ <Directory /www/htdocs/example><br />
+ AddType text/example .exm<br />
</Directory>
- </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="<-" alt="<-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <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>
- <DirectoryMatch /home/*/cgi-bin/><br>
- Options +ExecCGI<br>
- SetHandler cgi-script<br>
+ <div class="example"><p><code>
+ <DirectoryMatch /home/*/cgi-bin/><br />
+ Options +ExecCGI<br />
+ SetHandler cgi-script<br />
</DirectoryMatch>
- </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