摇篮和asciidoc

Question

I am a bit confused about the options to use Gradle to convert my asciidoc files to PDF. There is this GitHub repo with a set of examples using the following Gradle build file style (excerpt):

apply plugin: 'org.asciidoctor.convert'

asciidoctor {
  ...
}

using the Asciidoctor Gradle Plugin from here (github).

On the other hand we have a description of an Asciidoctor Gradle Plugin here (official docs) or here (mrhaki) using this style:

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

asciidoctor {
  ...
}

So which one is the current (and correct) syntax? Which one am I supposed to use if I want to generate PDFs and include diagrams?

(Just to make it clear: I have only very limited Gradle experience ;)

Answer 1

My build.gradle reads

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'
        ]
    ]
}

You can use search.maven.org to figure out the latest versions of the artifacts within group org.asciidoctor .

Answer 2

Looking at apply plugin: 'org.asciidoctor.gradle.asciidoctor' the org.asciidoctor.gradle.asciidoctor is the pluginId . The pluginId is picked by the plugin developer. I would use the recommendation from the official documentation.