Login  Register

Re: Asciidoctor backends

Posted by LightGuardjp on Mar 07, 2013; 4:55pm
URL: https://discuss.asciidoctor.org/Asciidoctor-backends-tp16p28.html

I was just thinking about this in context of the maven and gradle plugins. With these being a different gem, it 

1. becomes difficult to add different backends for your build
2. knowing the exact location of the backends, will Ruby explode the jar?

I think we may need to readdress this idea of having the backends be different gems.


On Thu, Mar 7, 2013 at 7:04 AM, asotobu [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi Paul,
well first of all let me tell you that I am only developing backends (mainly because I have no idea of Ruby ), so some of questions you asking should be answered by Dan I guess . Well let's start with what I can answering you:

- You do not require -b option, only -T pointing to backend directory, in https://github.com/asciidoctor/asciidoctor-backends#deckjs-backend you can see an instellation example.

- I completely agree with you that we need some way to install backends in a fashionable way, something like gem install and then the <backend> / or gem install extra-backends with all backends.

- In case of documentation, for now we are using the README.md where we are documenting all supported backends. So if backends are treat as "external", I think it should be a link from official asciidoctor documentation to get backends repo.

- About what you have noticed about "official" backends, I think that Dan would give you a better answer. By default asciidoc (and asciidoctor) comes with these two backends, and I think that in case of asciidoctor are not implemented as HAML or SLIM template, but as native ruby file (Tilt is not used). So asciidoctor extension is implemented using Tilt gem, so if you want to provide an extension it should be done using this second approach. Keep in mind that in case of asciidoc, it is the way how it works.

Of course feel free to ask me as many questions as you had, and I will try to answer it as better as possible, also keep in mind that Dan and all people of asciidoctor are improving it every week, so we should stay alert about possible changes.

And again for any question do not hesitate to contact me.

Alex.




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Asciidoctor-backends-tp16p24.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Jason Porter
http://en.gravatar.com/lightguardjp