它花费了我们比预期更长的时间，但https://github.com/asciidoctor/asciidoctor-gradle-plugin[Asciidoctor Gradle 插件]版本1.5.0终于到来了！Asciidoctor Gradle插件基于https://github.com/asciidoctor/asciidoctorj#readme[AsciidoctorJ]，并且首次与它的版本编号方案保持一致。
这是基本的设置，帮助你开始：
该插件从这个版本开始跟踪 AsciidoctorJ 版本，因此从0.7.3跳跃到了1.5.0。如http://asciidoctor.org/news/2014/08/12/asciidoctor-1-5-0-released/[发布说明]中解释的，Asciidoctor 1.5.0内部有许多好处，但对Gradle用户来说可能最有趣的是使用Groovy编写自定义扩展（或者你愿意的标签处理器）的能力。你可以通过将包含它们的JAR放置在类路径中来包含扩展，或者你可以直接在Gradle构建中编写它们，通过把代码放在`buildSrc`里。最后一个选项有一个简单的例子在https://github.com/aalmiray/asciidoctor-piglatin-example。
在这个版本中发现的其他特性有：
-
使用`AsciidoctorTask`上的`requires`属性加载基于Ruby的扩展的能力。
-
在`AsciidoctorTask`上使用`gemPath`属性来设置宝石（gem）安装路径的能力。
开发人员被建议尽快升级。请注意插件readme中提出的https://github.com/asciidoctor/asciidoctor-gradle-plugin#compatibility-with-previous-releases[兼容性问题]。不要忘记回顾在http://asciidoctor.org/docs/migration[迁移指南]中找到的Asciidoctor 1.5.0带来的变化。
开发团队要感谢瑞士国内外各种http://hackergarten.net/[Hackergarten]环节的参与者。在这些环节中，贡献了许多问题和功能。没有你们的帮助，我们无法做到这一点。也要感谢所有https://github.com/asciidoctor/asciidoctor-gradle-plugin/contributors[贡献者]的帮忙。
前往并再次创造出伟大的（且充满活力的）文档吧！
升级到1.5.0（推荐）非常简单。只需在你的Gradle构建文件中更新版本号。所有必要的依赖项应该通过Gradle自动拉取。
|
Important
|
当升级到 Asciidoctor 1.5.0 时，请参阅http://asciidoctor.org/docs/migration/[迁移指南]了解如何迁移您的内容的详细信息。 |
关于此版本中修复的问题的更多信息，请查看问题跟踪器中的https://github.com/asciidoctor/asciidoctor-gradle-plugin/issues?milestone=1.5.0&state=closed[1.5.0里程碑]！