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