时间戳

首页 > 解决方案 > 如何将列表或图像添加到目录 (TOC)

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

问题描述

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

可以在分块的AsciiDoc用户指南目录（或下方）中看到一个示例：

表格列表和示例列表

AsciiDoc 用户指南的asciidoc 源没有显示任何关于 Asciidoc 本身的特定内容，我可以找到以下 Docbook 提示：

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

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

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

标签： asciidocasciidoctor

解决方案

Python Asciidoc repo 包含该a2x工具，它是 DocBook 工具链的包装器。在目录中生成这些条目的是 DocBook。Python Asciidoc 和asciidoctor都不能开箱即用。

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

推荐阅读