Sphinxで画像の拡張子を選択

Question

現在、私はPythonパッケージのドキュメントをSphinxで書いています。私は使用したいベクターイメージを持っていますが、HTMLドキュメントはSVGのみを受け付けますが、PDFドキュメントはPDFファイルでのみ動作します。問題はありません、私は私の画像の両方のバージョンを持っています。

私はそうのように、私のドキュメントの異なるバージョンに含める画像を選択するonlyディレクティブを使用しようとしています：

.. only:: latex 

    .. image:: ../docs/alpha-strat.pdf 

.. only:: html 

    .. image:: ../docs/alpha-strat.svg 

そして私はmake clean pdflatex htmlでそれをコンパイルしますが、スフィンクスがでPDFイメージを使用しています両方のバージョンのドキュメント。何かご意見は？

Answer 1

あなたはバックエンドが自動的にreplacing the image filename extension with an asteriskによってサポートされている形式の画像を使用することができます：

.. image:: ../docs/alpha-strat.* 

上記にリンクされているSphinxのドキュメントから：

スフィンクスが、その後提供に一致するすべての画像を検索パターンを選択し、 がそのタイプを決定します。各建築業者は、 の候補から最良の画像を選択します。