3

PlantUML 是 Asciidoc 的一个很好的扩展，但我无法从我的 groovy 代码中弄清楚如何使用。

据我所知，该asciidoctorj-diaram模块应该是当前asciidoctorj-Release 的一部分，所以我想我不需要额外的依赖。但是我的代码可以很好地呈现 asciidoc，但不能呈现 PlantUML 图。它说：

invalid style for open block: plantuml

知道有什么问题吗？我在网上找到的asciidoctorj-diagram例子都使用了 gradle-plugin :-|

4

1 回答 1

2

即使该库是 AsciidoctorJ 项目的一部分，也有一个单独的 java 库称为：（asciidoctorj-diagram的 java 版本asciidoctor-diagram）

你确定你有asciidoctorj-diagram你的类路径吗？这里的maven坐标：

<dependency>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctorj-diagram</artifactId>
    <version>1.3.1</version>
</dependency>

您还需要告诉 Asciidoctor 这asciidoctor-diagram是必需的。请参阅<1>以下纯 java 示例中的行：

public static void main(String[] args) {
    org.asciidoctor.Asciidoctor asciidoctor =
             org.asciidoctor.Asciidoctor.Factory.create();

    asciidoctor.requireLibrary("asciidoctor-diagram"); // <1>

    StringBuilder sb = new StringBuilder();
    sb.append("== Diagrams\n");
    sb.append("\n");
    sb.append("[plantuml,auth-protocol]\n");
    sb.append("....\n");
    sb.append("Alice -> Bob: Authentication Request\n");
    sb.append("Bob --> Alice: Authentication Response\n");
    sb.append("\n");
    sb.append("Alice -> Bob: Another authentication Request\n");
    sb.append("Alice <-- Bob: another authentication Response\n");
    sb.append("....\n");

    String html = asciidoctor.convert(sb.toString(), 
             new java.util.HashMap<String, Object>());
    System.out.println(html);
}

顺便说一句，还有一个 maven 示例：asciidoctor-diagram-example。但是这个例子需要asciidoctor-maven-plugin类似于 gradle 插件。

于 2016-01-19T20:00:19.230 回答