Как динамически скрывать элемент asciidoc

Question

Я использую плагин org.asciidoctor.convert для градации для создания документации API для моей команды. Я включаю файлы:

include::{snippets}/index/curl-request.adoc[] 

и хочу разместить его содержимое в спойлере или что-то в этом роде. Есть ли способ каким-то образом скрыть динамические элементы asciidoc? Я пытаюсь использовать

pass:[<details open> 
include::{snippets}/index/curl-request.adoc[] 
</details>] 

, но не обрабатывается, включите внутрь него. Любые идеи будут высоко оценены. Без скрытия фрагментов моя документация имеет почти неограниченный свиток :). Если такого пути нет с ascii doc, также приветствуются предложения других форматов документации, в которых я могу включить содержимое файлов и помещать их в спойлер.

Answer 1

Это поздний ответ, но, возможно, это поможет вам/другим. следующие функции asciidoc являются ключевыми для реализации динамического показа/скрытия блоков:

Если выход только HTML, то вы можете вставлять любой HTML в документ с помощью

++++ any HTML contents ++++ 

Это включает в себя

• <style> теги, содержащие пользовательские классы CSS
• пользовательские HTML-теги для отображения/скрытия функциональных возможностей, таких как <input type="checkbox" />
• <script> теги, содержащие код Javascript, чтобы скрыть/показать некоторые блоки, например. добавив флажков к событиям.

Как уже упоминалось @LightGuard, атрибуты role преобразуются в ссылки класса CSS. Например.

[source,role="someCssClass"] 
---- 
... 
---- 

превращается в нечто вроде

<div class="someCssClass"> 
</div> 

Таким образом, вы можете ссылаться на этот CSS класс от Javascript кода и реализовать показать/скрыть, изменив атрибут display CSS.

Для простого примера реализации см. https://raw.githubusercontent.com/NorbertSandor/jsinterop.xyz/master/jsinterop-project/jsinterop-website/src/main/asciidoc/index.asciidoc (около верхней части файла).