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
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
-
the Chrome extension
-
or the Firefox add-on
-
or the Opera extension
Then you can see the AsciiDoc file rendered as HTML just by visiting it!
4.1. Installing the Chrome Extension
-
Download asciidoctor-chrome-extension.nex
-
Open chrome://extensions
-
Drag’n’drop the
.nex
file into the page to install
4.2. Installing the Firefox Extension
-
Download asciidoctor-firefox-addon.xpi
-
Open the file with Firefox to install
4.3. Installing the Opera Extension
-
Dowload asciidoctor-chrome-extension.nex
-
Open opera://extensions
-
Drag’n’drop the
.nex
file into the page to install
That’s all folks! :-)
Reminder
Caminante, no hay camino, Wanderer, there is no path, Antonio Machado Campos de Castilla |