如何将非标题元素添加到 asciidoctor 的 table 内容

How to add non title element to the asciidoctor's table of content

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

== Get started

将完美地添加到 table 内容上,但不会添加常规文本,例如:

== Get started Introduction

将生成一个只有 "get started" 的目录,我想要一个像这样的目录:

开始

-简介

如何将常规文本添加到 table 内容?

如果您使用的是 built-in TOC 生成,即您在文档中使用 :toc:(或在命令行中使用 -a toc),则只有章节标题包含在目录。更多详情,请参阅:https://asciidoctor.org/docs/user-manual/#user-toc

因此,要将 "plain text" 包含在目录中,您必须将纯文本变成章节标题。

如果您没有使用built-in目录生成,您可以将您喜欢的任何内容组成一个列表。如果您需要 hand-assembled TOC 看起来像 built-in TOC,您需要添加一些 CSS 样式来实现,这需要 "docinfo" 让您自定义生成的HTML。参见 https://asciidoctor.org/docs/user-manual/#docinfo-file