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-tp8353p8365.html
> For some reason (unless i'm blind) in case of ruby based asciidoctor the
reusable parts gets copied around.....thats what I was trying to avoid.
That's simply not true. Reusable parts in Ruby can be distributed as a RubyGem (or loaded as a RubyGem directly from git, which Bundler allows [1]). If someone's not doing that, then they're just being lazy.
-Dan
On Sun, Nov 22, 2020 at 2:31 AM maxandersen [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
David Jencks wrote
I spent a little time setting up the readme.adoc as an Antora site:
https://github.com/jbangdev/jbang/pull/535 <
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?
Thank you very much David for taking the time to do that - really appreciated; but the result is what I'm trying to avoid - that inside the project is now all these parts I believe is better of in a shared component so I don't have to maintain this across multiple repos.
I know Dan says one with my expertise can make that happen; but my expertise also tells me that such things gets stale fast - hence why I like asciidoctorj as here I in my circle of what I know can see they are being maintained and made reusable.
For some reason (unless i'm blind) in case of ruby based asciidoctor the reusable parts gets copied around.....thats what I was trying to avoid.
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.
The whole goal of this is to get it to split up - I just didn't do that yet as I'm trying to figure out where the doc will end up living which depend on the stack used/applied.
again thanks for the PR - I'll definitely take a look and see if can learn something.
--