1 files changed, 80 insertions, 0 deletions
diff --git a/files/icons/README b/files/icons/README
new file mode 100644
index 0000000..f6932f8
--- /dev/null
+++ b/files/icons/README
@@ -0,0 +1,80 @@
+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 <http://www.gnu.org/licenses/>.
+
+
+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:
+
+<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.
+
+
+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.
+