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.
97 lines
2.4 KiB
97 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:
|
|
|
|
|
|
|
|
{empty} +
|
|
|
|
|
|
|
|
== 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
|
|
[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
|
|
====
|
|
|