Eclipse JavaDoc乳胶方程

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

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

不幸的是，MathML非常冗长。一行简单的乳胶变成50行MathML！它把我的源代码弄得乱七八糟，而JavaDoc注释在源代码中是不可读的（您必须将鼠标悬停在方法上才能读取注释）

有人知道在Eclipse中使用LaTeX方程的方法吗？它将在悬停文本中显示出来

---

编辑：类似的内容更可取，但这在Eclipse的悬停中不起作用。大概没有办法将JavaScript注入其中。

您可以尝试

LaTeXlet

看看：

LaTeXlet是一个taglet，允许在Javadoc注释中使用LaTeX

以下是一个例子：

---

建议1：使用MathJax

我使用MathJax在JavaDoc中编写LaTeX方程。您可以在此处看到结果：

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

要启用MathJax，只需在docket配置中包含一个头，如

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

]]>

建议2：在本地计算机上使用CLSI

---

如果您只需要自己使用它，您可以运行（公共latex服务接口）。然后，可能只是在URL中有一个带有latex代码的图像标记（返回图像）。我没有详细说明这一点。。。（就我个人而言，我更喜欢选项1，因为它也会在JavaDoc中生成LaTeX。

Eclipse禁用了悬停中的JavaScript，因为它具有恶意攻击的潜力。我不知道您是否可以有选择地重新启用它。这似乎是最简单的选项。我也尝试过这个选项，但找不到方法让它显示在Eclipse的悬停中。你能确认它显示在悬停中，并解释如何配置Eclipse在悬停中使用taglet吗？正如在文章中所指出的，我确实尝试过。但是，我对JavaDoc注释中LaTeX的可读性非常不安。应该注意的是，我使用的代码使用了Eclipse JavaDoc hov呃，非常重要，但目前不使用HTML JavaDocs。同样，复杂的公式在LaTeX中仍然有点难以读取（尽管比MathML好）。我正在考虑的一个“解决方案”是将LaTeX转换为图像，并将该图像包含在JavaDoc中（Eclipse将显示图像），其中LaTeX代码作为图像的alt文本（便于将来更新图像）我真的更喜欢一种直接从JavaDocs自动生成图像的方法。MathJax就是这么做的。动态转换。如果你在预处理中转换它，你会有一个难看的图像标签，而且-我假设你也喜欢保留乳胶进行编辑-原始乳胶。我相信这是正确的可以在Eclipse悬停中启用JavaScript处理，并以这种方式解决问题。是的，但问题是如何在Eclipse的悬停中显示图像。我已经尝试过MathJax，Eclipse不会在悬停中执行JS。这只适用于HTML输出（我没有使用）。我在回答中添加了CLSI，这可能有助于创建该映像（例如，通过类似REST的服务器）。