自生成目录中的子部分如何在Asciidoc中包含另一个子部分?

时间:2019-04-03 12:49:53

标签: asciidoc asciidoctor

对于我的Asciidoc文件,我正在设置一个目录,其中必须包含用小节填充的不同节。这些小节本身也包含一些小节。如何以某种方式将目录设置为不包含一组子节?

使用Asciidoc自动ToC生成器:toc:(在终端中为toc -a)和自动节号生成器:sectnums:,我生成了一个ToC,其中每个节包含一组子节。我使用了=的不同级别,以使ToC生成器了解哪些是节,哪些是子节以及...,但是不幸的是,它似乎不起作用

:sectnums:

==section1

(some table)

===subsection A

(some table)

====subsection B

(some table)

====subsection C

(some table)

=====subsection D

(some table)

===subsection E

==section2
...

我需要生成的结果是这样的:

1. section1
 1.1. subsection A
  1.1.1. subsection B
  1.1.2. subsection C
   1.1.2.1. subsection D
 1.2. subsection E
2. section2

到目前为止,我所得到的就是这样:

1. section1
 1.1. subsection A
 1.2. subsection B
 1.3. subsection C
 1.4. subsection D
 1.5. subsection E
2. section2

1 个答案:

答案 0 :(得分:0)

内置的TOC宏默认为2个级别的节。您可以像这样调整级别:

:toclevels: 5

有关更多详细信息,请参见:https://asciidoctor.org/docs/user-manual/#user-toc-levels

注意:请确保您的Asciidoctor文档包含顶级标题,应在顶级标题后立即指定页面级属性,而节标题应在等号后紧跟一个空格。像这样:

= Document
:sectnums:
:toc:
:toclevels: 5

== section1

(some table)

...