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.
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.