Gradle 和 asciidoc

Question

我对使用 Gradle 将我的 asciidoc 文件转换为 PDF 的选项感到有点困惑。 GitHub repo 有一组使用以下 Gradle 构建文件样式（摘录）的示例：

apply plugin: 'org.asciidoctor.convert'

asciidoctor {
  ...
}

使用来自 here (github) 的 Asciidoctor Gradle 插件。

另一方面，我们有一个使用这种风格的 Asciidoctor Gradle 插件 here (official docs) or here (mrhaki) 的描述：

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

asciidoctor {
  ...
}

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

（澄清一下：我的 Gradle 经验非常有限；）

Answer 1

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

Answer 2

我的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 找出组 org.asciidoctor 中工件的最新版本。

Gradle 和 asciidoc

Gradle and asciidoc

gradle

asciidoc

asciidoctor