1. Usage

  • Open a console

  • Switch to the directory that contains *.adoc documents

  • Call the Asciidoctor processor with the command

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

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

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

2.2. Installing the Firefox Extension

  1. Download asciidoctor-firefox-addon.xpi

  2. Open the file with Firefox to install

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