Chapter 20. Website Maintenance
Prev | Part IV. Lire Developers' Conventions | Next

## Chapter 20. Website Maintenance

We give hints on how to upgrade the website: installing stuff from current CVS on http://logreport.org.

Commits to the CVS tree of the website are automatically propagated to hibou. For more information on the markup language of the website, see the WJML documentation.

## Documentation on the LogReport Website

Be sure the links to stuff under `/pub/current` are still alive. E.g. the files `TODO`, `dev-manual.html` and `user-manual.html` are linked to.

### Publishing the DTD's

The DTD's are published as HTML on the website by using `hibou:/usr/local/src/dtdparse/dtdparse-2.0b2-LogReportPatched.tar.gz`, which is a patched version of Norman Walsh's dtdparse utility. Before the utility is run, make sure that the DocBook DTD is not included in the parsing process, because the DocBook DTD should not be published. This is done by changing the line:

    <!ENTITY % load.docbookx     "INCLUDE"                               >

into:

    <!ENTITY % load.docbookx     "IGNORE"                               >

The webpages are then generated with:

    perl ~/dtdparse-2.0b2-patched/dtdparse.pl --title "XML Lire Report Markup Language" --output lire.xml lire.dtd
    perl ~/dtdparse-2.0b2-patched/dtdformat.pl --html lire.xml

The resulting `lire` directory can be tar-ed, gziped and unpacked again on hibou in the directory `/var/www/logreport.org/pub/docs/dtd/`.

The other two DTD's are HTML-ized similarly, but remember to change the title when running dtdparse.pl.

Prev | Up | Next
Advertising The Release | Home | Chapter 21. Writing Documentation