Google
  Web www.spinics.net

Re: Converting PyDoc to Docbook XML?

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]


On Thu, Jul 26, 2012 at 9:26 AM, Steve Gordon <sgordon@xxxxxxxxxx> wrote:
> 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.

Sorry, I haven't tried this, as I haven't spent a lot of time in PyDoc.

> 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]:

This is almost guaranteed to cause heartburn, as the HTML and XHTML
tend to tag items based on appearance (bold, italics, CSS styling)
rather than their inherit types (section, paragraph, emphasis, program
listing, and footnote just to name a few).

--
Jared Smith
-- 
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs



[Home]     [Fedora Legacy]     [Fedora Desktop]     [Red Hat 9 Bible]     [Fedora Bible]     [Red Hat 9]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]

Powered by Linux

Google
  Web www.spinics.net