Журнал Эмбеддед-Инженера

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

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

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

git clone https://github.com/asciidoctor/asciidoctor-fopub.git
sudo yum install -y rubygem-asciidoctor
sudo yum install -y fontawesome-fonts paratype-pt-sans-caption-fonts paratype-pt-sans-fonts

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

rpm -qa | grep openjdk
java-1.8.0-openjdk.x86_64
java-1.7.0-openjdk.x86_64

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

sudo update-alternatives --config java
sudo update-alternatives --config javac

 

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

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

wget https://atom.io/download/rpm
sudo rpm -Uvh atom.x86_64.rpm
apm install asciidoc-preview
apm install language-asciidoc
apm install asciidoctor-preview

 

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