On 09/11/2015 12:56 PM, Katie Welles wrote: > Have any of you PDF + HTML output with Docbook? If anyone has such a project > and will be willing to show it off, send some URLs!
I have been using DocBook to document APIs for a long time. Most recently I have been working on a C and C++ standard backed by the Object Management Group (which imposes its own formatting rules). The results can be seen in http://portals.omg.org/hpec/content/specifications (The sources for these, together with the custom stylesheets are in https://github.com/vsip/specs. > As an aside: Have any of you used asciidoc? I have not. I have used a variety of other languages (markdown, ReST, etc.) to add API documentation into source code, and extract and translate that to DocBook. In particular, the Boost.org project (http://boost.org) uses a DocBook extension called BoostBook with additional markup for C++ APIs. (A few years ago I mentored a GSoC student to rebase that work over DocBook 5. That's unfortunately not entirely finished. I hope to be able to complete this eventually, once the DocBook repo migrates to github and gets cleaned up a little.) Regards, Stefan -- ...ich hab' noch einen Koffer in Berlin... --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
