----------------------------------------------------------------------
                           Gpg4kde Web Site
----------------------------------------------------------------------

INTRODUCTION:

Getting the source:

You can work on the website independently of the rest of gpg4kde.
First check out the website from SVN repository:

  svn checkout svn+ssh://USER@svn.wald.intevation.org/gpg4kde/trunk/doc/website

where USER is you name at wald.intevation.org.
If you are not a member of the gpg4kde group at wald.intevation.org,
you can also checkout anonymously:

  svn checkout https://svn.wald.intevation.org/gpg4kde/trunk/doc/website

but of course you can not update the official website www.gpg4kde.org
this way.


File organisation:

The .html files are build from the *.htm4 files using GNU m4.  The
*.htm4 files consist of mainly simple plain HTML and some macros
implementing the overall page layout.

The structure of the .htm4 files should be rather self explaining.


BUILDING:

Building the web site is _not_ incorporated into the autotools based
build process.

To build to web sites use 

  make 


INSTALLING:

To install the generated web site you need a gpg4kde docwriter or
developer account on wald.intevation.org.

Installing is done from within the "doc/website" directory,
just type:

  make online

You will have to enter the ssh password of your account at wald.intevation.org.

If you are interested on web site management on wald.intevation.org
in general, please read the online manual:
http://wald.intevation.org/docman/view.php/1/34/project-websites.txt

If you need the website as offline version for some other
purposes just run:

  make -f buildhtml.mk tar

After that you have the file "www.gpg4kde.org.tar.gz".

TEMPLATES:

template.m4 : Contains the definition of the main macros PAGE_START
              and PAGE_BOXES as well as some helper macros normally
              not used in the .htm4 files.  Authors should not need to
              change this file.

template_header.m4: Contains the actual page layout.  This file is
                    included by `template.m4'.  Authors should not
                    need to change this file, but if additional
                    languages are added the navigation must be added
                    in here.

template_link_boxes_en.m4,
template_link_boxes_de.m4: Contains the link boxes in the right
                           column of the page.