Skip to main content
 首页 » 编程设计

python之数学表达式的解析 Sphinx/imgmath

2025年01月19日11三少

我正在使用 sphinx.ext.imgmath 在我的 Python 项目文档中包含数学表达式。它正在工作,但生成的图像的分辨率非常低。如何让它生成更高分辨率的图像?

请您参考如下方法:

对于 imgmath,您可以使用 png 或 svg 格式。根据我的经验,默认情况下 svg 具有更好的分辨率。您可以通过定义变量在 Sphinx config.py 中启用它

imgmath_image_format = 'svg' 

您可能需要调整数学字体大小。这可以使用

imgmath_font_size = 14  # for font size 14 

如果您确实需要 png,那么您可以覆盖 imgmath 使用的 dvipng 应用程序的默认设置。 conf.py对应的变量是

imgmath_dvipng_args = ['-gamma', '1.5', '-D', '110', '-bg', 'Transparent'] 

这是默认值。这些是 dvipng 的键值对。 -D表示输出分辨率,它的值为110。你可以调大它,但这样会使整个显示的图像变大。所以你必须摆弄字体大小。对于其他 dvipng 选项,请使用其命令行帮助。

总而言之,我推荐使用svg。 :-)