5

Eclipse の Javadoc に 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 {

}

サンプル結果: Javadoc ホバーの例

コードでこれをもっと活用したいのですが<div class="box">、次の理由により、スタイル属性を手動で設定する代わりに、次のようなものを使用できればはるかに優れています。

  1. 後でスタイルを微調整することにした場合、何百もの Javadoc コメントを変更する必要があるかもしれません
  2. 現時点では、Eclipse 内の外観のみを気にしています。ただし、Javadoc を HTML にエクスポートする場合は、HTML バージョンに Eclipse バージョンとは異なるスタイルを持たせたいと思うかもしれません。

おそらくプラグインを使用して、Eclipseでこれを行うことは可能ですか?

4

2 に答える 2

2

実験を通じて、.java ファイルの場所に関連する<link>タグを使用してスタイルシートにリンクできることを発見しました。hrefこれは質問で言及されている問題＃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;
}
于 2012-12-19T00:22:00.970 に答える
1

スタイル付き JavaDoc としてエクスポートする部分に到達したら、このJava ツールを使用できると思います。また、Eclipse で javadoc のスタイル シートを指定するのに役立つこの本も確認してください。また、独自のドキュメント生成プラグインを作成することになるかもしれません。

于 2012-12-18T21:21:47.460 に答える