Forum OpenACS Q&A: Response to HowTo on DocBook written...

Collapse
Posted by Joel Aufrecht on

Dennis, I wasn't able to get anywhere with that URL - it seems to get mangled when used.

For those keeping score at home, here's where I'm at trying to convert a Docbook xml file to HTML:

Previously:

1) mucked with catalog files until emacs agreed to parse xml DTDs in psgml mode

2) tried to use openjade to convert xml to html

Most Recently:

1) As per advice, downloaded docbook-xsl. Used this command:

xsltproc --catalogs --nonet --verbose /usr/share/sgml/docbook-xsl-1.45/html/docbook.xsl index.xml
  (gazillions of lines like 
    xsltParseStylesheetTemplate: mode  
    set.titlepage.recto.auto.mode
    xsltCompilePattern : parsing 'legalnotice'
    xsltCompilePattern : parsed legalnotice, default priority 0.000000
   omitted)
parsed 12 templates
Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd
requirements.xml:151: error: Entity 'nbsp' not defined
           
               ^
requirements.xml:609: error: chunk is not well balanced

^
index.xml:140: error: Entity value required
    &requirements;
                 ^
requirements.xml:151: error: Entity 'nbsp' not defined
           
               ^
unable to parse index.xml
When I removed the references to the child documents, I got an HTML output. So then I put the references back in and removed the nbsp tag, and got valid output, a non-quite-clean-looking HTML document in which all three xml documents were present in sequence. *shrug* That's at least enough to start working on documentation. I'll retrace my steps and write up a mini-howto, I guess.