java - Eclipse JavaDoc LaTeX 方程式

Question

我的代码在 JavaDoc 注释中通常有很多方程式。我目前正在使用 MathML 来显示这些方程式，因为这是我能够获得可以在 Eclipse 的悬停工具提示中显示的方程式的唯一方法。

我实际上并不关心创建的 HTML。我只需要 Eclipse 的悬停即可正确显示方程式。

不幸的是，MathML 非常疯狂冗长。一行 简单 LaTeX 变成 50 行 MathML!它弄乱了我的源代码，JavaDoc 注释在源代码中不可读(您必须将鼠标悬停在方法上以阅读注释)。

有谁知道在 Eclipse 中使用 LaTeX 方程式并显示在悬停文本中的方法吗？

编辑:类似于 this会更好，但这在 Eclipse 的悬停中不起作用。大概没有办法在其中注入(inject) JavaScript。

Answer 1

建议一:使用MathJax

我使用 MathJax 在 JavaDoc 中编写 LaTeX 方程。您可能会在这里看到结果: https://javadoc.io/static/net.finmath/finmath-lib/6.0.12/net.finmath.lib/net/finmath/montecarlo/interestrate/models/LIBORMarketModelFromCovarianceModel.html

但是，MathJax 依赖于 JavaScript，而 Eclipse Hover 不支持 JavaScript。但是我必须说即使没有渲染器也可以读取 MathJax LaTeX，所以对我来说悬停文本中有 LaTeX 代码是可以的。如果您在悬停文本中启用 JavaScript，您会看到它 - 但这是一个不同的问题。

要启用 MathJax，您只需要在您的 docket 配置中包含一个 header ，例如

                <header>
                    <![CDATA[
                    <script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
                    </script>
                    ]]>
                </header>

建议 2:在本地机器上使用 CLSI

如果你只为自己需要这个，你可以运行 CLSI (通用 latex 服务接口(interface))。然后，也许有可能只在其 URL 中有一个带有 latex 代码的图像标签，它返回一个图像)。我没有对此进行详细说明...(我个人更喜欢选项 1，因为它还会在 JavaDoc 中生成 LaTeX。