HICK 者，乡巴佬也

5. 文档结构5.1. 块元素

AsciiDoc 由一些块元素组成。下面是块元素的关系描述(类似 XML 的 DTD):

Document ::= (Header?,Preamble?,Section*)
Header ::= (Title,(AuthorLine,RevisionLine?)?)
AuthorLine ::= (FirstName,(MiddleName?,LastName)?,EmailAddress?)
RevisionLine ::= (Revision?,Date)
Preamble ::= (SectionBody)
Section ::= (Title,SectionBody?,(Section)*)
SectionBody ::= ((BlockTitle?,Block)|BlockMacro)+
Block ::= (Paragraph|DelimitedBlock|List|Table)
List ::= (BulletedList|NumberedList|LabeledList|CalloutList)
BulletedList ::= (ListItem)+
NumberedList ::= (ListItem)+
CalloutList ::= (ListItem)+
LabeledList ::= (ItemLabel+,ListItem)+
ListItem ::= (ItemText,(List|ListParagraph|ListContinuation)*)
Table ::= (Ruler,TableHeader?,TableBody,TableFooter?)
TableHeader ::= (TableRow+,TableUnderline)
TableFooter ::= (TableRow+,TableUnderline)
TableBody ::= (TableRow+,TableUnderline)
TableRow ::= (TableData+)

(more…)

DocBook 主要维护人 Norman Walsh 写了一个用来写 DocBook 的 emacs mode: DocBook IDE ，以前写 DocBook 就用这个，可以实现自动提示 DocBook 元素等。刚上他个人网站又看了一下，提到这个插件不再维护，他已经用 nxml-mode 了。

官方网站 http://www.thaiopensource.com/nxml-mode/

下载 http://www.thaiopensource.com/download/

nxml-mode 比一般的 emacs mode 来得肥胖。安装方法：把相关文件下载放到某目录比如 home(~) 目录，并把文件夹命名 nxml-mode ，然后 .emacs 中加入 (load “~/nxml-mode/rng-auto.el”) 。当然，可以设置自动关联 xml 文件到 nxml-mode，也可以 M-x nxml-mode 来以该模式打开当前文件。关联 xml xhtml 等文件：

(setq auto-mode-alist
(cons ‘(”\\.\\(xml\\|xsl\\|rng\\|xhtml\\)\\’” . nxml-mode)
auto-mode-alist))

(more…)

哈哈，一大早开水木，赫然发现十大有一条“CCTV正式把李宇春列为男歌手”，八卦的 Hick 打开一看，竟然真有一链接： http://club.2008.cctv.com/public/poll/page_3/ ， 调查中有：

认为今年奥运会主题歌的男演唱者是谁?

刘欢
张学友
李宇春
刘德华

哈哈，人说“cctv 总算正常了一把”！八卦 Hick 截图为证：

(more…)

4. AsciiDoc Backends

通过 -b 或 –backend 参数，可以用 asciidoc 命令把 AsciiDoc 转换成各种支持的格式。不用去关心他们之间的差异，相关的转换规则都可以在相关的配置文件中定义。

AsciiDoc 支持转换成 DocBook, XHTML1.1, HTML4 以及 LinuxDoc 和 LaTex 格式。

4.1. docbook

如前面所说， AsciiDoc 中的 Book, article, manpage 对应 DocBook 中的 book, article 和 refentry 。DocBook 支持转换成的文档格式相当丰富(有 PostScript, HTML, XHTML, PDF, DVI, roff, HTMLHelp, JavaHelp 以及文本等)，而且适合大规模文档的组织，当然弱项是不易直接阅读。

转换 DocBook 支持的属性(—attribute)包括 encoding 和 imagesdir 。支持的 –doctype(-d) 为 book, article, 不知道为什么用上面说的 refentry 会提示说 illegal document type 。实例如下：

(more…)

:) AsciiDoc 的文档看起来还是比较舒服的。

1. AsciiDoc 概要

这种文件格式最大的优点就是简洁！语法和使用以及手册都是如此，常用的转换工具只有一个 asciidoc.py 文件。通过配置文件，可以定制 asciidoc 的语法以及输出文件的大部分信息。

2. 开始 AsciiDoc 之旅

安装 AsciiDoc 相当简单，在安装好 python 2.4 以上版本以后，解压缩文件即可通过运行 asciidoc.py 来进行基本的转换。而 a2x 则没有实现 windows 下的移植。

在安装包中的 doc 目录，有很多可以参考的实例。

3. AsciiDoc 的文档类型

(more…)