Posted by maxandersen on
URL: https://discuss.asciidoctor.org/have-asciidoctorj-output-html-to-be-include-in-jekyll-generated-site-tp8353p8358.html

mojavelinux wrote

It would be a lot of work, but you could run Jekyll using JRuby, then patch
Jekyll AsciiDoc to use the AsciidoctorJ APIs to invoke Asciidoctor. When
Ruby code is running JRuby, it can access Java objects.

Yeah - this would be too much - trying to avoid too much ;)

An alternative would be to use AsciidoctorJ to generate embedded HTML (as
Abel suggested), then dump that into the source directory of the Jekyll
site and let Jekyll apply a template to it.

You mean tweaking header/footer options?

I'm curious to know what extensions are available for AsciidoctorJ that you
would need to use in the site. (Unless they are very complex, they probably
wouldn't be that hard to rewrite in Ruby).

No they are not complex; but they are there without extra setup.

i.e.https://asciidoctor.org/docs/extensions/ has a list of them - the two i'm mainly after are the copy source block combined with https://github.com/bmuschko/asciidoctorj-tabbed-code-extension which I actually ported to ruby version
and contributed to asciidoctor extensions lab https://github.com/asciidoctor/asciidoctor-extensions-lab/pull/112 but that never got merged so i would have to find a place to host that somewhere else ..which I could but I never found a good way of sharing that code easily to other jekyll users...so i'm back to try and work with asciidoctorj as here it "just works".......

> Antora is nice but feels overkill for this case.

I'd argue that your readme is already entirely too long and should be
divided up into a documentation site to make it more approachable.

That is actually why I'm looking at doing this - want to move a better way of generating and
including the docs but having to maintain/write these small but useful extensions is just not
something i'm keen on if I can avoid it.

So, in fact, this would be the right time to be considering Antora. Just look at
the result that the AsciiDoc IntelliJ plugin was able to achieve in very
short time:
https://intellij-asciidoc-plugin.ahus1.de/docs/users-guide/index.html That
project is no bigger than yours.

That rendering looks nice - definitely one of the better antora sites I've seen - but does antora
help me get easier access to copy / tabbed sources or do I have to do that manually/on my own too here ?