This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . 1. About ---------------------------------------------- Index-Style is a set of html, css and image files designed to make the default apache file listings look a little nicer. The UI design is based almost entirely on the great work done by the guys at http://www.reposstyle.com/, although the code itself is largely done from scratch (as mod_autoindex doesn't support XSLT). 2) Installation ---------------------------------------------- First, get a copy of the index-style folder - the easiest way is to change to the document root of the domain you want to style, and check it out from subversion (in my case the domain will be download.recurser.com) : > cd /var/www/download.recurser.com > svn co http://recurser.com/svn/misc/apache/index-style/ This should create an 'index-style' folder in your document root. Next, you need to configure Apache to use the index-style files to style your directory listings. I use the following config, which you'll need to adjust to match your particular setup - the 'icons' alias and the 'mod_autoindex' section are the main areas to pay attention to: ServerName download.recurser.com DocumentRoot /var/www/download.recurser.com Alias /icons/ /var/www/download.recurser.com/index-style/icons/ AllowOverride All Order allow,deny Allow from all Options Indexes FollowSymLinks IndexOptions FancyIndexing IndexOptions VersionSort IndexOptions HTMLTable IndexOptions FoldersFirst IndexOptions IconsAreLinks IndexOptions IgnoreCase IndexOptions SuppressDescription IndexOptions SuppressHTMLPreamble IndexOptions XHTML IndexOptions IconWidth=16 IndexOptions IconHeight=16 IndexOptions NameWidth=* IndexOrderDefault Descending Name HeaderName /index-style/header.html ReadmeName /index-style/footer.html You'll need mod_autoindex for any of this to work - it should be installed by default with Apache in most linux distributions. 3. Disclaimer ---------------------------------------------- The formatting relies on a few javascript hacks which may or may not work exactly as intended if the output of your apache directory listings differs a lot from what is expected. If the output appears strange, try playing around with the javascript formatting in header.html, or drop me a line at recurser.com if you need a hand.