從Asciidoc/Asciidoctor的ToC隱藏標題

Question

我想找到一種方法來隱藏我的Asciidoc文檔中的某些標題，這些標題正在使用Asciidoctor處理爲HTML和PDF。

我增加了headerlevel的值以包含其他一些子標題，但其副作用是現在某些不需要的標題也出現在輸出文檔的ToC中。

我的文檔使用這種說法多個源文件動態組成：

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

一些標題不應該顯示在目錄中 - 包括它們會導致大量的重複（它們具有類似的每個主標題下的內容）。

如：

每個組件的話題有一個H1標題，這些 '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)的實例，而不也 [R來自ToC的=== H3 (Keep in ToC)。

我試圖保持文檔模塊化。因此，使一些標題簡單粗體文本（使用星號）並不理想。我想保留它們作爲標題，但添加某種屬性給它們，將它們標記爲「非ToC」。

我會很感激任何提示或想法。

謝謝

Answer 1

我只是想通了 - 德哦！

一個可行的解決方案是插入[discrete]屬性要定義頭以上：

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

This section of the Asciidoctor docs顯示了這一屬性是正常使用。但是，您實際上並不需要使用H2標題，因爲它建議 - Asciidoctor在使用[discrete]時尊重分層級別，因此嵌套仍然有效。