asciidoc - 在 Asciidoc/Asciidoctor 中隐藏 ToC 的标题

Question

我想找到一种方法在我的 Asciidoc 文档的目录中隐藏某些标题，我正在使用 Asciidoctor 将其处理为 HTML 和 PDF。

我增加了headerlevel值以包含一些其他子标题，但这样做的副作用是一些不需要的标题现在也出现在输出文档的 ToC 中。

我的文档是使用这种语句从多个源文件动态组成的:

include::deployment/topic.adoc[leveloffset=+3]

其中一些标题不应出现在 ToC 中 - 包括它们会导致大量重复(它们在每个主要标题下都有相似的内容)。

例如。:

每个组件主题都有一个 H1 header ，这些“leveloffset”属性根据需要降级为 h2、h3 等:

= My Topic Title

所以我解决的文档如下所示:

= Main Title (Keep in ToC)
== H2 (Keep in ToC)
=== H3 (Keep in ToC)
== H2 (Keep in ToC)
=== H3 (Remove from ToC)
== H2 (Keep in ToC)
=== H3 (Remove from ToC)

我不能减 headerlevel删除 === H3 (Remove from ToC) 的实例没有 还有删除 === H3 (Keep in ToC)来自 ToC。

我试图保持文档模块化。所以让一些标题简单粗体文本(使用星号)并不理想。我想将它们保留为标题，但为它们添加某种属性，将它们标记为“非 ToC”。

我将不胜感激任何提示或想法。

谢谢

Answer 1

我刚刚想通了 - 哦!

一个可行的解决方案是插入 [discrete]您要定义的标题上方的属性:

[discrete]
=== H3 (Remove from ToC)
This is the H3 content.

This section of the Asciidoctor docs显示此属性的正常使用方式。但是，您实际上不需要像它所建议的那样使用 H2 header - Asciidoctor 在使用 [discrete] 时尊重层次结构级别。 ，所以嵌套仍然有效。