我们很高兴把最新的Asciidoctor里程碑发布，[Asciidoctor 1.5.0](uri-announcement-1-5-0)，作为AsciidoctorJ 1.5.0带到JVM上！

AsciidoctorJ是什么？

AsciidoctorJ 是在 JVM 上使用 Asciidoctor 的官方库。通过 AsciidoctorJ，您可以从 Java 和其他 JVM 语言转换 AsciiDoc 内容或分析已解析的 AsciiDoc 文档的结构。

图标：票据[] 已解决问题

在版本1.5.0中已解决以下问题：

  • 添加了方法来注册扩展到AsciidoctorJ，这些扩展可以用_Ruby_或_Java_编写。解决了https://github.com/asciidoctor/asciidoctorj/issues/90[#90]和https://github.com/asciidoctor/asciidoctorj/issues/157[#157]。

  • 创建一个SPI，从而_Java_扩展可以通过简单地将jar添加到_classpath_中自动注册。解决https://github.com/asciidoctor/asciidoctorj/issues/97[#97]

  • 扩展 API 已更新，包含在 Asciidoctor 1.5.0 中所做的修改。解决了 #113、https://github.com/asciidoctor/asciidoctorj/issues/114[#114]、https://github.com/asciidoctor/asciidoctorj/issues/148[#148]、https://github.com/asciidoctor/asciidoctorj/issues/162[#162] 以及 #166。

  • 提供一种方法来注销之前注册的任何扩展。解决 #122 问题。

  • 在CLI类中添加了`-r`和`-I`标志，分别用于要求额外的Ruby脚本和添加到加载路径。解决了https://github.com/asciidoctor/asciidoctorj/issues/171[#171]问题。

  • 在CLI类中添加了`-V`和`--version`标志。解决了https://github.com/asciidoctor/asciidoctorj/issues/87[#87]和https://github.com/asciidoctor/asciidoctorj/issues/117[#117]问题。

  • 添加了与_AsciiDoc EPUB3_项目的集成。您可以将`epub3`设置为后端。 解决了https://github.com/asciidoctor/asciidoctorj/issues/168[#168]和https://github.com/asciidoctor/asciidoctorj/issues/179[#179]的问题。

  • 更新了`AbstractBlock`类，增加了`findBy`方法。解决了https://github.com/asciidoctor/asciidoctorj/issues/164[#164]问题。

  • 更新 Document 类以与 Asciidoctor::Document 保持一致，这样获取标题时可以返回一个包含标题、副标题的 Title 类，而不是作为带有完整标题的字符串。解决 #167问题。

  • 促进了属性`sectnumlevels`、hardbreaks、appendix-caption、stem、hide-uri-schema、nofooter、source-language`和`compat-mode。解决了https://github.com/asciidoctor/asciidoctorj/issues/91[#91]、https://github.com/asciidoctor/asciidoctorj/issues/92[#92]、https://github.com/asciidoctor/asciidoctorj/issues/94[#94]、https://github.com/asciidoctor/asciidoctorj/issues/105[#105]、https://github.com/asciidoctor/asciidoctorj/issues/121[#121]、https://github.com/asciidoctor/asciidoctorj/issues/129[#129]、https://github.com/asciidoctor/asciidoctorj/issues/144[#144]以及https://github.com/asciidoctor/asciidoctorj/issues/163[#163]的问题。

  • 你可以从`JRubyRuntimeContext`类中获取用于AsciidoctorJ的_Ruby_实例。解决https://github.com/asciidoctor/asciidoctorj/issues/93[#93]

  • 修复了_Ruby_实例和`Attributes`类中的一个错误，这个错误阻止了_Gradle_插件的正常工作。解决了https://github.com/asciidoctor/asciidoctorj/issues/96[#96]问题。

  • 在`AsciiDocDirectoryWalker`中跳过以下划线（_）开头的文件和目录。解决https://github.com/asciidoctor/asciidoctorj/issues/124[#124]问题。

  • 添加`slf4j`作为日志系统。解决https://github.com/asciidoctor/asciidoctorj/issues/126[#126]问题

  • Fixes a bug with base_dir and Ruby environment. Resolves #135

  • Section`、Block、Node、Document 等 Document 对象已经被转移到 org.asciidoctor.dom 包中。

  • 更新Java版本至 Java 7。 解决 #176 问题

关于此版本中修复的问题的更多信息，请查看问题跟踪器中的https://github.com/asciidoctor/asciidoctorj/issues?q=milestone%3A1.5.0[1.5.0里程碑]！

图标：快进[] 迁移

从1.5.0版本开始，artifactId从`asciidoctor-java-integration`变更为`asciidoctorj`。你现在应该在你的项目的pom.xml文件中使用以下依赖段落：

<dependency>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctorj</artifactId>
    <version>1.5.0</version>
</dependency>

在升级到Asciidoctor 1.5.0时，请参考http://asciidoctor.org/docs/migration/[迁移指南]以获取有关如何迁移内容的详细信息。我们也建议您浏览http://asciidoctor.org/release-notes/asciidoctor-1-5-0/[Asciidoctor 1.5.0的发布说明]。

Warning

Asciidoctor 1.5.0在内部以及公共API上引入了许多变化。例如，扩展API经过了一些非微不足道的修改，因此在升级到这个版本的AsciidoctorJ时，你很可能需要更新你的扩展以适应新的API。

访问更新后的http://asciidoctor.org/docs/asciidoctorj/[AsciidoctorJ手册]，学习如何安装和使用AsciidoctorJ。

这个版本为Gradle插件、Maven插件和Asciidoclet的新版本铺平了道路，这些都是基于AsciidoctorJ开发的。请期待后续的相关公告！