mkarg / javaaktuell-asciidoc-template

Fork of Java aktuell's AsciiDoc Template

Java aktuell Artikelvorlage im Asciidoc Format

Informationen für Autoren

• 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.

Informationen für die Redaktion

Ausgabe-Dateien generieren

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.