= Asciidoc Install ! Apostolos rootApostolos@swarmlab.io // Metadata: :description: Intro and Install :keywords: doc :data-uri: :toc: right :toc-title: Πίνακας περιεχομένων :toclevels: 4 :source-highlighter: highlight :icons: font :sectnums: include::header.adoc[] {empty} + [[cheat-Docker]] == Install Docker (Ubuntu) http://docs.swarmlab.io/Howtos/docker/install.adoc.html[^] [[cheat-Ascii]] == Install (swarmlab-adoc) https://git.swarmlab.io:3000/swarmlab/swarmlab-adoc[^] [[cheat-useadoc]] == 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 ``` TIP: swarmlab-adoc convert all *.adoc files recursiv in html5 and pdf .If you need to convert only one file [NOTE] ==== ``` 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 ==== == Setup live preview Using a web browser All you need to preview an AsciiDoc document in a web browser is to install - the https://chrome.google.com/webstore/detail/asciidoctorjs-live-previe/iaalpfgpbocpdfblpnhhgllgbdbchmia[Chrome extension] - or the https://addons.mozilla.org/en-US/firefox/addon/asciidoctorjs-live-preview[Firefox add-on] - or the https://addons.opera.com/fr/extensions/details/asciidoctorjs-live-preview[Opera extension] Then you can see the AsciiDoc file rendered as HTML just by visiting it! .Live Preview image:tiled-editor-and-web-preview.png[alt="Swarmlab"] === Installing the Chrome Extension . Download https://github.com/asciidoctor/asciidoctor-chrome-extension/releases/download/v1.5.4.100/asciidoctor-chrome-extension.nex[asciidoctor-chrome-extension.nex] . Open chrome://extensions . Drag'n'drop the `.nex` file into the page to install === Installing the Firefox Extension . Download https://github.com/asciidoctor/asciidoctor-firefox-addon/releases/download/v0.5.3/asciidoctor-firefox-addon-0.5.3-signed.xpi[asciidoctor-firefox-addon.xpi] . Open the file with Firefox to install === Installing the Opera Extension . Dowload https://github.com/asciidoctor/asciidoctor-chrome-extension/releases/download/v1.5.4.100/asciidoctor-chrome-extension.nex[asciidoctor-chrome-extension.nex] . Open opera://extensions . Drag'n'drop the `.nex` file into the page to install That's all folks! :-) :hardbreaks: {empty} + {empty} + {empty} :!hardbreaks: ''' .Reminder [NOTE] ==== :hardbreaks: 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 ====