如何将列表或图像添加到目录 (TOC)

Question

我有几个例子（都有标题），我想自动创建一个索引/列表。

可以在 chunked AsciiDoc User Guide 目录（或下方）中看到一个示例：

asciidoc source of the AsciiDoc User Guide 没有显示任何特定于我的 Asciidoc 本身，我可以找到以下对 Docbook 的提示：

<块引用>

DocBook 工具链通常会自动对示例进行编号并生成“示例列表”后置部分。

我正在寻找（asciidoctor？）标准的 html5 渲染，但我愿意接受不同的建议。

单独添加 :doctype: book 属性是不行的。所以我只是陷入了死胡同，不知道是否有可能。另外，我是 Asciidoc 的新手，所以我也可能会错过一些提示。

Answer 1

Python Asciidoc 存储库包含 a2x 工具，它是 DocBook 工具链的包装器。 DocBook 在目录中生成这些条目。无论是 Python Asciidoc 还是 asciidoctor，都无法开箱即用。

您需要手动管理列表，或创建一个宏来为您管理。此线程可能会有所帮助：https://github.com/asciidoctor/asciidoctor-extensions-lab/issues/111