Градл и Асцидок

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

apply plugin: 'org.asciidoctor.convert'

asciidoctor {
  ...
}

с помощью подключаемого модуля Asciidoctor Gradle из здесь (github).

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

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

asciidoctor {
  ...
}

Итак, какой из них является текущим (и правильным) синтаксисом? Какой из них я должен использовать, если я хочу создавать PDF-файлы и включать диаграммы?

(Просто чтобы было понятно: у меня очень ограниченный опыт работы с Gradle;)


person Xogaz    schedule 10.02.2016    source источник
comment
как выглядит ваш раздел buildscript{dependencies{}}?   -  person RaGe    schedule 11.02.2016
comment
Возможно, указанный плагин изменился между версиями. поэтому в зависимости от того, на какую версию вы указываете в своих buildscript.dependencies, любая из них может быть действительной.   -  person RaGe    schedule 11.02.2016
comment
Да, я думаю, идентификатор плагина изменился. Кажется, что оба идентификатора могут использоваться взаимозаменяемо. Я буду придерживаться первого (используется в документации и примерах github).   -  person Xogaz    schedule 12.02.2016


Ответы (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.

person bgerth    schedule 11.03.2016

Глядя на apply plugin: 'org.asciidoctor.gradle.asciidoctor', org.asciidoctor.gradle.asciidoctor представляет собой идентификатор плагина. Идентификатор pluginId выбирается разработчиком плагина. Я бы воспользовался рекомендацией из официальной документации.

person Ethan    schedule 11.02.2016