Sphinx fügt einen Link zu einem Bild oder einer Figur hinzu

Question

Ich versuche etwas Grundlegendes in Sphinx. Ich habe einige Bilder, aber ich bevorzuge es, sie ziemlich klein zu halten, und ich möchte dem Benutzer erlauben, auf sie zu klicken, um das größere Bild zu erhalten. Ich finde keinen syntaktischen Weg zu kombinieren image: oder figure: mit ref: oder link:.

.. image:: _static/my_image_small.png 

und ich habe in dem gleichen Ordner my_image_large.png.

Wenn Sie eine Lösung finden, sollte das größere Bild nur eine Datei mit einem expliziten Link dazu sein oder erstelle ich eine reSt-Datei mit einem zusätzlichen image: Tag? Eine Alternative könnte sein, mit den Bildgrößen in der reSt-Datei zu spielen, aber ich weiß immer noch nicht, wie ich den Link vom kleinen Bild zum großen Bild erstellen soll.

Vielen Dank für Ihre Hilfe.

Answer 1

Verwenden Sie einfach die target Direktive. Sie würden mit etwas wie:

.. image:: _static/my_image_small.png 
    :target: _static/my_image_large.png 

enden Es ist nicht unbedingt notwendig, die Verweise auf den statischen Ordner in Ihrer Quelle zu verwenden. Sie werden trotzdem in den _images-Ordner kopiert, wenn Sie die Dokumente erstellen (Sie haben sie also zweimal in Ihren Builds, ohne sie dort zu benötigen).

Ich benutze immer einen Ordner namens Figuren neben dem Quellordner, wo ich die Bilder verwalte. Die Dateien my_image_large.png möchten Sie jedoch in den Ordner _static stellen, da der Inhalt beim Erstellen kopiert wird.