Posted by Andrew Chapman on Apr 15, 2020; 12:29pm
URL: https://discuss.asciidoctor.org/Generate-TOC-using-included-files-tp7851p7892.html

I was about to start a new thread, but scanned through and found this which seems very much related.

Is it possible to have the root document's TOC consist of links out to those sub-documents, and keep them as separate files, rather than including all the content in one doc?

I know I could just manually edit my own index, but would be nice to just include all the files and have the TOC managed.

I'm just getting started with asciidoctor, it seems like the perfect solution for user documentation when it is a single long document (e.g. intended for output as a printed manual or PDF) but I'm trying to work out how to best use it for managing a collection of separate documents each on their own topic. I expect different users will want to explore down different paths, so in my case it doesn't feel right to just jam it all together into a single doc.

I get the feeling I'm trying to do something which is philosophically different to what asciidoctor is intended for though, so any suggestions appreciated.

Cheers.