Re: have asciidoctorj output html to be include in jekyll generated site ?
Posted by
abelsromero on
URL: https://discuss.asciidoctor.org/have-asciidoctorj-output-html-to-be-include-in-jekyll-generated-site-tp8353p8354.html
maxandersen wrote
I was wondering there was way to have it generate the same output but just without the <html> and ohter header info, but that will of course get into issues when doing multiple pages html rendering etc.
There's the ''headerFooter'' option (in `OptionsBuilder` class). But not sure how to integrate with a jekyll site without resorting to GH-Action scripting. You could try with
https://github.com/asciidoctor/jekyll-asciidoc or some Gh-Action scripting but it feel too much "yak shaving" to my taste.
If the docs are in the code repo and the site in another place, you could rework them with Antora. There will be extra tasks like spliting the docs, definint a UI theme and integrating a search solution (eg.
https://github.com/Mogztter/antora-lunr), but at least those are docs-related efforts, not custom scripts. If you are willing to consider, drop by
https://gitter.im/antora/users with any question, you'll find other RedHat members working on antora sites, they should be able to help you also.