.文档标题 输出结果
....
文档的标题是“文档标题”。
....

=== 为DocBook 4.5后端添加了标签列表的水平布局

例子：

[source, asciidoc]

渲染：

[source, xml]

=== 连续的术语在标记列表中共享相同的 +varlistentry+

在标记列表中的连续条目在+docbook+后端共享相同的+varlistentry+。

例子：

[source, asciidoc]

输出：

[source, xml]

=== 特殊部分和样式

"+partintro+" 和 "+abstract+" 这两种样式可以用于开放块，并且渲染器可以正确处理。

现在，分配了+glossary+（术语表）和+appendix+（附录）样式的节在Asciidoctor中可以正确处理。

=== 内联分配文档变量

可以使用以下语法分配文档变量：

 {set:<attrname>[!][:<value>]}

例如：

[source, asciidoc]
{set:sourcedir:src/main/java}

它实际上和以下相同：

:sourcedir: src/main/java

这对于能够在通常不处理属性条目行的地方分配文档属性很重要，例如在一个表格单元格中。

这可能被用于的一个例子记录在{doc-variable-ref}[如何设置表格单元格的背景颜色]小提示中。

=== 不允许在文档标题上方使用块标题。

之前，一个位于0级标题上方的块标题行被处理并传递给了第一个内容块。AsciiDoc将块标题视为内容的第一行，并因此不创建头部。Asciidoctor的行为现在与AsciiDoc一致。

例子：

[source, asciidoc]

=== irc: 方案被渲染为链接

以下输入现在呈现为链接。

[source, asciidoc]
irc://irc.freenode.org/#asciidoctor

== 命令行界面和应用程序编程接口更新

=== 使用Asciidoctor命令行界面指定任何后端

以前，Asciidoctor CLI只允许用户指定+html5+或+docbook45+以外的后端。现在，任何非空的值都可以被指定为后端。当你想要使用一个{backend-git-ref}[自定义后端]，比如deck.js或者dzslides时，这是至关重要的。

=== 在Asciidoctor API中使用字符串、符号或整数设置安全模式。

安全级别选项现在接受一个符号、字符串或整数值来查找安全级别。

[source, ruby]
result = Asciidoctor.render_file('master.ad', :safe => 'server')

现在可以写成：

[source, ruby]
result = Asciidoctor.render_file('master.ad', :safe => :server)

=== 在Asciidoctor API中使用字符串或符号来设置后端

后端选项现在接受一个符号或字符串值。

[source, ruby]
result = Asciidoctor.render_file('master.ad', :backend => 'docbook')

现在可以写成：

[source, ruby]
result = Asciidoctor.render_file('master.ad', :backend => :docbook)

=== 将属性作为字符串或数组传递给Asciidoctor API

以前，属性以哈希表的形式传递给Asciidoctor API方法。有时，这使得参数列表显得很臃肿。现在这些方法接受以字符串或数组形式的属性。

例如，考虑一个用户想要传递启用目录（+toc+）和自动编号（+numbered+）的属性。以前，这需要：

[source, ruby]
result = Asciidoctor.render_file('master.ad',
    :attributes => {'toc' => '', 'numbered' => ''})

由于这两个属性都是简单的标记，调用可以简化为：

[source, ruby]
result = Asciidoctor.render_file('master.ad',
    :attributes => ['toc', 'numbered'])

它可以通过在Ruby中使用字符串到数组的简写方式来进一步简化：

[source, ruby]
result = Asciidoctor.render_file('master.ad',
    :attributes => %w(toc numbered))

这引导我们进入了指定为字符串的属性：

[source, ruby]
result = Asciidoctor.render_file('master.ad',
    :attributes => 'toc numbered')

这是对原始呼叫的相当大的改进。

如果属性需要一个值，例如+source-highlighter+，你只需使用key=value的形式：

[source, ruby]
result = Asciidoctor.render_file('master.ad',
    :attributes => 'toc numbered source-highlighter=coderay')

这个API调用与这个命令行调用相对应：

asciidoctor -a toc -a numbered -a source-highlighter=coderay master.adoc

这种增强功能在整合中特别有用，比如 {gradle-git-ref}[Gradle 插件]。

'''Learn more in the Asciidoctor Docs: {ruby-api-ref}[Asciidoctor Ruby API] | {java-api-ref}[Asciidoctor Java API]'''

那就结束了！

== 谢谢！

正如我们所希望的，Asciidoctor 0.1.2 的下载量突破了下一个1万的增量。RubyGems.org 在本次发布之前报告了超过20,000次的Asciidoctor gem下载量，Maven Central的Java集成下载量超过了100次。我们期待着用0.1.3达到新的里程碑。

Asciidoctor 项目的参与度持续以惊人的速度增长。在这个开发周期中，我们欢迎了几个新项目的加入，包括由 John Ericksen 开发的一个用于用 AsciiDoc 写 Javadoc 的 Javadoclet —— {asciidoclet-ref}[Asciidoclet]，以及几个 AsciiDoc 编辑器的计划。我们非常感谢每一位参与者，特别是那些做出贡献和传播信息的人们 :)

我们特别感谢以下人员对这次发布的贡献和反馈：

- {gh-ref}/bleathem[Brian Leathem] (增强功能、补丁和QA)
- {gh-ref}/lightguard[Jason Porter] (CLI improvements)
- {gh-ref}/graphitefriction[Sarah White] (文档、用户体验和质量保证)
- {gh-ref}/lordofthejars[Alex Soto] (Java integration improvements)
- {gh-ref}/johncarl81[John Ericksen] (Asciidoclet)
- {gh-ref}/aalmiray[Andres Almiray] (Doctorpad 编辑器)
- {gh-ref}/glaforge[Guillaume Laforge]（Doctorpad 编辑器）
- {gh-ref}/pilhuhn[Heiko Rupp]（Bug报告和建议）
- {gh-ref}/eddelplus[乔亨·艾德尔布特尔]（错误报告和Windows测试）
- {gh-ref}/davidfavor[David Favor] (Bug reports)
- {gh-ref}/snowolfe[Bruce Wolfe] (错误报告)
- {gh-ref}/ge0ffrey[Geoffrey De Smet] (功能请求)
- {gh-ref}/dobermai[Obermaier Dominik] (功能请求)
- {gh-ref}/lincolnthree[林肯·巴克斯特三世] (功能请求)

特别感谢Brian Leathem在发布前一晚发现了一个关键性的回归问题。

补充感谢每一个使用这个项目并为之做出贡献的人。大家共同努力，我们让编写文档变得有趣、容易并且有益!

== 下一步是什么？

这个版本仅仅是发布列车的开始。期待Java集成、Maven插件、Gradle插件以及最新添加的编辑器等的发布。