Using Asciidoctor offline?

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

Using Asciidoctor offline?

jskovjyskebankdk
Hi

I just came back from Devoxx where Dan Allen made it pretty clear that we need to switch to Asciidoctor :)

We currently use Mylyn's WikiText to convert Confluence markup to HTML. But WikiText appears to be dead.

Also the AST magic of Asciidoctor gets me all tingly.


However, our current doc compilation process is able to run entirely off-line. Which is important to us.


When I run a simple test with the Asciidoctor Gradle plugin, it only fetches from the Gradle-declared repos.
So I can cache those (9) dependencies in our internal repo, and not be dependent on off-site repos.
So far, so cool.

I wonder if the Ruby parts of the code downloads gems outside of my control?
Possibly in a lazy fashion, when various magic features of Asciidoc are encountered?


We run a strictly version controlled shop (with a paranoid revision control department, being a bank), and I cannot rely on the Internet to provide me the appropriate bits during the build process. Everything needs to be local and accounted for up front.

So I'd be a happy bunny if someone could assure me that we'd be able to use Asciidoctor in a strictly off-line setting.

Cheers,
Jesper Skov
Reply | Threaded
Open this post in threaded view
|

Re: Using Asciidoctor offline?

asotobu
Hi, first of all thank you so much for moving to Asciidoctor.

Yes you can move to Asciidoctor being totally offline. Keep in mind that gems are bundled inside the jar, so you don't need to install it, and if you want to use the default css, you can embed it inside generated html. The only problem you will encounter is if you want to use font-awesome for example, because it requires a connection to font-awesome CDN. And the same occurs obviously if you try to embed external images. In some release we are going to add that you can also embed external images and/or external js, but I cannot say when.

Also remember that you will need to have apart of gradle plugin, the asciidoctor jar and the jruby jar, but nothing more.

In one presentation I did in Barcelona JUG I was offline I was able to run the examples, so although you can think about asciidoctor it is used mainly to be online, you can still use it offline.

Alex.
Reply | Threaded
Open this post in threaded view
|

Re: Using Asciidoctor offline?

jskovjyskebankdk
Super!

Thank you so much!

Cheers,
Jesper
Reply | Threaded
Open this post in threaded view
|

Re: Using Asciidoctor offline?

asotobu
you are welcome, and thank you for moving your docs to Asciidoc.


2013/11/19 jskovjyskebankdk [via Asciidoctor :: Discussion] <[hidden email]>
Super!

Thank you so much!

Cheers,
Jesper


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Using-Asciidoctor-offline-tp1010p1016.html
To unsubscribe from Using Asciidoctor offline?, click here.
NAML



--
+----------------------------------------------------------+
  Alex Soto Bueno - Computer Engineer
  www.lordofthejars.com
+----------------------------------------------------------+
Reply | Threaded
Open this post in threaded view
|

Re: Using Asciidoctor offline?

LightGuardjp
Administrator
Great answer Alex. Maybe this is something we should detail in the maven and gradle plugins: what is actually downloaded and what you can and can't do offline.


On Tue, Nov 19, 2013 at 1:53 AM, asotobu [via Asciidoctor :: Discussion] <[hidden email]> wrote:
you are welcome, and thank you for moving your docs to Asciidoc.


2013/11/19 jskovjyskebankdk [via Asciidoctor :: Discussion] <[hidden email]>
Super!

Thank you so much!

Cheers,
Jesper


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Using-Asciidoctor-offline-tp1010p1016.html
To unsubscribe from Using Asciidoctor offline?, click here.
NAML



--
+----------------------------------------------------------+
  Alex Soto Bueno - Computer Engineer
  www.lordofthejars.com
+----------------------------------------------------------+



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



--