Ein neues Handbuch in AsciiDoc
Teil 6
Ich mag es gar nicht sagen oder gar schreiben; in diesem Projekt hat mich die Wirklichkeit eingeholt. Ich habe auf das Datum des letzten Blogeintrags geschaut und mich sehr erschrocken: 14. Januar 2022.
Ich will ehrlich sein, seit dem Datum habe ich auch nicht ganz viel am neuen Handbuch geschrieben. Natürlich habe ich das Problem schon vor einigen Monaten erkannt und sogar versucht Lösungen zu finden. Aber leider hat alles nicht so recht funktioniert und ich habe eingesehen, dass ich Unterstützung brauche.
Also habe ich mich mit Antoni zusammengesetzt – mit dem ich bereits schon das Merlin 2 Buch für den Hanser Verlag geschrieben habe – und wir haben das Projekt neu aufgesetzt. Ich weiß, dass es peinlich ist. Aber manchmal muss man ein Problem erkennen und lösen, auch wenn man selbst das Problem ist.
Ich hoffe, dass wir nun gemeinsam im ersten Halbjahr 2023 mit dem Buch in deutscher Sprache fertig werden, so dass es dann peu à peu in andere Sprachen übersetzt werden kann.
Thema AsciiDoc
Am Projekt selbst ändert sich nichts, da Antoni unseren kleinen Zauberer wie aus dem ff kennt. Auch die Markup-Sprache AsciiDoc bleibt gesetzt. Schließlich schreibt Antoni – wie alle anderen bei ProjectWizards auch – seit ca. 2012 in diesem Dialekt.
Trotzdem muss man hin und wieder mal die Syntax nachschlagen. Hier hat sich der Hilfe-Modus von Asciidoctor als sehr hilfreich erwiesen.
Geben Sie im Terminal folgendes ein:
asciidoctor --help syntax
als Ausgabe erhalten Sie eine Hilfe-Seite in AsciiDoc-Notation. Diese Seite können Sie sogar direkt zu HTML konvertieren:
asciidoctor --help syntax | asciidoctor -o syntax.html -
Tipp: Der "-" am Ende der Zeile setzt die Ausgabe auf die Standardausgabe (STDOUT).
Das Ergebnis ist eine HTML-Seite, die so aussieht.
Nun können Sie noch einen Open-Befehl anhängen:
asciidoctor --help syntax | asciidoctor -o syntax.html - && open syntax.html
So wird die Seite sofort im eigenen Browser angezeigt.
So, nun wollen wir mal schauen, wie wir in den nächsten Wochen vorankommen.
In diesem Sinne – bis zum nächsten Mal …
