dhis2-documenters team mailing list archive

[Bob Jolliffe <bobjolliffe@xxxxxxxxx>]

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 <lars@xxxxxxxxx> 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@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~dhis2-documenters
> More help   : https://help.launchpad.net/ListHelp
>