How do we use these extensions? about asciidoctor-extensions-lab HOT 6 CLOSED

Hi @andreabedini there's a blog post explanining how to load extensions from the CLI: http://asciidoctor.org/release-notes/asciidoctor-1-5-0/#spotlight-load-extensions

Let me know if this is working for you,
Cheers.
Guillaume.

from asciidoctor-extensions-lab.

And to bring everything together, here's an example of how you would load the emoji inline macro extension:

git clone https://github.com/asciidoctor/asciidoctor-extensions-lab
asciidoctor -r ./asciidoctor-extensions-lab/lib/emoji-inline-macro.rb your-doc.adoc

Note that the -r should be the relative path from the current directory to the Ruby script that loads the extension. If the extension is bundled and installed as a Ruby gem, like asciidoctor-diagram, then you can simply pass the name, like -r asciidoctor-diagram.

Btw, we need a README for this repository that covers (at least) the following information:

1. What extensions are available here
2. How to load an extension from the extension lab

We should also cover how these extensions are organized to help people create new ones.

...and eventually, we need to graduate some extension out of the lab once we determine that they are stable and popular. But we'll cross that bridge when we get to it.

from asciidoctor-extensions-lab.

Are you able to load the extensions now @andreabedini? If so, perhaps we can open a new issue to add a proper README.

from asciidoctor-extensions-lab.

hi @mojavelinux @Mogztter sorry for leaving you hanging. I think I did manage to get them working at some point (and in some way). Mine was perhaps a little complaint on the lack of documentation! :) thanks for all your work. I love asciidoc(or) and I want to see it succeed! especially in academia (my industry) where markdown has already some momentum behind (scholarly markdown).

from asciidoctor-extensions-lab.

I think I did manage to get them working at some point (and in some way).

Nice.

Mine was perhaps a little complaint on the lack of documentation! :)

A justified compliant indeed.

I'm going to close this and replace it with an issue to create a proper README.

from asciidoctor-extensions-lab.

Closed in favor of #44.

from asciidoctor-extensions-lab.