asciidoctor是一种纯文本的文档格式,有点儿像是markdown的增强版,文本方式编写,然后通过工具转换成pdf,doc或者html格式的文档。
本文记录了一下在unbuntu上安装转换工具asciidoctor的过程
- 先安装ruby
sudo apt-get install ruby
- 通过gem安装asciidoctor
gem install asciidoctor
- 如果需要绘制图表,还需要安装asciidoctor-diagram
gem install asciidoctor-diagram
- 安装Java jdk
sudo apt-get intall openjdk-8-jre-headless
- 安装graphviz,绘制plantUML的工具
sudo apt-get install graphviz
- 运行如下命令来从asciidoc文档生成html文档
asciidoctor -r asciidoctor-diagram xxx.adoc