Kategorie: Anleitungen
- Asciidoc mit Docker bauen
Sie müssen nicht für jedes Output-Format des Asciidoctors ein Extra-Tool installieren. Sie brauchen eigentlich nur ein Docker-Image nutzen, egal welchen Output Sie aus Ihren adoc-Dateien generieren wollen.
- Verification of your Subdomain for a gitlab Project
You have a project on gitlab with the URL myname.gitlab.io/project and would now like to redirect your subdomain www.myname.com to your project in addition to your root domain myname.com.
- DITA-XML mit VS Code validieren
Um Visual Studio Code als Quelltext-Editor für DITA-XML-Dateien mit allen Annehmlichkeiten wie z.B. der Validierung nutzen zu können, müssen in den Einstellungen des Programms, genauer in der settings.json, drei Einträge vorgenommen werden.
- Admonitions in Markdown
In Markdown gibt es keine Möglichkeit, farbig umrahmte Absätze für Hinweise, Warnungen, Infos und Tipps zu gestalten. In Hugo bietet sich aber diese Möglichkeit durch sogenannte Shortcodes.
- Templates nutzen in FrontMatter CMS
Bisher habe ich meine Asciidoc- und Markdown-Dateien in VSCode erstellt. Das macht aber nicht so viel Spaß. Nun habe ich das Headless-CMS FrontMatter entdeckt. Statt zu tippen klicke ich jetzt auf Schaltflächen.
- Hugo - Link im neuen Tab öffnen lassen
In Markdown kann man standardmäßig nur Links zu Webseiten erstellen, die im selben Tab öffnen, nicht jedoch in einem neuen Tab geöffnet werden mit Hilfe des Attributs target="_blank".
- Hugo CMS mit Asciidoc auf Linux installieren
Seitdem ich von Windows auf Linux Fedora gewechselt bin, habe ich es versäumt, mir einen lokalen Hugo-Server zu installieren. Nun habe ich das nachgeholt: Mit dem Ergebnis, dass ich mir meine Blogposts vorher lokal anschauen kann, bevor ich sie mit Netlify auf Github veröffentliche.
- Tagesnotiz - Wieviel Tage sind schon um?
Um mir vor Augen zu führen, wie schnell die Zeit vergeht und wie viel Zeit mir noch verbleibt, meine Ziele für das Jahr zu erreichen, blende ich mir in Obisidian die Nummer des Tages und der Woche im Header meiner Tagesnotiz ein.
- Einen Habit-Tracker mit Obsidian erstellen
Statt Zettelkasten und meinen Roman zu schreiben, erstelle ich mit Obsidian einen Habit-Tracker. Das Prokrastinieren wird durch Obisidian auf eine ganz neue Ebene gehoben.
- DITA-Output mit Docker builden
DITA-Output ohne lokale DITA-OT-Installation: erst mit dem Standard-Image, dann mit dem Bootstrap-Plugin, schließlich mit einem eigenen, angepassten Plugin aus Git.
- Antora lokal installieren
Antora ist so etwas wie ein Static Site Generator für Technische Redakteure. Der Content wird in Asciidoc geschrieben und kann sich in verschiedenen Git-Repositorys befinden.
- Hugo mit Asciidoc - Webseite mit Netlify bereitstellen
Solange man als Blogger nur wenige Artikel hat, kann man den Hugo-Ordner public via FTP auf den Webserver kopieren. Werden es mehr Blogposts, werden Dienste wie Netlify unausweichlich.
- Hugo mit Asciidoc - Auf anderen Post verlinken
Wenn ich im CMS Hugo statt Markdown Asciidoc nutze, wie kann ich dann auf einen anderen Beitrag verlinken?.
- Hugo mit Asciidoc - Bilder einbinden
Leider ist eine Selbstverständlichkeit wie das Einbinden von Bildern in der Kombination Hugo/Asciidoc etwas speziell. Das Markup ist Asciidoc, welches mit Asciidoctor in HTML umgewandelt wird. Nun hat aber das Hugo-CMS seinen eigenen Mechanismus, der mit Markdown auch wunderbar funktioniert.
- Asciidoctor auf Windows einrichten
AsciiDoc ist eine vereinfachte Auszeichnungssprache ähnlich Markdown, die dazu dient, Texte in verschiedenen Dokumentenformaten zu veröffentlichen. Asciidoc wurde speziell für die Technische Dokumentation entwickelt und wird in vielen Git-Portalen als Dokumentationsstandard genutzt. Es hat jedoch nicht die Möglichkeiten der Wiederverwendung wie DITA-XML. Neuer Rechner, neuer Doktor: wie muss ich ihn installieren? Jetzt schreibe ich es auf, denn ich vergesse es jedes Mal.
- Einbinden der DITA-DTDs in Eclipse
Eclipse eignet sich gut als Quelldateien-Editor. Damit die DITA-Dateien validiert werden können, gilt es, die DTDs einzubinden.
- Eine Homepage mit Asciidoctor erstellen
Für längere Texte und Anleitungen hatte ich bisher viele CMS genutzt: Wordpress, Kirby, Hugo und Known. Doch keines der CMS kannte ein Austauschformat. Jeder Text wurde in die jeweilige Datenbank abgelegt. Mit jedem Umzug gingen Texte verloren. Nun brachte Tom Swan mich auf die Idee, es mit Asciidoc zu versuchen. Hier die wichtigsten Schritte.
- Indiewebify my Hugo-Site
Mit Hilfe eines kleinen Services von Pelle Wessmann namens https://webmention.herokuapp.com/ ist es mir auf meiner statischen Hugo-Seite möglich, Kommentare, Likes, Reposts u.ä. via Webmentions einzusammeln.
- Schusterjungen im PDF-Output des DITA-OT vermeiden
Das DITA Open Toolkit ist ein Open Source Tool für das Generieren von Ausgabeformaten für Inhalte, die mittels DITA XML erstellt wurden. Es kommt öfter vor, dass sich der Seitentitel und die Kurzbeschreibung (shortdesc) als letzte unten auf einer PDF-Seite wiederfinden und der Textkörper erst auf der nächsten Seite folgt.