Каков правильный способ создания модульного сайта из файлов asciidoc?

Question

У меня есть большая документация, записанная в asciidoc и правильно разделенная на папки, я использую синтаксический анализатор asciidoctor с пользовательским css для рендеринга моих документов в HTML. Проблема заключается в том, что он генерирует одну HTML-страницу, которая очень долго (ОЧЕНЬ), я занимался серфингом в Интернете и обнаружил, что документы атома также написаны в asciidoc, но эти документы не содержат всей информации, на самом деле они отдельно в разных разделах.

здесь атом Документы https://atom.io/docs/v0.201.0/getting-started-why-atom

Я хочу знать, если есть инструмент, который генерирует это, флаг или конкретный синтаксис.

Я думаю, что это не очень удобно для всей информации на длинной отдельной странице.

Заранее спасибо. Juan

Answer 1

У меня есть сайт, где статическое содержимое создается с использованием плагина asciidoctor-jekyll и jekyll.

Я также подключил версию asciidoctor java для создания представлений с помощью платформы воспроизведения в какой-то момент, но решил, что я предпочитаю, чтобы контент, который я генерирую с asciidoctor, был статическим и доставлен CDN.

EDIT:

Кроме того, GitBookIO поддерживает asciidoctor.