java - 如何将非标题元素添加到 asciidoctor 的目录中

Question

我有一个使用 Asciidoctor 记录的 java/gradle 项目，它根据文档的标题部分生成上下文表。例如:

==开始

将完美添加到目录中，但常规文本不会，例如:

== 开始使用
简介

将生成一个只有“开始”的目录，我想要一个像这样的目录:

开始

-简介

如何将常规文本添加到目录中？

Answer 1

如果您使用内置目录生成，即您在文档中使用 :toc: (或在命令行上使用 -a toc)，则仅章节标题包含在目录中。更多详情请参见:https://asciidoctor.org/docs/user-manual/#user-toc

因此，要将“纯文本”包​​含到目录中，您必须将纯文本放入章节标题中。

如果您不使用内置目录生成功能，您可以使用您喜欢的任何内容撰写列表。如果您需要手动组装的 TOC 看起来就像内置 TOC，则需要添加一些 CSS 样式来实现此目的，这需要一个“docinfo”来让您自定义生成的 HTML。请参阅https://asciidoctor.org/docs/user-manual/#docinfo-file .