play-iot / gradle-plugin

PlayIO Gradle plugin
Apache License 2.0
2 stars 0 forks source link

Antora webdocs plugin #54

Open zero88 opened 1 year ago

zero88 commented 1 year ago

Make Antora docs plugin compatible with https://gitlab.com/antora/gradle-antora-plugin to build web-docs directly via gradle

mojavelinux commented 8 months ago

Is there a reason you just aren't using the Gradle Antora Plugin? Is there functionality that it is missing? If so, would you be willing to contribute it?

zero88 commented 4 months ago

thank you for asking. gradle-antora-plugin aims to build Antora playbook, a wrapper for Antora CLI. That is useful for a standalone project. My plugin is to generate Asciidoc and construct the Antora document component/module. With that, I can build and store documents in Antora layout per project/repository. On the other hand, I create a dedicated repository using Antora CLI to gather all my projects and build all-in-one web docs. As my approach, gradle-antora-plugin might be useful when doing a web preview per project, but I had some difficulty extending it to wrap gradle-antora-plugin in my plugin in the past