jbake: AsciiDoc table of contents is not rendered

A AsciiDoc table of contents is not generated, when :toc: is used.

See http://asciidoctor.org/docs/user-manual/#user-toc.

JBake version is 2.2.1-SNAPSHOT, 7be8a72022e6b7f908ba2e5386ec5affccd10c98

About this issue

Original URL
State: closed
Created 10 years ago
Comments: 25 (18 by maintainers)

Most upvoted comments

Actually, the table is rendered, if the following two attributes are set:

:toc:
:toc-placement: preambe

Notice, that the default value for toc-placement is auto, not preamble.

Now, if you have a non-empty preamble, you will see the TOC. No need to place the toc::[] macro. But, if your preamble is empty (e.g. no sentence before the first section header), no TOC is rendered. If you use an toc-placement value other than preamble, a TOC is never rendered.

So, one issue is the no-TOC-in-non-preamble problem, which might be caused by a conflict between bootstrap and asciidoctor css, as pointed out before.

For the other issue, no-TOC-if-preamble-is-empty, maybe some Asciidoctor(J) dev can help?

lefou on Feb 14, 2014