You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
120 lines
2.4 KiB
120 lines
2.4 KiB
= 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
|
|
====
|
|
|