如何在 reStructuredText (reST) 中编写乘号？答案

【问题标题】：How do I write the Multiplication Sign in reStructuredText (reST)?如何在 reStructuredText (reST) 中编写乘号？
【发布时间】：2011-06-16 08:26:51
【问题描述】：

我正在编写将使用 Sphinx 呈现为 HTML 和 PDF 的 reST 文档。我的源文件是 UTF-8，并且希望我的 HTML 显示为 UTF-8。

写乘号的最佳做法是什么？

即：×，不是x。

我知道我可以将它作为 Unicode 字符插入。如果我在写 LaTeX，我会使用\times。在 HTML 中有&times;。当我使用 Sphinx 渲染所有内容时，简单的 Unicode 是否能够在转换过程中正常运行？即使我渲染成其他更奇特的格式？

我只是想仔细检查一下这不会在某个地方出错。

【问题讨论】：

标签： utf-8 special-characters python-sphinx restructuredtext

【解决方案1】：

事实证明，Sphinx 文档包含了答案，只是我没有读到足够多的内容：

因为最简单的方法包括特殊字符，如破折号或 reST 中的版权标志是直接把它们写成 Unicode 字符，一个必须指定编码。狮身人面像假定要编码的源文件默认为 UTF-8；你可以改变这个使用 source_encoding 配置值。

https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#source-encoding

编辑： 只是在这里跟进：虽然乘号工作得很好，但在 LaTeX（以及 PDF）渲染中使用的默认字体中缺少许多其他看似标准的 unicode 符号（小于或等于，大于或等于）。

【讨论】：

【解决方案2】：

要添加到@Paul McMillan 的答案，如果您尝试将 sphinx 文档发布为乳胶 pdf，您通常可以通过在您的 conf.py 序言中包含缺少的 unicode 符号来解决：

_PREAMBLE = r"""
\usepackage[utf8]{inputenc}
\DeclareUnicodeCharacter{00D7}{\times}
"""

latex_elements = {
    'preamble': _PREAMBLE,
}

00D7 是 unicode 编码，\times 是您希望在 Latex 中替换的内容。

您可以在fileformat 网站上找到您角色的 unicode 编码。

更多信息here 和here。

【讨论】：

LaTeX 包 newunicodechar 避免检查 Unicode 代码点：\newunicodechar{×}{\ensuremath{\times}}。

【解决方案3】：

我会在 rst :math:`m \times p` 中使用 MathML

【讨论】：

对于任何中等复杂的事情，这是正确的方法。执行此操作时使用 sphinx.ext.mathjax 扩展名。

【解决方案4】：

使用.. include:: <isonum.txt>后|times|有什么问题？

来自http://docutils.sourceforge.net/0.6/docutils/parsers/rst/include/isonum.txt：

.. |sup2|   unicode:: U+000B2 .. SUPERSCRIPT TWO
.. |sup3|   unicode:: U+000B3 .. SUPERSCRIPT THREE
.. |times|  unicode:: U+000D7 .. MULTIPLICATION SIGN
.. |trade|  unicode:: U+02122 .. TRADE MARK SIGN
.. |uarr|   unicode:: U+02191 .. UPWARDS ARROW

【讨论】：