Eclipse JavaDoc LaTeX方程式

Question

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

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

不幸的是,MathML 非常冗长.一行简单的 LaTeX成为50行MathML!它使我的源代码混乱,源代码中的JavaDoc注释无法读取(您必须将鼠标悬停在方法上才能阅读注释).

有没有人知道在Eclipse中使用LaTeX方程的方法会出现在这个悬停文本中？

编辑:喜欢的东西这将是可取的,但是这并不在Eclipse的悬停工作.据推测,没有办法在这些中注入JavaScript.

Answer 1

建议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，您只需在文档配置中包含一个标头，例如

                <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（通用乳胶服务接口）。然后，也许可以只使用一个图像标签，其 URL 中包含乳胶代码，该标签会返回图像）。我还没有详细说明这一点...（我个人更喜欢选项 1，因为它也会在 JavaDoc 中生成 LaTeX。