From 6e3631546f71eab5846de4ce653251084aa400fc Mon Sep 17 00:00:00 2001 From: Silvio Rhatto Date: Thu, 9 Feb 2012 10:30:27 -0200 Subject: More style on indexes --- files/icons/README | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 files/icons/README (limited to 'files/icons/README') 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 . + + +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. + -- cgit v1.2.3