Chunked HTML

[tajmone]

Must find a good way to produce an HTML version of the book split by chapters (chunked HTML) while preserving cross references, a TOC for each chapter and a general TOC for the whole book.

See:

• https://github.com/owenh000/asciidoctor-multipage (Asciidoctor <= v1.5.7.1)
• Support chunked (multi-page) HTML output in asciidoctor asciidoctor/asciidoctor#626

[jasal82]

Any progress on this? We really need the chunking feature because our (generated) documents are getting huge and loading times are already around 30s to 1min for the single-file html output.

[tajmone]

Any progress on this?

Unfortunately not. The asciidoctor/asciidoctor#626 Issue still remains the main reference for this needed feature, but all the current solutions brought forward to this moment have either serious limitations for advanced features (X-Refs, sections numbering, etc.) or are bound to a specific version of Asciidoctor.

We really need the chunking feature because our (generated) documents are getting huge and loading times are already around 30s to 1min for the single-file html output.

Mee too, I've worked on various reprints of whole books in AsciiDoc format and are currently stuck to the single page HTML doc, which is better than nothing but is indeed a "heavy-weight" solution. I'm confident that ultimately the Asciidoctor project will manage to provide these features, but being a collection of numerous subprojects this might require still some time (probably in the order of a few years to come).

The only other solution that comes to my mind is using HTMLBook via DocBook, which is mature and does allow to create fully indexed books, split by chapter, although its design targets mainly documentation. This is the best solution presently available, as far as I know. Tweaking styles might require some additional work though, and syntax highlighting is probably bound to the tools supported by the DocBook toolchain (this being the main deterrant for embracing it, in my case).

If you bump into alternative solutions, please do update me on them.