Шпаргалка AsciiDoctor

Написал небольшую шпаргалку по AsciiDoctor‘у. Предназначена она для тех, кто уже знаком с этим форматом, но пишет в нем не так часто, чтобы помнить все ключевые слова и возможности.

Краткая вводная для тех, кто не знаком:

AsciiDoctor - это расширение формата документов AsciiDoc, который является представителем парадигмы редактирования WYSIWYM (видишь то, что имеешь в виду), наподобие Markdown или reStructuredText. Т.е. пользователь описывает структуру и содержание документа, а итоговый вид документ приобретает после обработки специальной программой (в данном случае asciidoc или asciidoctor).

В результате довольно просто получить хорошо отформатированный документ, но при этом сложнее вносить в оформление мелкие правки, в отличие от парадигмы WYSIWYG (что видишь, то и получишь), которая используется, например, в Word . Еще к важным плюсам можно отнести возможность получения итогового документа в разных форматах (html, pdf и .т.д.).

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

Последнюю версию шпаргалки можно скачать отсюда.

Написана она в формате AsciiDoctor и подогнана для печати на одной странице в альбомной ориентации (по крайней мере при печати html через Chrome с минимальными полями).

Текущая отформатированная версия:

/images/asciidoc-1-thumb.png