去年的”AsciiDoc学习笔记”

最近有点时间整理以前的一些文档，翻出这个 AsciiDoc学习笔记 来，还是觉得非常有用的。 1. 2006-06-25 23:02:01|开始接触AsciiDoc 老早以前就下了 AsciiDoc 的包，一直放在那里没有研究，最近又看了一下，觉 得真的是解决了 DocBook 和 reST 两个的问题，融合了他们的优点。刚在 python-cn 的 google group 发了个帖，看看有没有熟悉的人可以评论一下 AsciiDoc 的优劣。 官方的介绍：AsciiDoc 是一种用来写短文档、文章、书籍以及 Unix 帮助页面等 等的文档格式。它能够被转换成 HTML 以及 DocBook 标记格式。结合其他工具， 还可以方便的转换成 pdf roff 等格式。 它具有高度的可配置性，无论是源文件语法，还是输出文件标记，都能够被定制 和扩展。所有的这些工作，用一个 asciidoc 命令即可完成。 AsciiDoc 还支持源代码高亮。 A2X 是个 linux 下的 shell 脚本，在安装好 DocBook XSL Stylesheets 以及 fop 等的情况下可以方便的转换成 DocBook 以及 pdf 等格式。可惜的是， windows 下没有相应的现成环境以及脚本。 2. 2006-06-27 01:20:00|简单使用 windows 版本直接解压缩即可，不需要安装即可通过运行 asciidoc.py 命令来转 换基本的格式。当然，由于是 python 程序，需要你安装了 python ，要求版本 2.3 以上。 下面是转换为 DocBook Article 的命令：: asciidoc.py [...]