问在Sphinx中创建LaTeX数学宏

EN

啊哈，我找到了一个使用Sphinx pngmath扩展的解决方案。这是Sage (开源数学软件)使用的技巧；灵感来自http://www.sagemath.org/doc/reference/sage/misc/latex_macros.html。

要将自己的Latex宏添加到Sphinx文档中，请执行以下操作：

1)创建一个包含宏(每行一个)的文件，名为“latex_MACROS.STY”，并将其放在与Sphinx conf.py文件相同的目录中；

2)将以下代码添加到您的Sphinx conf.py文件中：

# Additional stuff for the LaTeX preamble.
latex_elements['preamble'] = '\usepackage{amsmath}\n\usepackage{amssymb}\n'

#####################################################
# add LaTeX macros 

f = file('latex_macros.sty')

try:
    pngmath_latex_preamble  # check whether this is already defined
except NameError:
    pngmath_latex_preamble = ""

for macro in f:
    # used when building latex and pdf versions
    latex_elements['preamble'] += macro + '\n'
    # used when building html version
    pngmath_latex_preamble += macro + '\n'

#####################################################

如果您使用的是MathJax，这里有一个可能的解决方案。我仍然在寻找一个更好的解决方案，但如果你需要一个快速的解决方案，它可能会有所帮助。

1. 在html_static_path配置选项中指定的目录(通常是_static)下创建一个文件，比如mathconf.js。这将包含MathJax的JS配置。例如(从MathJax documentation)粗体({ TeX：{宏：{ RR：'{\bf R}'，粗体：'{\bf #1}'，1 })；

您可以按照上面的语法添加更多命令。显示的内容定义了宏\RR和\bold{#1}，最后一个宏接受一个参数。

• 在_templates目录下添加一个layout.html文件。这个想法是为了扩展当前主题，因此它会搜索之前的MathJax配置文件。因此，其内容是：

{% extends "!layout.html“%} {% set script_files = script_files + "_static/mathconf.js”%}

请注意，在本例中，它是_static目录，因为在本例中，它指的是在构建之后搜索的位置。Sphinx会将文件从html_static_path移动到构建目录下的_static目录。

如果您使用的是pngmath扩展，则可以通过将以下内容插入到conf.py脚本中来将其放入前言：

pngmath_latex_preamble = r"\newcommand{\cG}{\mathcal{G}}"