Re: have asciidoctorj output html to be include in jekyll generated site ?

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

I spent a little time setting up the readme.adoc as an Antora site: https://github.com/jbangdev/jbang/pull/535.
This includes the two bits from couchbase, the tabs-block extension and the clipboard.js.
The basics of including the code so it’s usable/accessible was trivial however….
* Tabs work although they don’t look elegant, so I might have missed some important css.
* The js for clipboard works but the functionality seems to rely on font awesome icons, and I can’t get it to work.  is ‘far fa-copy’ a pro icon?

My personal opinion is that having this readme as one page is extremely user-unfriendly.  If you’re interested in pursuing Antora-izing, you should be set up with this PR to start breaking the content into reasonable sized pages.

David Jencks

On Nov 21, 2020, at 5:21 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

With AsciidoctorJ, there's no setup and they are simple mvn dependencies because someone took the time to make them available. Ruby and JavaScript have exactly the same capability, so you can get the same experience with the Jekyll and Antora workflows. It's just that someone hasn't done the work for you.

I think you're making out publishing a RubyGem to be a lot harder than it actually is (especially with someone of your development experience). Frankly, it's simpler than publishing to Maven Central.

-Dan

On Sat, Nov 21, 2020 at 6:08 PM maxandersen [via Asciidoctor :: Discussion] <<a href="x-msg://40/user/SendEmail.jtp?type=node&amp;node=8361&amp;i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
thanks for the link of other antora sites - will definitely take a look.

my issue is that I am trying first to do this for jbang and then see how to apply it to quarkus on other sites and if I end up with having to duplicate and maintain the ruby and .js files separately it just won't happen :)

with asciidoctorj there is no setup and they are simple mvn dependencies - it just don't fit well into jekyll nor antora workflows and having to go setup and maintain a set of ruby gems is fairly low on my list of things to start doing...but there might just not be a way around it ;/




If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/have-asciidoctorj-output-html-to-be-include-in-jekyll-generated-site-tp8353p8360.html
To start a new topic under Asciidoctor :: Discussion, email <a href="x-msg://40/user/SendEmail.jtp?type=node&amp;node=8361&amp;i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML


--
Dan Allen (he, him, his) | @mojavelinux | https://twitter.com/mojavelinux



If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/have-asciidoctorj-output-html-to-be-include-in-jekyll-generated-site-tp8353p8361.html
To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML