Converting PyDoc to Docbook XML?

[Steve Gordon]

Hi all,

Has anyone attempted converting PyDoc to Docbook XML recently with success? I've tried a project called HappyDoc but it seems to be unmaintained and pretty poorly documented, though it claims on the project site to be able to generate DocBook XML.

I have also tried generating the PyDoc HTML with `pydoc -w <module>`, converting it to XHTML with tidy:

    tidy -indent -m -asxhtml -clean -bare -omit ovirtsdk.infrastructure.brokers.html

...and then turning it into Docbook with an XSLT [1]:

    java -cp "/usr/share/java/xalan-j2.jar" org.apache.xalan.xslt.Process -XSL html2db.xsl -IN <module>.html > <module>.xml

The resulting XML still has a *lot* of errors according to XMLLINT, even before applying the DTD rules. Anyone had any success with a variation of this or maybe a different method entirely?

Thanks,

Steve


[1] http://osteele.com/software/xslt/html2db/