search

asciidoctor / asciidoctor-maven-examples

A collection of example projects that demonstrates how to use the Asciidoctor Maven plugin.
http://asciidoctor.org/docs/asciidoctor-maven-plugin
Other
195 stars 245 forks source link

Add multi-page (chunked) html output option to jdocbook and docbkx #14

Open mojavelinux opened 9 years ago

mojavelinux commented 9 years ago

Add html output to both the jdocbook and docbkx example projects. That way, users can see how they can get from AsciiDoc to multi-page (chunked) html output using the Maven plugin.

gAmUssA commented 9 years ago 
<format>
         <formatName>xhtml</formatName>
         <stylesheetResource>classpath:/xslt/org/jboss/pressgang/xhtml.xsl
         </stylesheetResource>
</format>

this code snippet configures output of html. However, it uses jboss specific styles. How do output html with asciidoctor stylesheet?

mojavelinux commented 9 years ago

How do output html with asciidoctor stylesheet?

There are no Asciidoctor-like styles for the HTML output produced by the DocBook toolchain as of today. The default Asciidoctor stylesheet won't work because the HTML produced by DocBook is quite different from what Asciidoctor produces.

Using the DocBook toolchain to produce chunked HTML output is an intermediary solution to at least get chunked output (until we get around to making it work natively in Asciidoctor). Of course, someone could develop a stylesheet for the HTML output produced by DocBook that looks like the default Asciidoctor stylesheet, but it would be a substantial effort.

gAmUssA commented 9 years ago

@mojavelinux What would be your recommendation in terms of using asciidoctor-style-factory styles and dock output ?

mojavelinux commented 9 years ago

@gAmUssA That's not really going to help you since CSS is heavily dependent on the HTML it's styling. The HTML output from DocBook is fundamentally different than what the HTML5 backend of Asciidoctor (and AsciiDoc Python) produce (even more so because it's multi-page HTML).

It really doesn't take that long to create a decent stylesheet from scratch, so that's what I propose. The alternative is to look for a better stylesheet for the DocBook HTML output somewhere on the web. There are many projects that have used this toolchain, so there are probably a number of options out there that can at least get you by until we have the multi-page HTML working in Asciidoctor.