Написал небольшую шпаргалку по AsciiDoctor‘у. Предназначена она для тех, кто уже знаком с этим форматом, но пишет в нем не так часто, чтобы помнить все ключевые слова и возможности.
Краткая вводная для тех, кто не знаком:
AsciiDoctor - это расширение формата документов AsciiDoc, который является представителем парадигмы редактирования WYSIWYM (видишь то, что имеешь в виду), наподобие Markdown или reStructuredText. Т.е. пользователь описывает структуру и содержание документа, а итоговый вид документ приобретает после обработки специальной программой (в данном случае asciidoc или asciidoctor).
В результате довольно просто получить хорошо отформатированный документ, но при этом сложнее вносить в оформление мелкие правки, в отличие от парадигмы WYSIWYG (что видишь, то и получишь), которая используется, например, в Word . Еще к важным плюсам можно отнести возможность получения итогового документа в разных форматах (html, pdf и .т.д.).
В общем, в некоторых случаях штука весьма полезная. Возможно, как-нибудь напишу про него поподробней.
Последнюю версию шпаргалки можно скачать отсюда.
Написана она в формате AsciiDoctor и подогнана для печати на одной странице в альбомной ориентации (по крайней мере при печати html через Chrome с минимальными полями).
Текущая отформатированная версия:
