Asciidoctor :: Discussion

AsciidoctorJ does not create TOC

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

5 messages Options

Conrad

Jan 20, 2020; 6:56am

AsciidoctorJ does not create TOC

Hi,

I try to create a TOC. But it does not work. Why?

Conrad

Command:

C:\Program_Portable\asciidoctorj\bin\asciidoctorj.bat -b pdf 0_Documentation.adoc

adoc:

= Documentation
Version 0.1
:toc:
:toclevels: 4
:toc-title: Content
:imagesdir: ./img
:description: example AsciiDoc document
:keywords: Documentation
// 1. chap
== 1. Chap
This is the 1. chapter.
// 2. chap
== 2. Chapter
This is the 2. chapter.

mojavelinux

Jan 20, 2020; 7:10am

Re: AsciidoctorJ does not create TOC

Administrator

It's because the AsciiDoc header is invalid. It should look like this:

= Documentation

Author Name

v0.1

:toc:

Please see https://asciidoctor.org/docs/user-manual/#revision-number-date-and-remark

Best,

-Dan

On Sun, Jan 19, 2020 at 11:56 PM Conrad [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi,

I try to create a TOC. But it does not work. Why?

Conrad

Command:

C:\Program_Portable\asciidoctorj\bin\asciidoctorj.bat -b pdf 0_Documentation.adoc

adoc:

= Documentation
Version 0.1
:toc:
:toclevels: 4
:toc-title: Content
:imagesdir: ./img
:description: example AsciiDoc document
:keywords: Documentation
// 1. chap
== 1. Chap
This is the 1. chapter.
// 2. chap
== 2. Chapter
This is the 2. chapter.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/AsciidoctorJ-does-not-create-TOC-tp7499.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

Conrad

Jan 20, 2020; 7:10am

Re: AsciidoctorJ does not create TOC

In reply to this post by Conrad

Fixed.

I have to put the attributes at the beginning of the document.

I found the solution here: https://github.com/asciidoctor/asciidoctor-pdf/issues/233

Conrad

Conrad

Jan 21, 2020; 5:43am

Re: AsciidoctorJ does not create TOC

In reply to this post by mojavelinux

Hi Dan,

Many thanks for your answer,

It tried your correction:

= Documentation
Author Name
v0.1
:toc:

It does not work:
- The preview in AsciidocFX does not show the TOC.
- The pdf generator of AsciidocFX does not create the TOC.
- The pdf generator of AsciidoctorJ does not create the TOC.

I want to follow the standard. So what's wrong?

Conrad

mojavelinux

Jan 21, 2020; 10:09am

Re: AsciidoctorJ does not create TOC

Administrator

If I download and extract the AsciidoctorJ 2.2.0 distribution (which you can also install via sdkman), then run the following:

asciidoctorj -b pdf test.adoc

on this document:

= Documentation
Author Name
v0.1
:toc:

== Section

The PDF contains a toc. (You need at least one section for the toc to show).

> The preview in AsciidocFX does not show the TOC.
> The pdf generator of AsciidocFX does not create the TOC.

AsciidocFX has nothing to do with AsciidoctorJ. You will need to direct that inquiry to AsciidocFX.

Best,

-Dan

On Mon, Jan 20, 2020 at 10:43 PM Conrad [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi Dan,

Many thanks for your answer,

It tried your correction:

= Documentation
Author Name
v0.1
:toc:

It does not work:
- The preview in AsciidocFX does not show the TOC.
- The pdf generator of AsciidocFX does not create the TOC.
- The pdf generator of AsciidoctorJ does not create the TOC.

I want to follow the standard. So what's wrong?

Conrad

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/AsciidoctorJ-does-not-create-TOC-tp7499p7514.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux