= QuickStart ! Apostolos rootApostolos@swarmlab.io // Metadata: :description: Intro and Install :keywords: doc, Quick :data-uri: :toc: right :toc-title: Πίνακας περιεχομένων :toclevels: 4 :source-highlighter: highlight :icons: font :sectnums: include::header.adoc[] {empty} + [[cheat-Ascii]] == Install (swarmlab-adoc) https://git.swarmlab.io:3000/swarmlab/swarmlab-adoc[^] [[cheat-useadoc]] == Create project - Open a console [source,bash] ---- mkdir mytest cd mytest swarmlab-adoc ---- == Copy-Paste asciidoc source .copy-paste source [source,asciidoc] ---- Paragraphs don't require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text. To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed. A paragraph offset by at least one space becomes a literal paragraph. All lines in a literal paragraph must be adjacent. A literal paragraph is displayed as preformatted text. The text is shown in a fixed-width font. Spaces and newlines, like the ones in this sentence, are preserved. NOTE: An admonition paragraph draws the reader's attention to auxiliary information. Its purpose is determined by the label at the beginning of the paragraph. Here are the other built-in admonition types: TIP: Pro tip... IMPORTANT: Don't forget... WARNING: Watch out for... CAUTION: Ensure that... bold *constrained* & **un**constrained italic _constrained_ & __un__constrained bold italic *_constrained_* & **__un__**constrained monospace `constrained` & ``un``constrained monospace bold `*constrained*` & ``**un**``constrained monospace italic `_constrained_` & ``__un__``constrained monospace bold italic `*_constrained_*` & ``**__un__**``constrained === Level 2 Section Title ==== Level 3 Section Title ===== Level 4 Section Title ====== Level 5 Section Title Rubies are red, + Topazes are blue. [%hardbreaks] Ruby is red. * Edgar Allen Poe * Sheri S. Tepper * Bill Bryson Unordered, basic (alt) - Edgar Allen Poe - Sheri S. Tepper - Bill Bryson * [*] checked * [x] also checked * [ ] not checked * normal list item https://asciidoctor.org - automatic! https://asciidoctor.org[Asciidoctor] https://github.com/asciidoctor[Asciidoctor @ *GitHub*] image::sunset.jpg[] image::sunset.jpg[Sunset] .A mountain sunset [#img-sunset] [caption="Figure 1: ",link=https://www.flickr.com/photos/javh/5448336655] image::sunset.jpg[Sunset,300,200] video::video_file.mp4[] video::video_file.mp4[width=640, start=60, end=140, options=autoplay] === The Greatest Embedded Youtube video video::axMLZZNINCU[youtube] === pipe de oro Embedded Vimeo video video::154836263[vimeo] ---- == Run .run - Create a file.adoc in mytest directory - Paste code [source,bash] ---- cd mytest 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 ==== == Using a web browser You can see the file rendered as HTML just by visiting it! == view result .view result Paragraphs don't require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text. To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed. A paragraph offset by at least one space becomes a literal paragraph. All lines in a literal paragraph must be adjacent. A literal paragraph is displayed as preformatted text. The text is shown in a fixed-width font. Spaces and newlines, like the ones in this sentence, are preserved. NOTE: An admonition paragraph draws the reader's attention to auxiliary information. Its purpose is determined by the label at the beginning of the paragraph. Here are the other built-in admonition types: TIP: Pro tip... IMPORTANT: Don't forget... WARNING: Watch out for... CAUTION: Ensure that... bold *constrained* & **un**constrained italic _constrained_ & __un__constrained bold italic *_constrained_* & **__un__**constrained monospace `constrained` & ``un``constrained monospace bold `*constrained*` & ``**un**``constrained monospace italic `_constrained_` & ``__un__``constrained monospace bold italic `*_constrained_*` & ``**__un__**``constrained === Level 2 Section Title ==== Level 3 Section Title ===== Level 4 Section Title ====== Level 5 Section Title Rubies are red, + Topazes are blue. [%hardbreaks] Ruby is red. * Edgar Allen Poe * Sheri S. Tepper * Bill Bryson Unordered, basic (alt) - Edgar Allen Poe - Sheri S. Tepper - Bill Bryson * [*] checked * [x] also checked * [ ] not checked * normal list item https://asciidoctor.org - automatic! https://asciidoctor.org[Asciidoctor] https://github.com/asciidoctor[Asciidoctor @ *GitHub*] image::sunset.jpg[] image::sunset.jpg[Sunset] .A mountain sunset [#img-sunset] [caption="Figure 1: ",link=https://www.flickr.com/photos/javh/5448336655] image::sunset.jpg[Sunset,300,200] video::video_file.mp4[] video::video_file.mp4[width=640, start=60, end=140, options=autoplay] === The Greatest Embedded Youtube video video::axMLZZNINCU[youtube] === pipe de oro Embedded Vimeo video video::154836263[vimeo] :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 ====