Friday, January 10, 2014

Apaxy - An Customisable Apache HTTP Theme

Apaxy is a customisable theme built to enhance the experience of browsing web directories. It uses the mod_autoindex Apache module—and some CSS—to override the default style of a directory listing.

To download:
Apaxy Github

Apaxy may be basic, but it gives you a great deal of creative freedom when styling your directory.
  • Style your directory listing with CSS.
  • Make it pop with Javascript or jQuery.
  • Add welcome messages, download instructions or copyright notices.
  • Add custom mime type icons (requires editing the .htaccess file).
Apaxy requires an Apache(2.0.23+) enabled HTTP server.

Let's assume you have a folder named share in your server root directory (the path thus being that you'd like to use as your listing directory:
  1. Download and unzip Apaxy.
  2. Copy and paste the contents of the /apaxy folder to your /share folder.
  3. Edit htaccess.txt (now in the /share folder) and update all instances of paths marked with {FOLDERNAME} to point to your site root.
AddIcon /{FOLDERNAME}/theme/icons/gif.png .gif
Should be changed to…
AddIcon /share/theme/icons/gif.png .gif

Once done, rename htaccess.txt to .htaccess in both the /share and /share/theme folders.

That's all there is to it. Your /share folder—and any of it's subdirectories—will no longer be hideous.

Make sure in your apache conf file, or site-enabled/site file, you have "AllowOverride all" directive enabled. Otherwise Apaxy might not work.
For example:
<Directory /var/www/share>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride all
Also, make sure module "autoindex" is enabled.

No comments: