数学表达式Sphinx/imgmath的解析

Question

我正在使用sphinx.ext.imgmath在Python项目文档中包含数学表达式。它正在工作，但是产生的图像的分辨率很低。如何使其产生更高分辨率的图像？你知道吗

Answer 1

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

imgmath_image_format = 'svg'

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

imgmath_font_size = 14  # for font size 14

如果您真的需要png，那么您可以覆盖dvipng应用程序的默认设置，该应用程序由imgmath使用。conf.py的相应变量是

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

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

总之，我建议使用svg。：-）