gradle - Gradle 和 asciidoc

Question

我对使用 Gradle 将我的 asciidoc 文件转换为 PDF 的选项有点困惑。有这个GitHub存储库，其中包含一组使用以下 Gradle 构建文件样式（摘录）的示例：

apply plugin: 'org.asciidoctor.convert'

asciidoctor {
  ...
}

从这里（github）使用 Asciidoctor Gradle 插件。

另一方面，我们在此处（官方文档）或此处（mrhaki）使用此样式对 Asciidoctor Gradle 插件进行了描述：

apply plugin: 'org.asciidoctor.gradle.asciidoctor'

asciidoctor {
  ...
}

那么哪一个是当前（和正确）的语法？如果我想生成 PDF 并包含图表，我应该使用哪一个？

（只是说清楚：我只有非常有限的 Gradle 经验；）

Answer 1

我的build.gradle阅读

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        classpath 'org.asciidoctor:asciidoctor-gradle-plugin:1.5.0'
        classpath 'org.asciidoctor:asciidoctorj-pdf:1.5.0-alpha.11'
    }
}

apply plugin: 'org.asciidoctor.gradle.asciidoctor'

asciidoctor {
    backends = ['pdf']
    options = [
        attributes: [
            'pdf-stylesdir': file('src/docs/theme'),
            'pdf-style': 'myowntheme'
        ]
    ]
}

您可以使用search.maven.org找出 group 中工件的最新版本org.asciidoctor。

Answer 2

查看apply plugin: 'org.asciidoctor.gradle.asciidoctor'的org.asciidoctor.gradle.asciidoctor是pluginId。pluginId 由插件开发人员选择。我会使用官方文档中的建议。