4

Sphinx で一連の reST ファイルとして作成されたドキュメントにいくつかの画像があります。私はそれらをかなり小さくしておくことを好み、ユーザーがそれらをクリックして大きな画像を取得できるようにしたいと考えています。画像が小さいのは、ファイル サイズの理由ではなく、表示上の理由によるものです。image:タグorfigure:ref:orと組み合わせる構文上の方法が見つかりませんlink:

.. image:: _static/my_image_small.png

そして、同じフォルダーに大きなバージョンがあります: my_image_large.png.

解決策を思いついた場合、大きな画像はそれへの明示的なリンクを含むファイルである必要がありますか、それとも image: タグを追加して reST ファイルを作成する必要がありますか? 別の方法として、reST ファイルの画像サイズを変更することもできますが、それでも小さい画像から大きい画像へのリンクを作成する方法がわかりません。Sphinx ジェネレーターをバイパスして、必要な HTML を提供する方法はありますか?

4

1 に答える 1

8

2 つの方法があります。

1 つ目は、「生の」HTML を少し挿入するだけです。

.. raw:: html

    <a href=....><img src=....

2 つ目は、画像をクリック可能にすることです。そうすれば、それをより大きな画像にリンクできます。

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

ところで、あなたが与えることができるより多くのオプションがあります。完全なリストについては、再構成されたテキスト ドキュメントを参照してください。

于 2012-12-04T20:32:28.547 に答える