AsciiDoc简明指南

AsciiDoc是一种文本文档格式，可以用于书写文档，文章，手册，书籍和UNIX手册。AsciiDoc文件可以使用asciidoc命令转换成HTML和DocBook文件格式。AsciiDoc结构先进：AsciiDoc语法和输出标签（几乎可以转换成任意的SGML/XML标记）都可以由用户自己定义和扩展。

特殊定义

变量形式 {变量}

参数形式 [参数组]

转义符号 \

注释 //空格

引用空格后面跟文字

基本区块

基本区块是一行或多行文本，也可以包括其他基本区块。

AsciiDoc基本区块概括如下[这是一个大概的结构指南，不是严格的语法定义]：

文档 ::= (头部?,前言?,章节*)
头部 ::= (标题,(作者,修订?)?)
作者 ::= (名字,(中间名?,姓氏)?,Email地址?)
修订 ::= (版本?,日期)
前言 ::= (段落)
章节 ::= (标题,段落?,(章节)*)
段落 ::= ((区块标题?,区块)|宏块)+
区块 ::= (自然段|独立块|列表|表格)
列表 ::= (无序列表|有序列表|定义列表|标注列表)
无序列表 ::= (项目)+
有序列表 ::= (项目)+
标注列表 ::= (项目)+
定义列表 ::= (条目)+
条目 ::= (标签,项目)
标签 ::= (项目+)
项目 ::= (项目文本,(列表|段落列表|列表后续)*)

注释:

'?' 表示0或1个，'+' 表示0或多个，'*' 表示1或多个。
所有的基本区块有独立的界线分开.
下面的基本部分不能包含空行: 头部，标题，段落，项目文本。

头部

头部包含文档标题、作者和版本信息。头部可选但是必须在文档的顶部。

= 使用 AsciiDoc 编写文档 =
Joe Bloggs <jbloggs@mymail.com>
v2.0, February 2003:
Rewritten for version 2 release.

项目1::
项目2::
  项目说明.

  项目说明.

项目3:: 项目说明.
  * 列表项.
  * 列表项.
项目4::
  说明1.
  二级项目;;
    二级说明.
  二级项目;;
    二级说明.
  二级项目;;
    二级说明.
    三级项目::: 三级说明.
    三级项目:::   三级说明.
*水平项目*:: 水平说明.

  水平说明.

问答列表

[qanda]
问题1::
        答案1.
问题2::
        答案2.

专业术语列表

[glossary]
术语1::
    解释1.
术语2::
    解释2.

脚注

A footnote footnote:[An example footnote.];
a second footnote with a reference ID footnoteref:[note2,Second footnote.];
finally a reference to the second footnote footnoteref:[note2].

超链接

'http'，'https'，'ftp'，'file'，'mailto’和’callto’超链接。直接书写就行，参数是显示名称，空格使用%20。

http://www.methods.co.nz/asciidoc/[The AsciiDoc home page]
http://www.methods.co.nz/asciidoc/
mailto:joe.bloggs@foobar.com[email Joe Bloggs]
joe.bloggs@foobar.com

锚点

锚点：[[A88]]

链接：<<A88,chapter titles>>

图片

image:images/logo.png["Company Logo",height=32,link="screen.png",scaledwidth="75%"align="left"]

表格

[width="40%",cols="^,2m",frame="topbot",options="header,footer"]
|======================
|Column 1 |Column 2
|1        |Item 1
|2        |Item 2
|3        |Item 3
|6        |Three items
|======================

表格参数：

frame边框topbot(上和下)，all(全部边，默认), none and sides (左和右)。
align对齐left，right和center。
options选项header（有标题）footer（有底部）
width宽度1-99%

行参数：

[<multiplier>*][<align>][<width>][<style>]
左缩进，对齐，宽度，样式

单元格参数：

[<span>*|+][<align>][<style>]
*缩进，+合并
span语法[水平][.垂直]参数中<，^和>分别表示水平左中右和垂直上中下。

宏

{include:<filename>} 得到`<filename>`的内容。
{sys:<command>} 得到执行脚本命令`<command>`的标准输出。
{sys2:<command>} 得到执行脚本命令`<command>`的标准输出和标准错误。
{sys3:<command>} 直接输出结果不进行任何处理。
{amp}                 显示字符 (&)
{asciidoc-dir}        asciidoc(1)程序文件夹
{asciidoc-file}       asciidoc(1)脚本的完整路径
{asciidoc-version}    asciidoc(1)的版本
{author}              作者姓名
{authored}            空字符串 '' 如果 {author} 或 {email} 已经指定,
{authorinitials}      作者缩写 (from document header)
{backend-<backend>}   空字符串 ''
{<backend>-<doctype>} 空字符串 ''
{backend}             document backend specified by `-b` option
{backslash}           反斜杠
{basebackend-<base>}  空字符串 ''
{basebackend}         html 或 docbook
{brvbar}              竖线 (|)
{revdate}             文档修订日期 (from document header)
{docdate}             文档最后修改日期
{doctime}             文档最后修改时间
{docname}             文档文件名不含扩展名
{docfile}             文档文件名 (note 5)
{docdir}              document input directory name  (note 5)
{doctitle}            文档标题 (from document header)
{doctype-<doctype>}   空字符串 ''
{doctype}             文档类型使用`-d`设置指定
{email}               作者email (from document header)
{empty}               空字符串 ''
{encoding}            指定输入输出编码
{filetype-<fileext>}  空字符串 ''
{filetype}            输出文件的扩展名
{firstname}           作者名字 (from document header)
{gt}                  大于号 (>)
{id}                  running block id generated by BlockId elements
{indir}               输出文件的文件夹名称 (note 2,5)
{infile}              输入文件名称 (note 2,5)
{lastname}            作者姓氏 (from document header)
{level}               标题级别 1..4 (in section titles)
{listindex}           the list index (1..) of the most recent list item
{localdate}           当前日期
{localtime}           当期时间
{lt}                  小于号 (<)
{manname}             manpage name (defined in NAME section)
{manpurpose}          manpage (defined in NAME section)
{mantitle}            document title minus the manpage volume number
{manvolnum}           manpage volume number (1..8) (from document header)
{middlename}          作者中间名 (from document header)
{nbsp}                空格
{outdir}              文档输出文件夹名 (note 2)
{outfile}             输出文件名 (note 2)
{reftext}             running block xreflabel generated by BlockId elements
{revnumber}           文档修订版本号 (from document header)
{sectnum}             formatted section number (in section titles)
{showcomments}        在输出文件中显示注释行
{title}               章节标题 (in titled elements)
{two_colons}          双冒号
{two_semicolons}      双分号
{user-dir}            ~/.asciidoc文件夹 (如果存在)
{verbose}             defined as '' if --verbose command option specified

asciidoc命令参数

--htlp 帮助
-n 自动生成标题前面的编号

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

asciidoc-guide.asciidoc

asciidoc-guide.asciidoc

AsciiDoc简明指南

特殊定义

基本区块

头部

标签

标题

文字格式

特殊符号

文本块样式

提示段落

警告图标和标题

列表

无序列表

有序列表

定义列表

问答列表

专业术语列表

脚注

超链接

锚点

图片

表格

宏

asciidoc命令参数

Files

asciidoc-guide.asciidoc

Latest commit

History

asciidoc-guide.asciidoc

File metadata and controls

AsciiDoc简明指南

特殊定义

基本区块

头部

标签

标题

文字格式

特殊符号

文本块样式

提示段落

警告图标和标题

列表

无序列表

有序列表

定义列表

问答列表

专业术语列表

脚注

超链接

锚点

图片

表格

宏

asciidoc命令参数