Gradle and asciidoc

Question

Я немного смущен о том, как использовать Gradle для преобразования моих файлов asciidoc в PDF. Существует эта GitHub repo с набором примеров, используя следующий Gradle построить стиль файла (отрывок):

apply plugin: 'org.asciidoctor.convert' 

asciidoctor { 
    ... 
} 

используя Asciidoctor Gradle плагин от here (GitHub).

С другой стороны, мы имеем описание в Asciidoctor Gradle Plugin here (Официальные документы) или here (mrhaki), используя этот стиль:

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 выбирается разработчиком плагина. Я бы воспользовался рекомендацией из официальной документации.