sphinx: 通过 raw:: latex 包含 .eps 图片

Question

我想在sphinx中插入一个eps格式的图片，使用的是raw:: latex这个命令。我想要的效果大概是这样的：

.. raw:: latex

    \includegraphics[width = 100mm, height = 100mm]{example.eps}

运行sphinx-build命令的时候一切都很顺利，但奇怪的是，..raw:: latex这个部分在生成的html文件中完全被忽略了。请问我漏掉了什么吗？

我需要在docutils.conf文件中启用这个raw命令吗？我在/etc目录下找不到这个文件。

Answer 1

“raw”指令只对指定的输出格式有效。所以，当你生成HTML时，.. raw:: latex这个指令会被忽略。

你可以指定多个输出格式，比如.. raw:: latex html，但这也没什么用：内容会原封不动地写入输出文档，而LaTeX命令在HTML中是不能用的。

如果你想在HTML中使用矢量图像，建议把它转换成SVG格式。