Ich benutze Sphinx, um ein paar Dokumente zu erstellen. Ich habe ein reStructuredText-Dokument und möchte ein Bild einfügen. Der Fall ist, dass das Bild anklickbar sein sollte, sodass, nachdem ein Benutzer auf das Bild geklickt hat, dieses Bild in voller Größe angezeigt werden soll. Ich verwende die image-Anweisung und ihre Zieloption wie folgt:
%Vor%Das Problem ist, dass ich in der gerenderten Seite bekomme:
%Vor% Es gibt also ein korrektes src von der image Anweisung, aber ein falsches href Attribut vom Hyperlink.
Fragen:
Gibt es eine Möglichkeit, Links auf die Art und Weise zu erzeugen, wie es die image-Anweisung tut? Ich meine relativ zu dem Dokument.
Gibt es eine andere (eingebaute) Möglichkeit, ein "Thumbnail- & gt; click - & gt; großes Bild" Verhalten zu haben?
Wenn Sie die Direktive image innerhalb von Sphinx verwenden, führt Sphinx eine spezielle Behandlung durch, um die Bilddatei zu finden und in Ihr Projekt zu kopieren (wie Ihr _images Verzeichnis) und rendert dann den HTML-Code .
Aber die Option target benötigt nur eine URL als Parameter. Es weiß nichts über dein Sphinx-Projekt oder wie deine Bilder angelegt sind und versucht nicht zu raten.
Wenn Sie auf eine größere Version der gleichen Datei verweisen möchten, müssen Sie wahrscheinlich einige manuelle Schritte ausführen (z. B. das Kopieren der Datei an einen bestimmten Speicherort) oder eine relative URL für die große Datei angeben und nicht die absolute URL in Ihrem Beispiel.
Wenn Sie einen komplett anderen Weg einschlagen möchten, können Sie auch versuchen, die HTML-Vorlagen für Ihr Projekt zu überschreiben und zu modifizieren, um etwas JavaScript hinzuzufügen, um den gewünschten Klick-zu-größer-Bild-Effekt zu erzielen.
Sieht so aus, als ob es eine Sphinx-Erweiterung gibt, die das jetzt tut, und ganz nett dazu: sphinxcontrib-fancybox 0.3.2 . Installieren Sie mit pip , fügen Sie es zu Ihren Erweiterungen in conf.py hinzu und verwenden Sie die Direktive fancybox :
Relative Links scheinen zu funktionieren. Wenn für die Mapserver -Dokumentkonfiguration ein Bild im Verzeichnis images gespeichert wird, funktioniert ein relativer Link wie im folgenden Code in meinem lokalen Build. Hier ist ein Beispiel mit figure (der Unterstrich ("_") vor "images" in der Ziel -Link ist notwendig):
Tags und Links image python-sphinx restructuredtext