asciidoctor是一種純文本的文檔格式，有點兒像是markdown的增強版，文本方式編寫，然后通過工具轉換成pdf，doc或者html格式的文檔。
本文記錄了一下在unbuntu上安裝轉換工具asciidoctor的過程

1. 先安裝ruby

sudo apt-get install ruby

2. 通過gem安裝asciidoctor

gem install asciidoctor

3. 如果需要繪制圖表，還需要安裝asciidoctor-diagram

gem install asciidoctor-diagram

4. 安裝Java jdk

sudo apt-get intall openjdk-8-jre-headless

5. 安裝graphviz，繪制plantUML的工具

sudo apt-get install graphviz

6. 運行如下命令來從asciidoc文檔生成html文檔

asciidoctor -r asciidoctor-diagram xxx.adoc