We are migrating from a homebuilt doc toolchain to asciidoctor. We need PDF-output, but due to issues with the current (alpha-level) backend, we cannot use that. I understand that the proper alternative then is to go via docbook.
* Are there any examples of this, anywhere? * In particular, are there any examples using gradle to do this? https://github.com/asciidoctor/asciidoctor-gradle-examples only has examples using the pdf backend, which does not work for us. Eirik |
Administrator
|
I recommend looking at either the Hibernate ORM or the Sprint projects. They both use the setup you describe. For example, see https://github.com/hibernate/hibernate-orm/blob/master/documentation/documentation.gradle#L236-L257 Cheers, -Dan On Wed, Jul 13, 2016 at 1:57 AM, elygre [via Asciidoctor :: Discussion] <[hidden email]> wrote: We are migrating from a homebuilt doc toolchain to asciidoctor. We need PDF-output, but due to issues with the current (alpha-level) backend, we cannot use that. I understand that the proper alternative then is to go via docbook. Dan Allen | @mojavelinux | https://twitter.com/mojavelinux |
So, truth to be told, I found both of these quite confusing: * Spring uses a custom docbook plugin that really only generates their reference document * Hibernate doesn't seem to generate pdf through their docbook toolchain (only html and html_single) It gave me somewhere to start, though, and after waaay to much fiddeling something works. I haven't really tried it out on our big docs yet, but I have created a sample project that illustrates the concept: https://github.com/asciidoctor/asciidoctor-gradle-examples/pull/27 Eirik On Wed, Jul 13, 2016 at 10:19 AM mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
|
Administrator
|
Thanks Eirik! That just proves why a straightforward example belongs in this repository. Cheers, -Dan On Tue, Jul 19, 2016 at 2:16 AM, elygre [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux |
Free forum by Nabble | Edit this page |