Можно ли объединить два содержимого файла asciidoc в один

Question

Я использовал spring-rest-docs для генерации документации для проекта.spring-rest-docs сгенерировал фрагмент с расширением .adoc.Я хочу объединить содержимое двух файлов .adoc в один файл .adoc, который является основным.

Answer 1

Вместо того, чтобы пытаться объединить их, напишите третий документ, который включает сгенерированные.В этом документе вы можете выполнить глобальную настройку процессора asciidoc и, возможно, предоставить некоторый дополнительный текст или структуру для склеивания сгенерированного контента.

Глава 28 в руководстве по asciidoctor описывает директиву include ,Пример из раздела 28.4 по разбиению больших документов имеет следующий пример, где отдельные главы находятся в отдельных файлах:

= My book

include::chapter01.adoc[]

include::chapter02.adoc[]

include::chapter03.adoc[]