asciidoc

1.1、asciidoc简介

是什么 ?	`:`	`tools for translating AsciiDoc files to HTML, XHTML and DocBook markups. DocBook can be post-processed to presentation formats such as HTML, PDF, EPUB, DVI, LaTeX, roff, and Postscript using readily available Open Source tools.`
开发语言	`:`	Python
官方主页	`:`	http://asciidoc.org
源码仓库	`:`	https://github.com/asciidoc/asciidoc-py3

1.2、通过包管理器安装asciidoc

操作系统	包管理器	安装命令
`All`	pip	`pip install asciidoc3`
macOS	HomeBrew	`brew install asciidoc`
GNU/Linux	HomeBrew	`brew install asciidoc`
Debian GNU/Linux Ubuntu Ubuntu Kylin Tails Linux Kali Linux MX Linux Linux Mint Deepin antiX KDE neon Pop!_OS Zorin OS elementaryOS PCLinuxOS	apt	`sudo apt-get install -y asciidoc`
CentOS	yum	`sudo yum install -y asciidoc`
Fedora Mageia	dnf	`sudo dnf install -y asciidoc`
openSUSE	zypper	`sudo zypper install -y asciidoc`
Alpine Linux	apk	`sudo apk add asciidoc`
Arch Linux ArcoLinux Manjaro Linux	pacman	`sudo pacman -Syyu --noconfirm sudo pacman -S --noconfirm asciidoc`
Gentoo Linux	Portage	`sudo emerge asciidoc`

1.3、通过编译源码安装asciidoc

step1、安装依赖

所有时	Terminal + Shell + GNU CoreUtils
下载时	cURL
解压时	tar + gzip
编译时	gmake
运行时	CPython

step2、使用curl命令下载asciidoc源码包（）

curl -LO https://github.com/asciidoc/asciidoc-py3/releases/download/9.0.4/asciidoc-9.0.4.tar.gz

step3、使用tar解压asciidoc源码包

tar vxf asciidoc-9.0.4.tar.gz

step4、进入asciidoc-9.0.4目录，并查看它的内容

asciidoc官方已经为我们编译好了a2x.py、asciidoc.py，这时候，您有2个选择：

选择一：使用已经编译好的可执行文件，我们需要做个链接：

ln -s ~/asciidoc-9.0.4/asciidoc.py /usr/local/bin/asciidoc
ln -s ~/asciidoc-9.0.4/a2x.py /usr/local/bin/a2x

选择二：配置、编译、安装：

autoconf && ./configure && make && sudo make install

1.4、asciidoc中包含的命令