httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From max...@apache.org
Subject svn commit: r357192 - in /httpd/site/trunk/docs: mod_mbox/index.html mod_mbox/install.html mod_mbox/ref.html modules/index.html
Date Fri, 16 Dec 2005 17:44:37 GMT
Author: maxime
Date: Fri Dec 16 09:44:26 2005
New Revision: 357192

URL: http://svn.apache.org/viewcvs?rev=357192&view=rev
Log:
Rebuild.


Added:
    httpd/site/trunk/docs/mod_mbox/install.html   (with props)
    httpd/site/trunk/docs/mod_mbox/ref.html   (with props)
Modified:
    httpd/site/trunk/docs/mod_mbox/index.html
    httpd/site/trunk/docs/modules/index.html

Modified: httpd/site/trunk/docs/mod_mbox/index.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/mod_mbox/index.html?rev=357192&r1=357191&r2=357192&view=diff
==============================================================================
--- httpd/site/trunk/docs/mod_mbox/index.html (original)
+++ httpd/site/trunk/docs/mod_mbox/index.html Fri Dec 16 09:44:26 2005
@@ -100,6 +100,21 @@
            <table border="0" cellspacing="0" cellpadding="2" width="100%">
  <tr><td bgcolor="#525D76">
   <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Documentation</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<ul>
+    <li><a href="install.html">Installation instructions</a></li>
+    <li>Configuration directives <a href="ref.html">reference</a></li>
+  </ul>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
    <strong>Mailing Lists</strong>
   </font>
  </td></tr>
@@ -144,7 +159,7 @@
            <table border="0" cellspacing="0" cellpadding="2" width="100%">
  <tr><td bgcolor="#525D76">
   <font color="#ffffff" face="arial,helvetica,sanserif">
-   <strong>Histroy</strong>
+   <strong>History</strong>
   </font>
  </td></tr>
  <tr><td>
@@ -154,7 +169,7 @@
     Erenkrantz</strong> in 2001, and <strong>Paul Querna</strong> also
     worked on the module from time to time. More recently,
     <strong>Maxime Petazzoni</strong> and <strong>Russell
-    Johnson</strong> joined the "team" as a Summer Of Code
+    Johnson</strong> joined the "team" as Summer Of Code
     students. Russell implemented the full text search in
     <tt>mod_mbox</tt>, while Maxime worked on improving the module's
     user interface.

Added: httpd/site/trunk/docs/mod_mbox/install.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/mod_mbox/install.html?rev=357192&view=auto
==============================================================================
--- httpd/site/trunk/docs/mod_mbox/install.html (added)
+++ httpd/site/trunk/docs/mod_mbox/install.html Fri Dec 16 09:44:26 2005
@@ -0,0 +1,227 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+               "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+ <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+       <meta name="author" content="HTTPd developers" /><meta name="email" content="dev@httpd.apache.org"
/>
+    <title>mod_mbox - Mailing list archives browser - The Apache HTTP Server Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="../images/httpd_logo_wide.gif" alt="The Apache HTTP
Server Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+   <tr>
+    <!-- LEFT SIDE NAVIGATION -->
+    <td valign="top" nowrap="nowrap">
+     <a href="http://apachecon.com/"
+       ><img src="/images/apachecon_2005us.jpg" height="59"
+         width="135" border="0" alt="ApacheCon US 2005" /></a>
+           <p><b>Essentials</b></p>
+    <menu compact="compact">
+          <li><a href="/ABOUT_APACHE.html">About</a></li>
+          <li><a href="http://www.apache.org/licenses/">License</a></li>
+          <li><a href="/docs/2.2/faq/">FAQ</a></li>
+          <li><a href="/security_report.html">Security<br />Reports</a></li>
+        </menu>
+      <p><b>Download!</b></p>
+    <menu compact="compact">
+          <li><a href="/download.cgi">from a mirror</a></li>
+        </menu>
+      <p><b><a 
+href="/docs/">Documentation</a></b></p>
+    <menu compact="compact">
+          <li><a href="/docs/2.2/">Version 2.2</a></li>
+          <li><a href="/docs/2.0/">Version 2.0</a></li>
+          <li><a href="/docs/1.3/">Version 1.3</a></li>
+          <li><a href="/docs/trunk/">Trunk</a> (dev)</li>
+        </menu>
+      <p><b>Get Involved</b></p>
+    <menu compact="compact">
+          <li><a href="/lists.html">Mailing Lists</a></li>
+          <li><a href="/bug_report.html">Bug Reports</a></li>
+          <li><a href="/dev/">Developer Info</a></li>
+        </menu>
+      <p><b>Subprojects</b></p>
+    <menu compact="compact">
+          <li><a href="/docs-project/">Docs</a></li>
+          <li><a href="/test/">Test</a></li>
+          <li><a href="/test/flood/">Flood</a></li>
+          <li><a href="/apreq/">libapreq</a></li>
+          <li><a href="/modules/">Modules</a></li>
+          <li><a href="/cli/">cli (.NET)</a></li>
+        </menu>
+      <p><b><a 
+href="/info/">Miscellaneous</a></b></p>
+    <menu compact="compact">
+          <li><a href="/contributors/">Contributors</a></li>
+          <li><a href="/awards.html">Awards</a></li>
+          <li><a href="http://webring.com/hub?ring=apachesupport">Support<br
/>Webring</a></li>
+        </menu>
+    </td>
+    <!-- RIGHT SIDE INFORMATION -->
+    <td align="left" valign="top">
+                <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Installation instructions</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    <tt>mod_mbox</tt> is very easy to install and setup. First, we
+    need to build the module and make the Apache HTTPd webserver load
+    it. Then, we'll setup our archives repository and complete
+    Apache's configuration.
+  </p>
+<p>
+    <tt>mod_mbox</tt> has, of course, some requirements :
+  </p>
+<ul>
+    <li>Apache HTTPd &gt;= 2.0 (<tt>mod_mbox</tt> has been tested succesfully
with Apache 2.0.55, 2.2.0 and 2.3.0-dev)</li>
+    <li>APR and APR-Util &gt;= 0.9</li>
+    <li>APR-Util with Berkeley DB 4 capability</li>
+  </ul>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Download and build</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    You can download a source tarball or checkout sources via Subversion :
+  </p>
+<pre><code>
+    svn checkout https://svn.apache.org/repos/asf/httpd/mod_mbox/trunk mod_mbox
+  </code></pre>
+<p>
+    Then, build <tt>mod_mbox</tt> :
+  </p>
+<pre><code>
+    ./autogen.sh
+    ./configure --enable-experimental-libtool --with-apxs=`which apxs`
+    make clean all
+    su -c 'make install'
+  </code></pre>
+<p>
+    Refer to the configure help (<tt>./configure --help</tt>) if you
+    need a to specify an installation prefix (<tt>--prefix=...</tt>)
+    or any other specific setup.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Preliminary Apache setup</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    The next step is to make Apache HTTPd load the <tt>mod_mbox</tt>
+    module at runtime :
+  </p>
+<pre><code>
+    cd /etc/apache2/mods-available/
+    echo "LoadModule mbox_module /usr/lib/apache2/modules/mod_mbox.so" &gt; mbox.load
+    cd ../mods-enabled/
+    ln -s ../mods-available/mbox.load .
+  </code></pre>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Repository setup</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    <tt>mod_mbox</tt> is a mail archive browser. Having mail archives
+    to browse would be a good idea. For the following steps, we'll
+    assume that you have a directory (let's call it <tt>foo</tt>) with
+    your <tt>.mbox</tt> files. Indeed, <tt>mod_mbox</tt> needs a
+    static preprocessing of the archives before being able to run. For
+    that, we'll use the tool <tt>mod-mbox-util</tt> that was compiled
+    with the module itself at build time :
+  </p>
+<pre><code>
+    mod-mbox-util -v -c foo/
+  </code></pre>
+<p>
+    <strong>Don't forget to run <tt>mod-mbox-util</tt> each time you
+    update your <tt>.mbox</tt> files !</strong>
+  </p>
+<p>
+    If you haven't done so yet, you must move your archives to a
+    directory in your Apache's <tt>DocumentRoot</tt> (or create a
+    symbolic link to your directory in it) :
+  </p>
+<pre><code>
+    mkdir -p ~www-data/archives
+    mv foo/ $_
+    cp mod_mbox/data/* $_
+    chown -R www-data:www-data $_
+  </code></pre>
+<p>
+    You can host multiple mailing list archives with
+    <tt>mod_mbox</tt>, each stored in a separate directory. If you are
+    doing so, you should consider adding an index file, displaying a
+    list of all hosted archives.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>mod_mbox configuration</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    The last thing you need to do in order to get your
+    <tt>mod_mbox</tt> up and running is to configure Apache so that it
+    will call <tt>mod_mbox</tt> when trying to read a <tt>.mbox</tt>
+    file. The following configuration snippet is a good start :
+  </p>
+<pre><code>
+    AddHandler mbox-handler .mbox
+    &lt;LocationMatch /archives/([^/]+)&gt;
+        MboxIndex On
+        MboxRootPath "/archives/"
+        MboxStyle "/archives/style.css"
+        MboxScript "/archives/archives.js"
+        MboxHideEmpty On
+        MboxAntispam On
+    &lt;/LocationMatch&gt;
+  </code></pre>
+<p>
+    Please refer to the configuration directives <a href="ref.html">reference</a>
for more information on these
+    directives.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+         </td>
+   </tr>
+   <!-- FOOTER -->
+   <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+   <tr><td colspan="2" align="center">
+        <font size="-1">
+         <em>Copyright &#169; 1999-2005, The Apache Software Foundation</em>
+        </font>
+       </td>
+   </tr>
+  </table>
+ </body>
+</html>

Propchange: httpd/site/trunk/docs/mod_mbox/install.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: httpd/site/trunk/docs/mod_mbox/ref.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/mod_mbox/ref.html?rev=357192&view=auto
==============================================================================
--- httpd/site/trunk/docs/mod_mbox/ref.html (added)
+++ httpd/site/trunk/docs/mod_mbox/ref.html Fri Dec 16 09:44:26 2005
@@ -0,0 +1,223 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+               "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+ <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+       <meta name="author" content="HTTPd developers" /><meta name="email" content="dev@httpd.apache.org"
/>
+    <title>mod_mbox - Mailing list archives browser - The Apache HTTP Server Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="../images/httpd_logo_wide.gif" alt="The Apache HTTP
Server Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+   <tr>
+    <!-- LEFT SIDE NAVIGATION -->
+    <td valign="top" nowrap="nowrap">
+     <a href="http://apachecon.com/"
+       ><img src="/images/apachecon_2005us.jpg" height="59"
+         width="135" border="0" alt="ApacheCon US 2005" /></a>
+           <p><b>Essentials</b></p>
+    <menu compact="compact">
+          <li><a href="/ABOUT_APACHE.html">About</a></li>
+          <li><a href="http://www.apache.org/licenses/">License</a></li>
+          <li><a href="/docs/2.2/faq/">FAQ</a></li>
+          <li><a href="/security_report.html">Security<br />Reports</a></li>
+        </menu>
+      <p><b>Download!</b></p>
+    <menu compact="compact">
+          <li><a href="/download.cgi">from a mirror</a></li>
+        </menu>
+      <p><b><a 
+href="/docs/">Documentation</a></b></p>
+    <menu compact="compact">
+          <li><a href="/docs/2.2/">Version 2.2</a></li>
+          <li><a href="/docs/2.0/">Version 2.0</a></li>
+          <li><a href="/docs/1.3/">Version 1.3</a></li>
+          <li><a href="/docs/trunk/">Trunk</a> (dev)</li>
+        </menu>
+      <p><b>Get Involved</b></p>
+    <menu compact="compact">
+          <li><a href="/lists.html">Mailing Lists</a></li>
+          <li><a href="/bug_report.html">Bug Reports</a></li>
+          <li><a href="/dev/">Developer Info</a></li>
+        </menu>
+      <p><b>Subprojects</b></p>
+    <menu compact="compact">
+          <li><a href="/docs-project/">Docs</a></li>
+          <li><a href="/test/">Test</a></li>
+          <li><a href="/test/flood/">Flood</a></li>
+          <li><a href="/apreq/">libapreq</a></li>
+          <li><a href="/modules/">Modules</a></li>
+          <li><a href="/cli/">cli (.NET)</a></li>
+        </menu>
+      <p><b><a 
+href="/info/">Miscellaneous</a></b></p>
+    <menu compact="compact">
+          <li><a href="/contributors/">Contributors</a></li>
+          <li><a href="/awards.html">Awards</a></li>
+          <li><a href="http://webring.com/hub?ring=apachesupport">Support<br
/>Webring</a></li>
+        </menu>
+    </td>
+    <!-- RIGHT SIDE INFORMATION -->
+    <td align="left" valign="top">
+                <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>Reference documentation</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>
+    In order to run properly, <tt>mod_mbox</tt> needs some
+    configuration. Here follows a list and description of all
+    configuration directives understood by <tt>mod_mbox</tt>.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>MboxIndex Directive</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Activate <tt>mod_mbox</tt> index.</p>
+<pre><code>
+    MboxIndex On|Off
+  </code></pre>
+<p>
+    Setting this option to <i>On</i> will tell <tt>mod_mbox</tt>
to
+    handle directory listing. This will display a nice web page with
+    mailing list information, links to each month and the message
+    count for each mailbox.
+  </p>
+<p>Default is <i>Off</i></p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>MboxRootPath Directive</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Set archives root directory.</p>
+<pre><code>
+    MboxRootPath /archives/
+  </code></pre>
+<p>
+    Specify the mail archives root directory, relative to webserver's
+    <tt>DocumentRoot</tt>. When set, <tt>mod_mbox</tt> will add
+    <i>Site Index</i> link on generated webpages, letting the user
+    fall back to the list of mailing list archives hosted on the
+    server.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>MboxStyle Directive</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Set archives stylesheet file.</p>
+<pre><code>
+    MboxStyle /archives/style.css
+  </code></pre>
+<p>
+    When set, <tt>mod_mbox</tt> will use this stylesheet file. The
+    path is relative to the webserver's <tt>DocumentRoot</tt>. This is
+    highly recommended since the dynamic browser won't work as
+    expected without a correct stylesheet.
+  </p>
+<p>
+    The ASF's default stylesheet is bundled with <tt>mod_mbox</tt>
+    sources and releases. Using it is generally a good start.
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>MboxScript Directive</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Set <tt>mod_mbox</tt>'s javascript file.</p>
+<pre><code>
+    MboxScript /archives/archives.js
+  </code></pre>
+<p>
+    When set, you will be able to use <tt>mod_mbox</tt>'s dynamic
+    browsing interface, an AJAX (Asynchronous Javascript and XML)
+    application. A working javascript file is bundled with
+    <tt>mod_mbox</tt>, don't forget to copy it if you want to use it !
+  </p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>MboxHideEmpty Directive</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Hide empty mailboxes from index listing.</p>
+<pre><code>
+    MboxHideEmpty On|Off
+  </code></pre>
+<p>
+    This directive tells <tt>mod_mbox</tt> to hide empty (with zero
+    message) mailboxes from his index listings.
+  </p>
+<p>Default is <i>On</i></p>
+  </blockquote>
+ </td></tr>
+</table>
+           <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+  <font color="#ffffff" face="arial,helvetica,sanserif">
+   <strong>MboxAntispam Directive</strong>
+  </font>
+ </td></tr>
+ <tr><td>
+  <blockquote>
+<p>Enable email obfuscation.</p>
+<pre><code>
+    MboxAntispam On|Off
+  </code></pre>
+<p>
+    This directive tells <tt>mod_mbox</tt> to enable a
+    content-destructive email obfuscation, thus avoiding spam to
+    mailing list users. For exemple,
+    <tt>localpart@localdomain.com</tt> will be converted to
+    <tt>localp...@localdomain.com</tt>.
+  </p>
+<p>Default is <i>On</i></p>
+  </blockquote>
+ </td></tr>
+</table>
+         </td>
+   </tr>
+   <!-- FOOTER -->
+   <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+   <tr><td colspan="2" align="center">
+        <font size="-1">
+         <em>Copyright &#169; 1999-2005, The Apache Software Foundation</em>
+        </font>
+       </td>
+   </tr>
+  </table>
+ </body>
+</html>

Propchange: httpd/site/trunk/docs/mod_mbox/ref.html
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: httpd/site/trunk/docs/modules/index.html
URL: http://svn.apache.org/viewcvs/httpd/site/trunk/docs/modules/index.html?rev=357192&r1=357191&r2=357192&view=diff
==============================================================================
--- httpd/site/trunk/docs/modules/index.html (original)
+++ httpd/site/trunk/docs/modules/index.html Fri Dec 16 09:44:26 2005
@@ -115,10 +115,10 @@
  </td></tr>
  <tr><td>
   <blockquote>
-<p>Do you want to setup mail archives with Apache httpd-2.0?  Try out
-mod_mbox.</p>
+<p>Do you want to setup mail archives with Apache HTTPd 2.x ?  Try out
+<tt>mod_mbox</tt>.</p>
 <ul>
-<li>Website: <a href="http://httpd.apache.org/mod_mbox">mod_mbox</a></li>
+<li><a href="http://httpd.apache.org/mod_mbox">Website</a></li>
 <li>Source: <a href="https://svn.apache.org/repos/asf/httpd/mod_mbox/trunk">mod_mbox</a></li>
 <li>ViewCVS: <a href="http://svn.apache.org/viewcvs.cgi/httpd/mod_mbox/">mod_mbox</a></li>
 <li>Mailing list: <a href="mailto:dev-subscribe@httpd.apache.org">dev@httpd.apache.org</a></li>



Mime
View raw message