Erste Schritte
Die Oberfläche von adoc Studio
Schauen wir uns zuerst die Oberfläche in adoc Studio genauer an. Sie besteht aus drei Bereichen:
-
Seitenleiste: Hier sehen Sie all Ihre Dokumente, Kapitel, Ordner und Medien im aktuellen Projekt.
-
Editor: Hier schreiben Sie Ihr Dokument.
-
Vorschau: Hier sehen Sie die Ausgabe Ihres Dokuments in PDF oder HTML.
Die Vorschau und der Editor sind voneinander getrennt. Das hat den Vorteil, dass Sie Änderungen am Inhalt oder der Gestaltung unabhängig voneinander vornehmen können.
Schreiben in AsciiDoc
AsciiDoc ist eine einfache Auszeichnungssprache. Das bedeutet, Sie zeichnen Ihre Texte mit einzelnen Zeichen aus, um diese genauer zu beschreiben. Diese Markierungen bestimmen, wie der Text in der Vorschau und in der Ausgabe angezeigt wird.
So steht ein = für den Dokumenttitel. Jedes zusätzliche = setzt die Überschrift eine Hierarchieebene tiefer.
| In adoc Studio werden Überschriften automatisch in der Seitenleiste (im Abschnitt-Navigator) als Gliederung angezeigt. Ein Klick darauf springt direkt zur entsprechenden Stelle im Dokument. |
Überschriften und Dokumentstruktur
AsciiDoc unterstützt bis zu sechs Überschriftenebenen:
| Syntax | Bedeutung | Verwendung |
|---|---|---|
|
|
Dokumenttitel |
Nur einmal pro Dokument, ganz oben |
|
|
Kapitel (Level 1) |
Hauptabschnitte Ihres Dokuments |
|
|
Unterkapitel (Level 2) |
Unterteilungen innerhalb eines Kapitels |
|
|
Abschnitt (Level 3) |
Weitere Unterteilungen |
|
|
Unterabschnitt (Level 4) |
Feinere Gliederung |
|
|
Tiefste Ebene (Level 5) |
Selten verwendet |
Zwischen dem = und dem Überschriftentext muss immer ein Leerzeichen stehen. |
In den kommenden Kapiteln werden wir tiefer in AsciiDoc einsteigen. Im Kapitel Formatierungen lernen Sie, wie Sie Text fett, kursiv oder unterstrichen darstellen.