QuickHP - A minimalistic webbased homepage administrator
=======================================================================
Version 0.2 - 2001-06-04 - Thank you for using QuickHP!
Copyright (C) 2001 Manuel Kiessling
=======================================================================

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 2 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, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
USA.

=======================================================================
Due to the fact that my mother language is not english, it is possible
or better very probably that there are several mistakes - i hope they
are at least funny... if you find one, then please send me an eMail to
manuel@kiessling.net. Thank you very much!
=======================================================================


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

You need a webserver that supports at least PHP version 3.
Version 4 is recommended.
<http://www.php.net>


Installation:
-------------

Extract the archive.

Now ftp the files on your webserver. If your homepage is located at
http://www.domain.com/~johndoe/ then put the files beneath
http://www.domain.com/~johndoe/admin/

Now secure the directory admin with .htaccess or whatever, so only you
have access to it. That is important!

Then chmod the directory http://www.domain.com/~johndoe/admin/userdata
to 0777, so the web-scripts can write into it.

In your browser, open this adress:

http://www.domain.com/~johndoe/admin/browse.php

You see the directory listing of the directory userdata, and you should
only see a directory called 'templates'. You should now create 2 new
directories with the browse tool, not with your ftp program. Go to the
form field "create new directory:" and enter 'input', then hit,
'create', then enter 'output' in the field, hit 'create' again. You
should now have these directories:

http://www.domain.com/~johndoe/admin/userdata/templates
http://www.domain.com/~johndoe/admin/userdata/input
http://www.domain.com/~johndoe/admin/userdata/output

These are required to run QuickHP. You will create your XML files
beneath 'input', and when you start the parsing, preview files will be
created beneath 'output'.

The last step is to chmod 0777 your johndoe directory, so QuickHP can
copy the parsed files to your homepage root.

I give you a basic example how QuickHP works.

First, you go to the directory 'input' (just click on the name).
Then you create a new file 'index.xml' using the template
'standardxml'. After hitting 'create', you click on the link 'xml'
in the 'Edit' column of the directory listing. Then you see the xml
file editor. Enter the appropriate values in the fields, enter some
content, and hit 'Save file'.

If now you click 'Start parsing', the following things will happen:

The script reads the file userdata/templates/html/structure.qsf,
then it reads every file beneath the 'input' folder, replaces the
placeholders in the structure file with the values in the input file
and creates an according .html file beneath the 'output/html' folder.

You can now browse to the 'output/html' folder and click on
'index.html' to see the result.

If in the parsing window you click 'Copy into system', the file

http://www.domain.com/~johndoe/admin/userdata/output/html/index.html

is copied to

http://www.domain.com/~johndoe/index.html

Got it?



The homepage of QuickHP is:
http://www.kiessling.net/home/manuel/projects/software/quickhp/

Please send me an eMail with your opinion about QuickHP.
Send me an eMail if you have questions.
If you are a PHP programmer then give me feedback about the code.

Manuel Kiessling
manuel@kiessling.net
