Skip to main content

asciidoc: введение в концепцию единого источника документации

Установка тулчейна

asciidoctor — лучший способ работы с asciidoc Скачиваем asciidoctor, устанавливаем зависимости и шрифты:

  Также выяснилось, что для корректной работы asciidoctor, из всех установленных версий Java надо выбрать самую последнюю:

Это можно реализовать командами:

 

Редакторы для asciidoc

atom.io — пожалуй оптимальный выбор с подсветкой синтаксиса и лайв-превью. Скачиваем, устанавливаем редактор, устанавливаем плагины:

 

PS: если заметка помогла Вам, поделитесь ей с друзьями или коллегами: