Sphinx automatisierte Bild Nummerierung / Bildunterschriften?

Question

Gibt es eine Möglichkeit automatisch ein Bild / Bildunterschrift mit Sphinx zu generieren?

Im Moment habe ich rest-Sphinx-Dateien Ich bin Umwandlung in HTML und (Latex) pdf mit Sphinx.

Ich mag eine einfache Möglichkeit für Benutzer ein bestimmtes Bild in den resultierenden HTML / PDF-Dateien verweisen. Zum Beispiel, wenn ein Benutzer in einer E-Mail an die Dokumentation beziehe, „In‚Bild 65‘, sagt er XXX, aber das ist für mich nicht funktioniert“.

Ich habe versucht mit Figur wo es erscheint zu ermöglichen, eine Beschriftung auf ein Bild anwenden, hat aber diese manuell hinzugefügt werden. (Und ich habe Probleme bekommen es aus irgendeinem Grund mit Substitution zu arbeiten).

Gibt es eine Rest-Sphinx Methode, die ich mit Blick auf bin das würde dies erreichen? Oder gibt es eine Möglichkeit / ändern bearbeiten Sphinx vorhandenen Vorlagen diese Fähigkeit hinzufügen?

Answer 1

Sphinx verbraucht reStructuredText als Templat von Jinja . obwohl nach der Sphinx-Dokumentation Sie haben andere Templat Optionen .

Es sollte möglich sein, die verwenden Jinja Kontrollstrukturen in einer benutzerdefinierten Vorlage den Effekt sind Sie nach zu erreichen.