1. Install Docker (Ubuntu)

2. Install (swarmlab-adoc)

3. Usage (swarmlab-adoc)

  • Open a console

  • Switch to the directory that contains *.adoc documents

  • Call the Asciidoctor processor with the swarmlab-adoc command

cd dir
swarmlab-adoc
swarmlab-adoc convert all *.adoc files recursiv in html5 and pdf
If you need to convert only one file
docker run --rm -v $(pwd):/documents/ registry.vlabs.uniwa.gr:5080/swarmlab-asciidoctor asciidoctor --safe -b html5  -a theme=flask -a toc2 -a toc-placement=right -o ./path/to/FILENAME.html   ./path/from/FILENAME.adoc

Please note, there is a . in ./path

4. Setup live preview Using a web browser

All you need to preview an AsciiDoc document in a web browser is to install

Then you can see the AsciiDoc file rendered as HTML just by visiting it!

Live Preview

Swarmlab

4.1. Installing the Chrome Extension

  1. Download asciidoctor-chrome-extension.nex

  2. Open chrome://extensions

  3. Drag’n’drop the .nex file into the page to install

4.2. Installing the Firefox Extension

  1. Download asciidoctor-firefox-addon.xpi

  2. Open the file with Firefox to install

4.3. Installing the Opera Extension

  1. Dowload asciidoctor-chrome-extension.nex

  2. Open opera://extensions

  3. Drag’n’drop the .nex file into the page to install

That’s all folks! :-)




Reminder

Caminante, no hay camino,
se hace camino al andar.

Wanderer, there is no path,
the path is made by walking.

Antonio Machado Campos de Castilla