Asciidoctor 是一个针对 AsciiDoc 标记语言的快速文本处理和发布工具链,可以把内容转换成 HTML5、DocBook 5(或4.5)或者其他格式。 Asciidoctor 是用 Ruby 写的,并打包成一个 RubyGem 并发布到 RubyGems.org。多个Linux发行版都包含这个 Gem,包括 Fedora 、Debian 、Ubuntu。 Asciidoctor 是开源的,托管在 GitHub 上,并在MIT许可下发布。
Use AsciiDoc for document markup. Really. It’s actually readable by humans, easier to parse and way more flexible than XML. — Linus Torvalds
《AsciiDoc 简介》介绍了博主看好 AsciiDoc 的原因,《Pro Git》这本书也是用 AsciiDoc 写的,请看《Living the Future of Technical Writing》,中文版请移步《实践的、技术写作的未来》。
Asciidoctor 的标记语言和 Python 版的 AsciiDoc 有一点小区别,建议先看《AsciiDoc Syntax Quick Reference》和《Asciidoctor User Manual》,User Manual 有从 MarkDown 和 Asciidoc 迁移到 Asciidoctor 的内容。
下面是我使用 Atom 编辑 AsciiDoc 的截图,和生成的 HTML 文件在 Chrome 中的截图:
Atom IDE 和 Asciidoc Preview 插件
HTML 页面预览-1
HTML 页面预览-2