• panne's avatar
    [project @ 2004-08-15 20:28:02 by panne] · 53386c35
    panne authored
    <fanfare>Finally: Support for DocBook XML!</fanfare>
    After endless frustrating hours, I came to the conclusion that using (Open)Jade
    for DocBook XML is virtually impossible, there are *tons* of problems with it:
    Wildly differing paths, incorrect stylesheets, broken catalogs at funny places,
    broken wrapper scripts, missing support on Cygwin etc.  >:-P * * *
    So we follow the ubiquitous XSL hype and use xsltproc + DocBook XSL stylesheets
    to transform DocBook XML to HTML and FO. From FO there are two routes to PDF and
    PostScript: Either via FOP (preferred) or via PassiveTeX. Validation can be done
    via xmllint using the new make target "validate". When PassiveTeX is available,
    DVI can be generated, too.  A new make target "no-chunks-html" is available for
    generating an all-in-one HTML document. Currently there is no way to generate
    plain text or RTF, but at least the former could easily be added.
    Generating HTML works out-of-the-box on Cygwin now, but you will have to install
    FOP for other formats, because there seems to be no standard package for it.
    The HTML appearance can be controlled via CSS, but the current location of the
    master stylesheet below fptools/mk is a bit debatable. Better suggestions are
    Currently there is still support for SGML documents, but it will be dropped when
    all documents are converted to DocBook XML. The build system is complex enough
    already with the support for a *single* kind of DocBook...