46 ms·
> Or perhaps both, giving readers the opportunity to choose whichever they like. Yeah, good old texinfo-style entirely-on-one-page and one-page-per-node model
by oefrha 6y ago
> Or perhaps both, giving readers the opportunity to choose whichever they like.
Yeah, good old texinfo-style entirely-on-one-page and one-page-per-node model (as seen on the documentation page of any GNU project, e.g. https://www.gnu.org/software/texinfo/manual/texinfo/ https://www.gnu.org/software/texinfo/manual/texinfo/) is heavily underrated and underutilized in “modern” documentation systems.
Want to quickly search for something in the entire manual? Use the one page version. Want to read cover to cover or link to a specific topic? Use the split up version.
Btw, this book is apparently written in AsciiDoc and generated by Asciidoctor. There seems to be a multi-page plugin available, although I haven’t tried it myself.
https://github.com/owenh000/asciidoctor-multipage https://github.com/owenh000/asciidoctor-multipage
https://github.com/asciidoctor/asciidoctor/issues/626 https://github.com/asciidoctor/asciidoctor/issues/626