 #############################################################################
 # phpCDLabelPS                             (c) 2002-2003 by Itzchak Rehberg # 
 # ------------------------------------------------------------------------- # 
 # Reads in data disks and creates CDLabels based on that information and a  # 
 # given template, output will be a PostScript Level 2 file. License: GPL    # 
 # ------------------------------------------------------------------------- # 
 # This is the installation instruction and disclaimer                       # 
 #############################################################################

Installation instructions:
--------------------------

Very brief: Just extract all files somewhere in your webtree. Then point
your browser to cdlabel.php - that's it. You may want to check the config.inc
file and change the default values to your own preferences at any time: it
just sets up the initial form values. One thing you may want to adjust right
in the beginning is the mount-point of your media.

Requirements:
-------------

Some WebServer with PHP support (Apache & PHP4 work great). Some program to
open/print PostScript files with.
Linux users: all you need ships with your distribution.
Windoze users: you may need to get some PostScript interpreter. Watch out
for Ghostscript: http://www.google.com/search?q=ghostscript%20windows
Mac users: see Windows users and http://www.google.com/search?q=ghostscript%20mac

Usage:
------

Put your CD into the drive (unless you want to create a lable for something
else, like your hard drive - which is theoretically possible; but the problem
is to attach the label then ;) Under Unix/Linux you may have to mount the
drive (some systems do this automatically).
Now open cdlabel.php with your browser and enter all needed information:
Mountpoint    - where your CD is mounted. For Windows users, this should be
                the drive letter followed by a colon.
Name/title    - what should be printed on the sides and on top of the list
FontSize      - depending on the amount of files/dirs, the list may get quite
                long. By decreasing the font sizes, you get more of your content
                listed on the cover. Everything that doesn't fit on anymore is
	        simply "truncated". You may have to play with it a bit.
Display       - for some DVD with a huge amount of files you may wish to just
                display all directories. Here you have the choice to even
                define something weird as "nothing/nothing" to just get an
	        empty cover (completely empty if you ommit the name/title
	        value as well).
Max Levels    - how deep to dig into the rabbit hole. "0" means just the
                Root directory. Increase by one for each level.
Print label   - wether to position the label on top or bottom of the page
After create  - you may wish to place two labels on one sheet of paper. In
                this case, select "leave in buffer" for the first label, and
		"print and eject" PLUS "add to buffer" for the second label.
		Of course, you shouldn't place both labels on the top of
		the page (or both on the bottom :)
Add to buffer - if you put the previous label just into the buffer, you may
                want to add this one to the same.

If you want to put two labels on one sheet of paper, you may sometimes run
into trouble when printing directly (my printer discards the buffer after a
really short time if I don't print it). In this case, store both parts to
files, and just paste them together (*nix: "cat file2 >> file1"). Make sure
to append the *second part* (that's the one where you selected to "print and
eject" the page) to the first one and *NOT* vice versa. Sorry, found no better
way yet.


License:
--------

This program is protected by the Gnu Public License (GPL) version 2. For details
see the file LICENSE in this very same directory.

Disclaimer:
-----------

No warranty. Nada. Use at your own risk. Although it is unlikely, the author
will not guarantee that this program causes heart attacks, destroys your
toaster or kidnaps you hamsters. I'm only sure it consumes some space on
your hard disk if you unpack it there.

May 2002
Itzchak Rehberg
