Yes I noticed asciidoc is also part of O'Reilly's new html5 based toolchain, htmlbook. In earlier discussions with Jason I figured that it would make sense to move maybe a year or so down the line. For the moment docbook5 seems to be working ok.
Currently there aren't good open source tools for doing the pdf generation (from html5+css3) but they are coming. Tools like prince (http://www.princexml.com/) work well but are pricey. Though you can use it for non-commercial purposes if you don't mind the prince logo you get stuck on your document. I've tried it on the o'reilly htmlbook output and it does work :-) I'm sure the open source convertors are on the horizon. On 29 April 2016 at 18:49, Lars Helge Øverland <l...@dhis2.org> wrote: > Seems asciidoc and asciidoctor are getting traction, Spring is using it now > for guides: > > https://spring.io/blog/2013/12/13/spring-s-getting-started-guides-migrated-to-asciidoctor > > Seems like something to consider if we want to move to a more light-weight > alternative than docbook. It lets you generate nice html5 layouts with menus > like these: > > http://docs.spring.io/spring-restdocs/docs/1.0.x/reference/html5/#documenting-your-api > > http://infinispan.org/docs/8.2.x/user_guide/user_guide.html > > > -- > Lars Helge Øverland > Lead developer, DHIS 2 > University of Oslo > Skype: larshelgeoverland > http://www.dhis2.org > > > _______________________________________________ > Mailing list: https://launchpad.net/~dhis2-documenters > Post to : dhis2-documenters@lists.launchpad.net > Unsubscribe : https://launchpad.net/~dhis2-documenters > More help : https://help.launchpad.net/ListHelp > _______________________________________________ Mailing list: https://launchpad.net/~dhis2-documenters Post to : dhis2-documenters@lists.launchpad.net Unsubscribe : https://launchpad.net/~dhis2-documenters More help : https://help.launchpad.net/ListHelp