Apache Manual

From KallestadWiki

Using the Apache Manual without mod_negotiate

I've stripped mod_negotiate from my apache implementation because I simply do not use the functionality at all.

The apache manual requires it's usage out of the box - as it has the manual available in a variety of languages.

Here's what I did to make it work without mod_negotiate.

First copy the manual into a published directory:

cp -R manual/** /var/www/myhtmldir/apache-manual/

Next, find all the html.en files since I actually want to reference the manual in english and stick them in a file:

find ./ * |grep .html.en > enfiles.txt

Next, download your enfiles.txt file

www.yoursite.com/apache-manual/enfiles.txt

After that, I used ultra-edit's column mode to create a shell script that basically reads 320+ lines similar to what follows:

cp ./bind.html.en                                       ./bind.html    

You can download my script here, and just run it with sh cp.sh (for apache 2.0)

The end result is here: http://www.stevekallestad.com/apache-docs/

I'd still like to actually run an sed/awk script to remove the links to apache so I don't accidentally end up at their site, like I've done a few times already. I prefer to have the docs locally because I can either edit the files with my own notes, update the docs as needed, or link directly to the documents and I know that the version I'm referencing will always be there. That and I'm not robbing the apache foundation of bandwidth unnecessarily and I also know that if my site is up, my apache documentation is up and available. A few times in the past, the documentation at apache has been down when I needed it.