Getting AsciiDoc -> DocBook XML -> PDF pipeline working on CentOS 5.3

I’m trying AsciiDoc to obviate the XML “tag soup” I am eating with my DocBook docs.

There were two things I had to tweak to get the asciidoc .TXT -> DocBook XML -> PDF pipeline working on CentOS 5.3:

1. Remove or comment out every mention of the “–nonet” switch in my xmlto (v0.0.23) (xmlto is the wrapper script for the DocBook XML -> PDF process). AsciiDoc generates DocBook XML 4.5, and the CentOS docbook-dtds package only goes up to 4.4, so we need to be able to access the DocBook XML 4.5 DTD over the net.

2. Do NOT put any author info into the AsciiDoc file, as leaving it in would break the LaTeX leg of the process. (DocBook XML -> XHTML would work fine, but DocBook XML -> PDF (or DVI) would break.) Once I took that out, I was able to generate PDF files.

I look forward to getting more experience with AsciiDoc, so far it looks promising.

Yours truly,
Aleksey