In den Prüfschritten verwenden wir die Auszeichnungssprache AsciiDoc. In diesem Dokument stellen wir einen Schnelleinstieg zur Verfügung. Für detailliertere Informationen verweisen wir auf den Writers Guide von Asciidoctor.
Absätze werden einfach durch Leerzeilen vor und nach dem Text gekennzeichnet.
Erster Absatz. Zweiter Absatz. Hier kommt der dritte Absatz. Dieser hat mehrere Zeilen. Dies soll die Absatzlogik verdeutlichen. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
Ergebnis
Erster Absatz.
Zweiter Absatz.
Hier kommt der dritte Absatz. Dieser hat mehrere Zeilen. Dies soll die Absatzlogik verdeutlichen. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
Überschriften werden mit dem “=” und einem darauf folgendem Leerzeichen eingeleitet. Die Anzahl der Gleichheitszeichen bestimmt die Überschriftsebene.
= Dokumententitel bzw. Überschriftsebene 1 == Überschriftsebene 2 === Überschriftsebene 3 ==== Überschriftsebene 4 ===== Überschriftsebene 5 ====== Überschriftsebene 6
Links die mit “http://” oder “https://” beginnen, werden automatisch zu Links umgewandelt. Möchte man einen Text verlinken, setzt man den Text in eckige Klammern (“[ ]”). Direkt davor wird die Linkadresse angegeben.
https://www.bitvtest.de/start.html[Startseite des BITV-Tests]
Ergebnis
Möchte man relative Links einsetzen, z. B. “Ordner/Datei.html”, “Datei.html”, muss das Präfix “link:” eingesetzt werden.
link:Ordner/Datei.html[Mein Link] link:Datei.html[Mein zweiter Link]
Ergebnis
Um sichere Verweise auf andere AsciiDoc-Dateien zu setzen, die auch fehlerfrei in HTML umgewandelt werden, sollten Inter-document cross references eingesetzt werden.
<<Dokumentpfad#ID,Linktext>>
<<convert2html.adoc#_benötigte_werkzeuge,AsciiDoc Werkzeuge>>
Ergebnis
Listen müssen in einem eigenen Absatz definiert werden. Jedes Listenelement beginnt mit einem “*” gefolgt von einem Leerzeichen.
Ein Absatz ... * Orangen * Äpfel * Birnen Noch ein Absatz ...
Ergebnis
Ein Absatz …
-
Orangen
-
Äpfel
-
Birnen
Noch ein Absatz …
Geordnete Listen werden ähnlich definiert, hier wird jedoch ein Punkt (“.”) gefolgt von einem Leerzeichen vor jedes Listenelement gesetzt. Gezählt wird dann automatisch durch den Konverter.
Ein Absatz ... . Orangen . Äpfel . Birnen Noch ein Absatz ...
Ergebnis
Ein Absatz …
-
Orangen
-
Äpfel
-
Birnen
Noch ein Absatz …