группирование нескольких тегов в один с помощью asciidoctor

Question

Я делаю документацию в моем asciido c, у меня есть много таких вещей, как это

# tag::checklist[]
[IMPORTANT.checklist,caption=Checklist]
====
this is the tagged checklist item
====
# end::checklist[]

есть ли способ объединить это в более дружественный синтаксису макрос, из-за отсутствия лучше термин, чтобы иметь такой синтаксис

[checklist]
====
this is the tagged checklist item
====

, который отображает одно и то же?

Answer 1

Не с нативным Asciidoctor. Вам нужно написать расширение для обработки [checklist] блоков и выдать соответствующий вывод для используемого в настоящее время типа выходного бэкенда.

Обычно tag:: и end:: используются для включения разделителей блоков файлы, которые, как правило, не являются исходным кодом Asciido c (примеры кода). Так как они обертывают источник Asciido c, вы можете рассмотреть возможность разделения каждого обернутого блока в отдельный файл и включать их по мере необходимости. Это устранит необходимость в разделителях и упростит макросы include:, которые включают этот контент. Это также упростит работу, которую потребуется выполнить вашему потенциальному расширению.