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

Question

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

== Get started

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

== Get started Introduction

仅使用“入门”将生成一个TOC，我想要一个这样的TOC：

开始使用

-简介

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

Answer 1

如果您使用的是内置的TOC代，即您在文档中使用:toc:（或在命令行中使用-a toc），则TOC中仅包括节标题。有关更多详细信息，请参见：https://asciidoctor.org/docs/user-manual/#user-toc

因此，要将“纯文本”包​​含在目录中，您必须将纯文本制作为节标题。

如果您不使用内置的TOC生成器，则可以用任何喜欢的内容组成一个列表。如果您需要手工组装的TOC看起来像内置的TOC，则需要添加一些CSS样式来做到这一点，这需要一个“ docinfo”，以便您自定义生成的HTML。参见https://asciidoctor.org/docs/user-manual/#docinfo-file。