Techniques in this Blog¶

Stuff¶

Ablog

ist eine Sphinx-Extension

Postprozessor

Wir haben einen PP laufen html_build_postprocess.py

Directive ‘class’

heißt in Sphinx ‘rst-class’

ul list .q-and-a

Macht eine dl, bei der die DD eingerückt sind und ein Button werden

Image directive

Wenn wir ‘((title))’ in den Alt-Text schreiben, wird dies entfernt und ein Title-Tag eingefügt mit dem Wert des Alt-Attributes eingefügt.

Sprache

Die Sprache der Seite richtet sich nach dem :language: de aus den Seitenmetadaten. Eigene Directive langpp

Images directive

Zur Anzeige von Bildgalerien.

Alle Ordner files

werden an die gleiche Stelle in den Ausgabe-Dateien kopiert.

Das Protokoll

RESOLVEME:// verhindert, das Sphinx selbst die Bilder verschiebt.

((title)) im Alt-Attribute

Bedeutet, dass der Alt-Text auf für das Title-Attribut verwendet wird. ((title)) wird entfernt.

Allen Links auf externe Webseiten wird ein target="_blank" hinzugefügt.

Workaround¶

@echo "... bugfixing _static/doctools.js"
sed --in-place 's/  this.fixFirefoxAnchorBug();/\/\/this.fixFirefoxAnchorBug();/' _build/html/_static/doctools.js

# in doctools.js
# old:
#      this.fixFirefoxAnchorBug();
# new:
#    //this.fixFirefoxAnchorBug();