デフォルトのhtmlの代わりにxml形式でjavadocを生成できるドックレットを探しています。いくつか検索したところ、以前はhttp://www.sun.com/xml/developers/doclet/にあったSunXMLドックレットがあることがわかりました。
ただし、このリンクは機能しなくなりました。Sunxmlドックレットのコピーを持っている人はいますか?または他の代替xmlドックレット?
デフォルトのhtmlの代わりにxml形式でjavadocを生成できるドックレットを探しています。いくつか検索したところ、以前はhttp://www.sun.com/xml/developers/doclet/にあったSunXMLドックレットがあることがわかりました。
ただし、このリンクは機能しなくなりました。Sunxmlドックレットのコピーを持っている人はいますか?または他の代替xmlドックレット?
最後に、 http://jeldoclet.sourceforge.net/から代替のxmlドックレットを見つけました
それは非常に軽量で強力です:)
これがあなたが求めているものかどうかはわかりませんが、SFにはXHTMLDocletというプロジェクトがあります。従来のHTML出力の代わりにXHTMLjavadoc出力を生成することになっています。とにかく、Sunの実装とは何の関係もないのではないかと思います。
あなたはあなたの質問でXHTMLについて言及していなかったので、私はXHTMLがあなたが探しているXMLであるとは確信していません。
この質問はあいまいなもののように見えますが、実際にはかなり重要だと思います。(しかし、問題は質問自体がやや間違って尋ねられたことです。)
それで、あなたはXMLドックレットを探しています(または探していました)...しかし、あなたはどのXMLについて話しているのですか?
たとえば、XHTMLは実際には「XML」であり、XHTMLを生成するドックレットは標準のものとほぼ同じです(標準のドックレットがすでにXHTMLを生成しているかどうかはわかりません)。DITAもXMLであるため、DITA出力を生成するドックレット(DITAドックレット)も同時に「XMLドックレット」になります。
XSL-FO、SVG、Microsoft Office XML、OfficeOpenXMLなどのようなフォーマットを生成する他の多くの可能なドックレットについても同じことが言えます。
実際、特定のXML語彙は、ほぼすべてのものに対して作成できます。そのため、「XML」は拡張可能なマークアップ言語です。
これらすべての「XMLドックレット」は互いに完全に異なり、非常に重いものになります。これは、XHTMLドックレット(別名標準ドックレット)を作業の一部と見なす場合、他のXMLドックレット(DITAドックレットなど)がなぜであるかを考えるためです。もっと簡単になりますか?
したがって、純粋な「XMLドックレット」(および最初はずっと前に停止されていたもの)が現在多くない理由を推測できます。それは、ほとんどすべての目的で単一のドキュメントレット(またはドキュメントジェネレータ)を作成することは不可能であることに人々が最終的に気付いたからだと思います。あなたが何かをするプログラムを開発することができないのと同じように(あなたの望みは何でも)。
では、(XMLドックレットに関する)質問全体が無意味だと思いませんか?
本質的にあなたが探しているのは、それ自体が普遍的な「XMLドックレット」ではないため、そのようなものは存在できません。むしろ、特定のXMLボキャブラリー用のカスタムXMLドックレットを簡単に開発するためのツールが必要です。その形で、私は、質問は非常に正当であると信じています!
そのツールは何ですか?もちろん、一般的なプログラミング言語(Java自体)はその「ツール」です。しかし、実際のところ、タスクはそれほど広くはありません。一般的なドキュメント生成(特にJavadoc)に共通する多くの操作をすでに自動化する、より焦点を絞ったものが存在する可能性があります。
そのようなツールは存在します!(そしてかなり昔のことです)
これはDocFlex/Javadocと呼ばれます:http ://www.filigris.com/products/docflex_javadoc/
DocFlex / Javadocでは、実際のドックレットは、グラフィックテンプレートデザイナを使用して特別なテンプレートの形式でプログラムされます。さらに、これらのテンプレートは、Javadocドックレットとしてラップされたテンプレートインタープリターによって解釈されます。テンプレート自体には、XSLTスクリプトにいくつかの類似点があります(ただし、XSLTに基づいていません)。このテンプレートシステムは、多くの日常的なタスクを自動化するのに役立ち、データ処理自体と結果出力の設計により集中できるようになります。
現在、DocFlex / JavadocはHTMLとRTFの生成に重点を置いていますが、それを使用して任意のXMLマークアップを生成することもできます。簡単に言うと、DocFlex / Javadocでサポートされている3番目の出力形式はプレーンテキスト(TXT)であり、XMLファイルはプレーンテキストファイルです。TXT出力の一部として発行されるテンプレートで任意のXMLタグを指定できます。そのため、結果としてXMLを取得できます。つまり、プログラムしたXMLと同じように、その時点でXMLを取得できます。
基本的に、一部のXMLファイルを別のXML出力に変換するXSLTスクリプトと同じように機能します。違いは、ここでのデータソースはXMLファイルではなく、DocletAPIであるということです。
実際、DocFlex / Javadoc自体は、はるかに大きなプロジェクトの派生物です。もう1つの派生物は、XMLスキーマドキュメントジェネレーターです。これは、ここで非常に人気があるようです。たとえば、「xsdを人間が読める形式のドキュメントに変換する方法」を参照してください。