如何将非标题元素添加到 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。
我有一个使用 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。