-
Die eigentliche Vorlage befindet sich in der Datei article.adoc. Alle anderen Dateien kannst du ignorieren.
-
Wenn du zusammen mit einem oder mehreren anderen Autoren am Artikel arbeitest, so kannst du diese in Zeile 2 mit Semikolon
;getrennt aufführen. Bitte nicht auf mehrere Zeilen verteilen! -
Wenn du möchtest, kannst du für deine Bilder ein eigenes Verzeichnis anlegen. Passe dann das Attribut
:imagesdir:entsprechend an. Verwende immer relative Verzeichnisangaben, niemals absolute. -
Vergiss nicht, beim Einreichen alle nötigen Dateien (Bilder, Quelltext, etc.) mitzuschicken. Sende dazu entweder eine ZIP-Datei per E-Mail an Marcus Fihlon (Verschlüsselung per GnuPG möglich) oder verwende ein GitHub-Repository. Ist das GitHub-Repository privat, lade bitte Marcus Fihlon mit entsprechenden Berechtigungen in das GitHub-Repository ein.
Um aus einer Asciidoc-Datei die verschiedenen Ausgabe-Dateien (HTML, PDF, XML, Word) zu generieren, werden die Kommandozeilen-Tools Asciidoctor mit der Erweiterung asciidoctor-lists und Pandoc benötigt. Die entsprechenden Aufrufe befinden sich im Shell-Skript compile.sh. Das Skript konvertiert die Datei article.adoc im aktuellen Verzeichnis. Um die automatisch erzeugten Dateien wieder zu löschen, kann das Skript clean.sh aufgerufen werden.