Nov 12, 2014 Tag: ReST

Techniques in this Blog

Updated on Feb 06, 2015

Attention: THIS POST IS UNDER CONSTRUCTION!

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

doctools.js

2015-02-05
At the time being doctools.js has a bug: bug report

So we run a sed command in Makefile to disable a function:

@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();

And: See Marc’s blogpost about this!

2015-02-06
Wow, that went fast: The bug is already fixed.

Comments

comments powered by Disqus

Previous topic

TYPO3-Camp Rhein-Ruhr 2014

Next topic

T3DocTeam

Tags

Archives

Languages

Recent Posts

This Page