Commit 2145d0e4 authored by Richard Bowen's avatar Richard Bowen
Browse files

Move some the examples, technical details, and tutorial-style stuff into 

its own place, somewhat like we did with mod_ssl and others. The main
module reference document should just be a module reference document,
and nothing more.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@157838 13f79535-47bb-0310-9956-ffa450edef68
parent 2ea4ec7f

docs/manual/rewrite/index.html

0 → 100644
+3 −0
Original line number Diff line number Diff line 
URI: index.html.en

Content-Language: en

Content-type: text/html; charset=ISO-8859-1

docs/manual/rewrite/index.html.en

0 → 100644
+97 −0
Original line number Diff line number Diff line 
<?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 mod_rewrite - Apache HTTP Server</title>

<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />

<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />

<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />

<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 mod_rewrite</h1>

<div class="toplang">

<p><span>Available Languages: </span><a href="../en/rewrite/" title="English">&nbsp;en&nbsp;</a></p>

</div>



      <blockquote>

            <p>``The great thing about mod_rewrite is it gives you

            all the configurability and flexibility of Sendmail.

            The downside to mod_rewrite is that it gives you all

            the configurability and flexibility of Sendmail.''</p>



            <p class="cite">-- <cite>Brian Behlendorf</cite><br />

            Apache Group</p>



      </blockquote>



      <blockquote>

            <p>`` Despite the tons of examples and docs,

            mod_rewrite is voodoo. Damned cool voodoo, but still

            voodoo. ''</p>



            <p class="cite">-- <cite>Brian Moore</cite><br />

            bem@news.cmc.net</p>



      </blockquote>



      <p>Welcome to mod_rewrite, the Swiss Army Knife of URL

      manipulation!</p>



      <p>This module uses a rule-based rewriting engine (based on a

      regular-expression parser) to rewrite requested URLs on the

      fly. It supports an unlimited number of rules and an

      unlimited number of attached rule conditions for each rule to

      provide a really flexible and powerful URL manipulation

      mechanism. The URL manipulations can depend on various tests,

      for instance server variables, environment variables, HTTP

      headers, time stamps and even external database lookups in

      various formats can be used to achieve granular URL

      matching.</p>



      <p>This module operates on the full URLs (including the

      path-info part) both in per-server context

      (<code>httpd.conf</code>) and per-directory context

      (<code>.htaccess</code>) and can even generate query-string

      parts on result. The rewritten result can lead to internal

      sub-processing, external request redirection or even to an

      internal proxy throughput.</p>



      <p>But all this functionality and flexibility has its

      drawback: complexity. So don't expect to understand this

      entire module in just one day.</p>



</div>

<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">Documentation</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#mod-rewrite">mod_rewrite</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="documentation" id="documentation">Documentation</a></h2>

<ul>

<li><a href="rewrite_intro.html">Introduction</a></li>

<li><a href="rewrite_tech.html">Technical details</a></li>

<li><a href="rewrite_guide.html">Practical solutions to common

problems</a></li>

<li><a href="../glossary.html">Glossary</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="mod-rewrite" id="mod-rewrite">mod_rewrite</a></h2>

<p>Extensive documentation on the directives 

provided by this module is provided in the <a href="../mod/mod_rewrite.html">mod_rewrite reference documentation</a>.

</p>

</div></div>

<div class="bottomlang">

<p><span>Available Languages: </span><a href="../en/rewrite/" title="English">&nbsp;en&nbsp;</a></p>

</div><div id="footer">

<p class="apache">Copyright 1995-2005 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</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

docs/manual/rewrite/index.xml

0 → 100644
+92 −0
Original line number Diff line number Diff line 
<?xml version='1.0' encoding='UTF-8' ?>

<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- $LastChangedRevision$ -->



<!--

 Copyright 2002-2005 The Apache Software Foundation or its licensors, as

 applicable.



 Licensed under the Apache License, Version 2.0 (the "License");

 you may not use this file except in compliance with the License.

 You may obtain a copy of the License at



     http://www.apache.org/licenses/LICENSE-2.0



 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 See the License for the specific language governing permissions and

 limitations under the License.

-->



<manualpage metafile="index.xml.meta">

<parentdocument href="../"/>



  <title>Apache mod_rewrite</title>



<summary>

      <blockquote>

            <p>``The great thing about mod_rewrite is it gives you

            all the configurability and flexibility of Sendmail.

            The downside to mod_rewrite is that it gives you all

            the configurability and flexibility of Sendmail.''</p>



            <p class="cite">-- <cite>Brian Behlendorf</cite><br />

            Apache Group</p>



      </blockquote>



      <blockquote>

            <p>`` Despite the tons of examples and docs,

            mod_rewrite is voodoo. Damned cool voodoo, but still

            voodoo. ''</p>



            <p class="cite">-- <cite>Brian Moore</cite><br />

            bem@news.cmc.net</p>



      </blockquote>



      <p>Welcome to mod_rewrite, the Swiss Army Knife of URL

      manipulation!</p>



      <p>This module uses a rule-based rewriting engine (based on a

      regular-expression parser) to rewrite requested URLs on the

      fly. It supports an unlimited number of rules and an

      unlimited number of attached rule conditions for each rule to

      provide a really flexible and powerful URL manipulation

      mechanism. The URL manipulations can depend on various tests,

      for instance server variables, environment variables, HTTP

      headers, time stamps and even external database lookups in

      various formats can be used to achieve granular URL

      matching.</p>



      <p>This module operates on the full URLs (including the

      path-info part) both in per-server context

      (<code>httpd.conf</code>) and per-directory context

      (<code>.htaccess</code>) and can even generate query-string

      parts on result. The rewritten result can lead to internal

      sub-processing, external request redirection or even to an

      internal proxy throughput.</p>



      <p>But all this functionality and flexibility has its

      drawback: complexity. So don't expect to understand this

      entire module in just one day.</p>



</summary>



<section id="documentation"><title>Documentation</title>

<ul>

<li><a href="../mod/mod_rewrite.html">mod_rewrite reference

documentation</a></li>

<li><a href="rewrite_intro.html">Introduction</a></li>

<li><a href="rewrite_tech.html">Technical details</a></li>

<li><a href="rewrite_guide.html">Practical solutions to common

problems</a></li>

<li><a href="../glossary.html">Glossary</a></li>

</ul>

</section>



</manualpage>

docs/manual/rewrite/index.xml.meta

0 → 100644
+11 −0
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>



<metafile>

  <basename>index</basename>

  <path>/rewrite/</path>

  <relpath>..</relpath>



  <variants>

    <variant>en</variant>

  </variants>

</metafile>

docs/manual/rewrite/rewrite_guide.html

0 → 100644
+3 −0
Original line number Diff line number Diff line 
URI: rewrite_guide.html.en

Content-Language: en

Content-type: text/html; charset=ISO-8859-1