Скрыть заголовок из ToC в Asciidoc/Asciidoctor

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) без также г emoving === H3 (Keep in ToC) от ToC.

Я пытаюсь сохранить документ модульным. Поэтому создание некоторых заголовков простого жирного текста (с использованием звездочек) не является идеальным. Я хотел бы сохранить их как заголовки, но добавить для них какой-то атрибут, который бы обозначил их как «не-ToC».

Буду благодарен за любые намеки или идеи.

Благодаря

Answer 1

Я просто понял это - d'ах!

работоспособное решение, чтобы вставить атрибут [discrete] выше заголовка вы хотите определить:

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

This section of the Asciidoctor docs показывает, как этот атрибут обычно используется. Тем не менее, на самом деле вам не нужно использовать заголовок H2, поскольку он предлагает - Asciidoctor уважает иерархические уровни при использовании [discrete], поэтому вложенность все еще работает.