javadoc html ファイルに mathML ファイルを含めるためのカスタム タグレットを作成しています。すべての *.mml ファイルを同じフォルダーに保存したいと考えています。
{@docroot}/doc-files
フォルダ。私の質問は: Taglet オブジェクト内 (より具体的には、メソッド内) で @docRoot 文字列の値を知るにはどうすればよいtoString(com.sun.javadoc.Tag tag)
ですか? どうもありがとう!
また、Javadoc に MathML を表示する必要もありました。ここでどのように解決したかについてのブログ投稿を書きました: http://chadretz.wordpress.com/2010/12/19/mathml-inside-javadoc-using-mathjax-and-a-custom-taglet/
ただし、より具体的には、私がそこに投稿した Taglet ソース コード (デフォルトでは折りたたまれている) を見ると、Tag.holder() のトップ レベルの ClassDoc を取得して、現在のディレクトリの深さを取得する場所がわかります。上にトラバースできます。これは、相対 HTML ルートが必要な場合に役立ちます。Taglet の実行中に MML の場所を知る必要がある場合は、それらをクラスパスに配置し、リソースとしてアクセスすることをお勧めします。
@ChadRetz のブログgetPackageDoc
の関数から始めて、あなたが望むことを行う関数を含むユーティリティ クラスを作成しました。ディレクトリ -- これは.com.sun.javadoc.Tag
{@docRoot}
クラスは と呼ばれComSunJavaDocUtil
、関数名はgetRelativeUrlToDocRoot
です。
タグレットのtoString()
関数の例:
public String toString(Tag tag) {
return "Relative url to DOC ROOT for this tag's enclosing file is \"" +
ComSunJavaDocUtil.getRelativeUrlToDocRoot(tag) + "\"";
}
このユーティリティ クラスはCodeletの一部です。インストール手順はこちらです。このユーティリティ クラスだけを使用する場合、クラスパスに必要な jar は...codelet
そしてxbnjava
もちろんcom.sun.javadoc
.