使用 LaTeX 重构文本中的数学

Question

我想使用轻量级标记语言在大学课程中做笔记。

我选择的编辑器是 gedit，我找到了 reStructuredText Tools for Gedit，它将运行reStructuredText 处理器并在 gedit 的窗格中呈现 HTML。这太棒了，已经完成了 80%。

但对于我的许多课程，我需要在笔记中包含数学方程或希腊字符。虽然我对LaTeX不是很熟悉，但我的理解是它有这些能力。

如何在 reST 文档中使用 LaTeX？ reST 文档是否需要处理成 LaTeX，然后渲染成 HTML，还是有更好的方法？ Markdown 会让这变得更容易吗？如果需要的话我可以修改 gedit 插件。

最后，有人这样做吗？对于在纯文本编辑器中记课堂笔记还有其他建议吗？

谢谢！

Answer 1

LaTeX 和 ReST 是同一问题（整个文档标记）的两种解决方案，我不确定其中一个是否会高兴地生活在另一个中。

• 首先是 LaTeX，然后是 ReST：LaTeX 需要精确定位印刷元素，以便布置方程（以及其他所有内容）。 ReST 不会将 LaTeX 输出（PostScript 或类似的）作为输入。
• 首先是 ReST，然后是 LaTeX：您必须为 ReST 编写一个输出格式化程序来输出 LaTeX 代码，并在 ReST 中定义扩展以防止它误解您的方程或其他显式 TeX。 LaTeX 的输出仍然类似于 PostScript 或 PDF。

我见过使用 TeX 的子集生成图形方程的代码，然后将其提取到 HTML 或类似的代码中（例如，Trac 的 LaTeX Formula 宏），这可能是最好的可用解决方案。

Answer 2

稍微分解一下你的问题，第一个目标是将乳胶代码逐字输出（除了<，>，蚀刻的cgi转义）到从你选择的轻标记生成的html中：一旦你有了它，它可以很容易地通过 mathJax （强烈推荐）或 itex 正如 gozzilli 提到的。

首先我应该说，使用 markdown 而不是 ReST 可能会更容易，因为 ReST 使用 \ 进行转义，因此所有 LaTeX 都必须受到保护。有关使用 markdown 和 mathJax，去 mathoverflow.net 尝试设置。

尽管如此，我会假设您确实想要 ReST （和 mathJax） ，在这种情况下有两种方法：使用库存 ReST （和繁琐的转义），或者向 docutils 添加一些 LaTeX 处理程序。

选项 1 - Stock ReST：

对于内联数学，只需逐字加上您标记后处理器正在寻找的任何内容：“$x<\pi$”。对于多行数学，您需要一个文字块，但您需要为例如 MathJaX 设置一个类属性来解析它，否则它会跳过

 标签：

.. class:: mathjax_process

::

  \begin{equation}
    x<\pi
  \end{equation}

选项 2：扩展您的 ReST 处理器

如果您愿意做一些修改来扩展您的 ReST 处理器，您可以通过定义自定义解释文本 内联乳胶的角色（例如 :latex:`x<\pi` ）和用于多行数学的自定义 指令，例如

.. latex::

  \begin{equation}
    x<\pi
  \end{equation}

内联数学如果您使用 默认角色。

有多种方法可以实现角色和指令。我已经（大致）得到了以下内容，它具有一个很好的功能，即（与我见过的大多数其他黑客不同）它对于没有集成后期处理的编写者来说会降级为文字 LaTex 代码。

from docutils import nodes, utils
from docutils.parsers.rst import directives, Directive 

class Latex(Directive):
    """ Latex directive to display LaTeX as escaped literal wrapped in
        <pre class="latex">. 
    """
    required_arguments = 0
    optional_arguments = 0
    has_content = True
    def run(self):
        self.assert_has_content()
        prenode=nodes.literal_block(self.block_text,
                                    '\n'.join(self.content),
                                    classes=['latex'])
        return [prenode]
directives.register_directive('latex', Latex)

def latex_role(role, rawtext, text, lineno, inliner, options={}, content=[]):
    node = nodes.literal(rawtext,
                         '\(%s\)'%utils.unescape(text, 1),
                         classes=['latex'])
    return [node],[]
register_local_role('latex', latex_role)

上面将使用“latex”类来标记要处理的内容，因此您需要配置 mathJax或相当于寻找此类。或者，更改上面的代码以将类设置为“mathjax_process”，这是默认的 mathJax 覆盖类。

Answer 3

问题是 reST 并没有真正的插件。您可以选择可扩展的框架，例如 Sphinx；已包含 JSMath 的插件，以及 MathJax 也是可能的。此外，Sphinx 使用 LaTeX 直接构建 PDF 文档。

另一个更轻量级的解决方案包括编辑 reST 模板以包含 MathJax，以便您可以在文档中使用 MathJax 的（类似 LaTeX）语法。

但通常我只是直接使用 LaTeX 来处理任何重要的事情 - 这些轻量级标记语言的定制功能对于所有事情来说都不够全面。

Answer 4

此项目来自 Docutils FAQ 描述了一种相对容易地包含 TeX 数学的方法。您首先为解释文本定义一个角色，将方程直接传递到 LaTeX：

.. role:: raw-latex(raw)
    :format: latex

然后您可以在文本中使用该角色

The area of a circle is :raw-latex:`$\pi r^2
此项目来自 Docutils FAQ 描述了一种相对容易地包含 TeX 数学的方法。您首先为解释文本定义一个角色，将方程直接传递到 LaTeX：
.. role:: raw-latex(raw)
    :format: latex

然后您可以在文本中使用该角色

。常见问题解答条目还提到了其他一些方法来执行此操作，包括可用于渲染文本的预处理器方法。生成 HTML 时对图像进行数学运算。

Answer 5

Pandoc 的 Markdown 扩展允许内联或显示 LaTeX 数学；您只需将它放在（紧邻的）美元符号之间，如下所示： $\sqrt{-1}$ ，它就会按照您的预期进行处理。我一直在使用这个功能，并且认为它一点也不实用。请参阅手册 http://johnmacfarlane.net/pandoc/README.html#math

一旦解析了 Markdown，pandoc 就可以编写 HTML、LaTeX、ReST、RTF、DocBook、ODT、手册页等。如果 LaTeX 数学上下文不涉及花哨的 LaTeX 包，它甚至可以将数学解析为 MathML，因此它立即以 HTML 或 RTF 格式呈现。 （它提供了许多用于处理非 LaTeX 文档中的 LaTeX 数学的选项。）

Pandoc 还解析 ReST（和 HTML，以及不太花哨的 LaTeX）。因此，我希望给出一个涉及 ReSt 阅读器的解决方案，但它似乎没有特殊的机制来处理数学；请参阅问题 249 的讨论 http://code.google.com/ p/pandoc/issues/detail?id=249 我再仔细研究一下看看。

我认为还没有人为 Gedit 编写出 pandoc 插件（我知道，emacs 和 TextMate 中有详细的支持）——那太棒了！

Answer 6

请注意，0.8 版的 docutils（解析 reStructuredText）支持 LaTeX 数学。请参阅http://article.gmane.org/gmane.text.docutils.user/ 6255 有很多例子。 “--math-output”选项的选项有：MathML、HTML、MathJax 和 LaTeX。

Answer 7

使用 rst2mathml.py 代替 rst2html。

它使用乳胶数学模式扩展了 docutils。该模式的内容被转换为MathML。

Answer 8

为了扩展之前的答案，这就是我如何让 MathJax 与 ReST 和 Docutils 一起使用，而不需要 LaTeX：

1. 使用 LaTeX-我的 ReST 源中的数学样式，例如：

   雷达后向散射系数为$\sigma^0$。
   

2. 将其包含在文件中的某处（我将其放在底部）：

   <前><代码>.. raw:: html

   <脚本类型=“text/x-mathjax-config”>
   MathJax.Hub.Config({
   扩展名：[“tex2jax.js”]，
   jax：[“输入/TeX”，“输出/HTML-CSS”]，
   tex2jax：{
   inlineMath: [ ['$','$'], ["\\(","\\)"] ],
   显示数学：[ ['$$','$$'], ["\\[","\\]"] ],
   进程转义：true
   },
   "HTML-CSS": { availableFonts: ["TeX"] }
   });
   
   <脚本类型=“text/javascript”src=“http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML”>

3. 转换为 HTML：

   rst2html 报告.rst 报告.html
   

4. 在现代浏览器中加载 HTML。 MathJax 脚本将被下载并在查看时应用于 HTML。一切对我来说看起来都很棒！

非常感谢 http://www.thales.math.uqam.ca/ ~labbes/Sage/rst2sws/ 寻求帮助！

更新：我注意到虽然输出的 HTML 在 Firefox 中运行良好，但 MathJax 在 Chrome 中运行需要很长时间，然后会出现错误。 更改

我通过将最后一行中的脚本源从src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"

为

src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"。

我相信原因是 FireFox 支持 MathML，而 Chrome（实际上是 Webkit）尚不支持（至少不完全支持；您可以测试浏览器的支持 此处）。

因为我不需要 MathML，只需要 TeX，所以我使用相应的 MathJax 版本，现在它可以在 Chrome 中快速加载，没有任何错误。此外，使用 TeX 风格输入数学比使用 MathML 风格输入要快得多。

Answer 9

从版本 0.8 开始，它就得到了原生支持：您不应该再使用任何解决方法。语法也非常简单。它与乳胶数学相同，但没有封闭的 $$

因此您可以简单地为数学块编写以下内容

.. math::

   \frac{ \sum_{t=0}^{N}f(t,k) }{N}

或者如果您想内联编写，您可以使用它：

:math:`\frac{ \sum_{t=0}^{N}f(t,k) }{N}`

注意那里的分隔反引号。

---

注意：如果您在第一个文档字符串中使用乳胶表示法，则需要使用数学元素的双反斜杠对反斜杠进行双重转义，因此它是 \\frac 而不是 \压裂

Answer 10

对“数学”角色和指令有原生支持
（使用 LaTex 输入语法）自版本 0.8 (2011-07-07) 起。

Answer 11

这就是我所做的：

1. 在 reST 文档的开头添加数学角色：

   .. 角色:: raw-math(raw)
       :format: Latex html

2. 像这样写下你的数学

   :raw-math:`$ \frac{s}{\sqrt{N}} $`

   （如果您希望将其放在块中，请使用 $$ ... $$；如果您希望将其内联，请使用 $ ... $。）

3. < p>生成如下 html 输出：

   rst2html --stylesheet=/path/to/my_beautiful_stylesheet.css my_file.rst \
   |整洁-q | /path/to/itex2MML > my_file.xhtml

   这会使用 rst2html 生成 html，使用 tidy 进行整理，然后使用 itex2MML 将乳胶数学转换为 MathML，并在 xhtml 上输出文件。

注意：

1. 样式表是可选的
2. 对于itex2MML，请前往此处。
3. html 文件的扩展名应该是 xhtml 或 xml，否则数学将不会显示在浏览器中。