Python 在Sphinx中选择图像扩展

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

我试图使用

only

指令来选择要包含在不同版本的文档中的图像，如下所示：

.. only:: latex

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

.. only:: html

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

---

然后我用

makecleanpdflatexhtml

编译它，但是Sphinx在两个版本的文档中都使用了PDF图像。有什么想法吗？

您可以通过以下方式使后端自动使用支持格式的图像：

从上文链接的Sphinx文档中：

然后，Sphinx搜索与提供的模式匹配的所有图像，并 确定其类型。然后，每个构建者从中选择最佳图像 这些候选人

---

您可以通过以下方式使后端自动使用支持格式的图像：

从上文链接的Sphinx文档中：

然后，Sphinx搜索与提供的模式匹配的所有图像，并 确定其类型。然后，每个构建者从中选择最佳图像 这些候选人

---

这种行为是新的吗？我已经按照你的建议做了，但是斯芬克斯仍然只搜索PDF图像。我有狮身人面像的最新版本，但是我的Makefile比较旧，尽管…非常奇怪。听起来像是某种缓存问题。如果将扩展名设置为

svg

而不是

*

，HTML输出是否良好？否，它仍会查找PDF文件。为了记录，我使用了

makecleanthtmllatexpdf

，所以所有以前的文件都被删除了。问题解决了，答案被接受。这是做我想做的事的正确方法。谢谢。这是新的行为吗？我已经按照你的建议做了，但是斯芬克斯仍然只搜索PDF图像。我有狮身人面像的最新版本，但是我的Makefile比较旧，尽管…非常奇怪。听起来像是某种缓存问题。如果将扩展名设置为

svg

而不是

*

，HTML输出是否良好？否，它仍会查找PDF文件。为了记录，我使用了

makecleanthtmllatexpdf

，所以所有以前的文件都被删除了。问题解决了，答案被接受。这是做我想做的事的正确方法。非常感谢。

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