css - Eclipse 中 Javadoc 的自定义样式

Question

我发现我可以在 Eclipse 中向 Javadocs 添加一些 CSS 样式，从而为内联代码悬停创建一些不错的效果。

示例 javadoc:

/**
 * <p>This is a general description of the class.<p>
 * 
 * <p>Here is a useful direct quote:</p>
 * 
 * <div style="background-color:white; border: 1px solid gray; margin: 1em 2.5em; padding: 0em 0.5em">
 *   <p>This quote has a list:</p>
 *   <ul>
 *     <li>Item 1</li>
 *     <li>Item 2</li>
 *   </ul>
 * </div>
 *
 */
public class SSCCE {

}

示例结果:

我想在我的代码中更多地利用它，但如果我可以使用像 <div class="box"> 这样的东西会更好而不是手动设置样式属性，原因如下:

1. 如果我以后决定调整样式，我可能不得不更改数百条 Javadoc 注释
2. 目前，我只关心 Eclipse 中的外观。但是，如果我曾经将 Javadoc 导出到 HTML，我可能希望 HTML 版本具有与 Eclipse 版本不同的样式。

是否可以在 Eclipse 中执行此操作，或许使用插件？

Answer 1

通过实验我发现我可以使用 <link> 链接到样式表带有 href 的标签相对于 .java 文件位置。这确实解决了问题中提到的#1 问题，但我个人认为它太麻烦了，可能不会使用它。它也没有解决问题 #2(如果有的话，它会使情况变得更糟)。

我仍然乐于接受更好解决方案的建议!我怀疑需要一个 Eclipse 插件才能完全实现我真正想做的事情。

[元素根目录]/src/org/foobar/Foo.java:

package org.foobar;

/**
 * <link rel="stylesheet" type="text/css" href="../../../javadoc.css"/>
 * 
 * <p class="orange">Foo doc, in orange</p>
 */
public class Foo {

}

[元素根目录]/javadoc.css

p.orange {
    color: orange;
}