Index-Style is a set of html, css and image files designed to work together with the mod_autoindex module 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 Repos-Style, although the code itself is largely done from scratch (as mod_autoindex doesn’t support XSLT).
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://svn.recurser.com/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:
<VirtualHost *:80> ServerName download.recurser.com DocumentRoot /var/www/download.recurser.com Alias /icons/ /var/www/download.recurser.com/index-style/icons/ <Directory "/var/www/download.recurser.com"> AllowOverride All Order allow,deny Allow from all <IfModule mod_autoindex.c> 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 </ifModule> </Directory> </VirtualHost>
You’ll need mod_autoindex for any of this to work - it should be installed by default with Apache in most linux distributions.