Re: have asciidoctorj output html to be include in jekyll generated site ?
Posted by
mojavelinux on
URL: https://discuss.asciidoctor.org/have-asciidoctorj-output-html-to-be-include-in-jekyll-generated-site-tp8353p8355.html
Given you're already using Jekyll with the Jekyll AsciiDoc plugin for the website, I don't see why you wouldn't just include readme.adoc as part of the source for that site. If you want it to be downloaded automatically, use a remote include (like
https://cdn.jsdelivr.net/gh/jbangdev/jbang/readme.adoc) and enable the allow-uri-read attribute to give Asciidoctor permission to download it.
If you want to avoid this hacky, I second Abel's point of using Antora. Perhaps there's still an opportunity to make the switch.
-Dan
On Sat, Nov 21, 2020 at 1:03 AM abelsromero [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
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.
--