---------------------------------------------------
How to set up BlorpScript, etc (a work in progress)
---------------------------------------------------

Requirements
BlorpScript requires PHP 4 (it might work with 3).
For thumbnail generation, BlorpScript requires either the
GD library compiled in with PHP, or ImageMagick (specifically,
the "convert" command) installed. Thumbnail generation/display 
can also be disabled completely (for those times you don't have
either installed), or set to manual (if you're a picky bastard
and really like to make your own).

Installation/Configuration
Copy index.phtml and DOTblorpconfig.php to a directory, and rename
DOTblorpconfig.php to .blorpconfig.php . 

Edit the .blorpconfig.php to suit your needs. (TODO: how to 
configure it).

Finally, in order to let the script create and cache thumbnails in, 
you must create a directory called '.thumbnails' in the same
directory as the script. On unix systems, set the permissions of 
this directory to something both you and the web server can read
and write to (i.e. 777 or ugo+rwx).

In order to use the comments feature, create a directory called 
'.comments', in the same directory as the script. Set the permissions
to 777 as well (like the .thumbnails directory).

Setting up content
The way BlorpScript works is by scanning directories and all 
subdirectories (that don't begin with a .) for files (that 
also do not begin with a .) to let the user browse. Currently
supported are the following:
  * Images (JPG,JPEG,GIF,PNG)
  * Text (TXT)
  * Code (JAVA,ASM,INC,C,CPP,PHPS,PHP-SOURCE,H)
  * Audio (WAV,MP2,MP3)
  * Video (MOV,AVI,MPG,MPEG)
  * Archive (ZIP,RAR,TGZ,ARJ,ARC,LZH,etc)

It is easy to add more.

So you can make directories, and put your content in them.

You can make the page of a particular directory have text in
it (like this page) by creating a file '.index.txt' in that
directory. The first line is automatically styled. The
text in that text file is essentially in a <PRE> tag.

You can make directories have their own thumbnail images, by 
creating a file in that directory called '.dir.jpg'. That
file should be appropriately small.

If you want to disable comments for a particular directory
(not the files in it, but just the directory listing), create
a file .nodircomments in that directory.

You can have text displayed about an image that is being
viewed by creating a file with the same name as the image
(though starting with a '.') plus '.txt'-- for example, 
'hi.jpg' would need a file named '.hi.jpg.txt'.