Howtos/asciidoc/install-asciidoc.adoc

= 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 recursiva 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 {uri-chrome-extension}[Chrome extension], the {uri-firefox-addon}[Firefox add-on] or the {uri-opera-extension}[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 development versions

The validation process of a browser extension / addon can take a long time.
If you want the latest and greatest version you can use the direct download links below.

==== Chrome

. Download {uri-chrome-extension-dd}[asciidoctor-chrome-extension.nex]
. Open chrome://extensions
. Drag'n'drop the `.nex` file into the page to install

==== Firefox

. Download {uri-firefox-addon-dd}[asciidoctor-firefox-addon.xpi]
. Open the file with Firefox to install

==== Opera

. Dowload {uri-opera-extension-dd}[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
====