搖籃和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來找出org.asciidoctor組中工件的最新版本。

Answer 2

查看apply plugin: 'org.asciidoctor.gradle.asciidoctor' org.asciidoctor.gradle.asciidoctor是pluginId 。 pluginId由插件開發人員選擇。 我會使用官方文檔中的建議。