微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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

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

我有几个例子(都有标题),我想自动创建一个索引/列表。

可以在 chunked AsciiDoc User Guide 目录(或下方)中看到一个示例:

List of Tables and List of Examples

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

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

我正在寻找(asciidoctor?)标准的 html5 渲染,但我愿意接受不同的建议。

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

解决方法

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

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

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。