search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
322 stars 805 forks source link

TOCtree #786

Closed elzibubble closed 6 years ago

elzibubble commented 6 years ago

How can I get something like this please? http://www.sphinx-doc.org/en/stable/markup/toctree.html

Manually generating toctrees is unnecessary labour and a recipe for merge conflicts.

mojavelinux commented 6 years ago

Does the toc attribute work for your use case, or did you have something else in mind?

https://asciidoctor.org/docs/user-manual/#user-toc

elzibubble commented 6 years ago

I don't think so - I want to be able to form a TOC of multiple files, whereas iirc TOC only works within a file.

On Wed, 2 May 2018, 19:20 Dan Allen, notifications@github.com wrote:

Does the toc attribute work for your use case, or did you have something else in mind?

https://asciidoctor.org/docs/user-manual/#user-toc

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/asciidoctor/asciidoctor.org/issues/786#issuecomment-386073117, or mute the thread https://github.com/notifications/unsubscribe-auth/AAFa5ki9chzCHlsTldyfxGzwKdHh-Mlvks5tufjrgaJpZM4TvOug .

mojavelinux commented 6 years ago

That's outside the scope of the Asciidoctor processor. The processor only knows about the current file it's processing. But there's where Antora comes in. Antora operates on a catalog of files and thus has the necessary scope to make such a thing. It's also possible to achieve something like this using other site generators such as Jekyll or Middleman. But Antora is the one designed specifically for AsciiDoc.

elzibubble commented 6 years ago

Hmm ok, thanks