AsciiDoc 手册笔记 1

:) AsciiDoc 的文档看起来还是比较舒服的。 1. AsciiDoc 概要 这种文件格式最大的优点就是简洁！语法和使用以及手册都是如此，常用的转换工具只有一个 asciidoc.py 文件。通过配置文件，可以定制 asciidoc 的语法以及输出文件的大部分信息。 2. 开始 AsciiDoc 之旅 安装 AsciiDoc 相当简单，在安装好 python 2.4 以上版本以后，解压缩文件即可通过运行 asciidoc.py 来进行基本的转换。而 a2x 则没有实现 windows 下的移植。 在安装包中的 doc 目录，有很多可以参考的实例。 3. AsciiDoc 的文档类型 AsciiDoc 主要有三种文档类型： article, book, manpage, 分别为文章、书籍和手册。几种格式的文档都使用大体上相同的格式，只有细微的差别。 转换的时候，可以通过 asciidoc -d (-doctype) 来指定需要输出的文档类型。 article(文章)主要用于短篇的文本，实例可以参考 ./doc/article.txt 。 book(书籍)的格式和 article 基本一样，不过 book 中可以增加级别为 0 的节 (section)。其实 article 和 book 都是基本上跟 DocBook 看齐的。doc 文件夹中有 book 以及多部分的 book [...]