AsciiDoc入门安装篇

Author Avatar
在路上 1月 09, 2012

AsciiDoc 入门

为什么我学习AsciiDoc?

首先,作为一个技术人,记笔记是很重要的。当然,选择一种记笔记的工具是必须的了。

记笔记有很多种方式,如使用纸质的笔记本,使用word文档,使用Evernote在线笔记本,使用OneNote,

使用HTML,使用Wiki、Markdown、viki、muse、DocBook、LaTex等等,有这么多的工具,而我为什么要使用AscciDoc呢?

因为我需要编辑公式,而且简单易用,因为我需要将做好的笔记上传到互联网,展示分享给大家。

那就开始吧:

AsciiDoc的安装

Ubuntu下的安装:

sudo apt-get install asciidoc

从Mercurial版本库安装:

先确认本地是否安装了Mercurial:

$ hg --version

如果没有安装,请安装:

sudo apt-get install mercurial

从Mercurial下载Asciiidoc:

将AsciiDoc-8.6.6下载到~/asciidoc/目录:

$ cd ~/asciidoc

$ hg clone -r 8.6.6 https://asciidoc.googlecode.com/hg/ asciidoc-8.6.6

然后我们可以直接运行asciidoc

$ ~/asciidoc/asciidoc-8.6.6/asciidoc.py

$ ~/asciidoc/asciidoc-8.6.6/a2x.py

是不是很麻烦,OK,做一个软链接到PATH路径里:

$ ln -s ~/asciidoc/asciidoc-8.6.6/asciidoc.py ~/bin/asciidoc

$ ln -s ~/asciidoc/asciidoc-8.6.6/a2x.py ~/bin/a2x

不仅如此,我们可以编译安装,这样计算机的每个用户都可以用asciidoc这个工具了。

$ autoconf # create configure

$ ./configure # 创建Makefile

$ make $ make install # 编译安装

那我们想卸载咋办?

$ sudo make uninstall 从tarball安装:

从http://sourceforge.net/projects/asciidoc/下载tarball源码包,然后用以下命令安装:

$ tar -xzf asciidoc-8.6.6.tar.gz

$ cd asciidoc-8.6.6 $ ./configure

$ sudo make install

同样可以使用以下命令卸载AsciiDoc:

$ sudo make uninstall

在vim下我们可以使用两个插件高亮AsciiDoc 语法,而且可以检测AsciiDoc文件类型:

asciidoc.vim syntax 目录里

asciidoc_filetype.vim ftdetect目录里

如何在Windows上安装:

下载asciidoc-8.6.6.zip,并解压:

$ unzip asciidoc-8.6.6.zip

如果要在Wndows上生成PDF等文件格式,可以参考这篇文章:http://blog.rainwebs.net/2010/02/25/how-to-create-handsome-pdf-documents-without-frustration/ How to Create Handsome PDF Documents Without Frustration using Cygwin, dblatex and AsciiDoc.

如何知道我们是否安装成功呢?

在AsciiDoc的doc目录里,又一个用户指南 ./doc/asciidoc.txt ,我们可以尝试将该asciidoc文件转换为XHTML:

$ python asciidoc.py asciidoc.txt 想尝试更完整的测试吗?切换到 AsciiDoc程序根目录里,看见main.aap了吗?使用该脚本测试

$ aap test 想自己build AsciiDoc的tarball、zip包、文档和AsciiDoc的demo吗?只需切换到根目录,运行aap

$ aap 当然,我们也可以切换到子目录里,build自己需要的部分,如

./doc/main.aap build 文档 ./examples/website/main.aap build 一个demo网站 ./common.aap 包含在所有的脚本里,公共文件,自然其他build过程都得需要它了 如果你和我一样,本身就使用的是Linxu的某个发行版,那么可以像我一样,使用Linux系统自带的软件管理包安装:

$ yum install asciidoc # Fedora Linux

###Mercurial 是什么?

一个分布式版本控制工具, git也是一个分布式版本控制工具,而SVN是一个集中式的版本控制工具。

具体参考:

http://mercurial.selenic.com/

AAP 是什么?

该工具可以locate、下载、build和安装软件,AAP支持源代码浏览、开发程序、管理软件和文档的版本发行等等。

具体参考:

http://www.a-a-p.org/

Last updated 2012-01-09 23:54:07 CST

2017-08-27 整理