在Sphinx中选择图像扩展名

Question

我目前正在使用Sphinx为我的Python包编写文档。我有我想要使用的矢量图像，但HTML文档只接受SVG，而PDF文档仅适用于PDF文件。没问题，我有两个版本的图片。

我正在尝试使用only指令来选择要包含在我的文档的不同版本中的图像，如下所示：

.. only:: latex

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

.. only:: html

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

然后我用make clean pdflatex html编译它，但Sphinx在文档的两个版本中都使用了PDF Image。有什么想法吗？

Answer 1

您可以使后端自动使用replacing the image filename extension with an asterisk所支持格式的图像：

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

从上面链接的Sphinx文档：

  

然后，Sphinx会搜索与提供的模式匹配的所有图像   确定他们的类型。然后每个建筑师选择最佳图像   这些候选人。