9

Visual Studioには、Javadocスタイルのコメントのhtmlドキュメントを生成するオプションがありますか?もしそうなら、これを達成するためにどのようなステップが必要ですか?

BlueJには、Javadocスタイルのコメントをhtmlファイルに変換するオプションがあります。

次のBlueJを使用したJavaの写真のように、Visual Studioでも同じことをしたいと思います:(ソース:time-tripper.comhttp://www.time-tripper.com/uipatterns/Patterns/Titled_Sections/javadoc.gif

4

2 に答える 2

9

Javaで実際にJavaDocを意味しますか?もしそうなら、私はそうは思わない-ただjavadoc自体を使用する。VisualStudioは実際にはJavaをサポートしていません。

C#XMLドキュメントのコメントを意味する場合は、プロジェクトのプロパティを変更してXMLファイルを作成し、NDoc(廃止)またはSandcastleを使用してHTML(またはchmなど)を作成できます。確かに、それはそれほど簡単ではありません。

編集:C ++を使用している場合は、おそらくDoxygenを確認する必要があります。Visual Studioプラグインがあるかもしれませんが、ビルドプロセスの一部としてDoxygenを実行するのが最善かもしれません。C ++ / CLIを使用している場合は、C#XMLコメントに相当するものがあるかもしれませんが、私にはわかりません。

于 2009-12-20T09:33:18.523 に答える
1

Javadoc互換のコメントスタイルを使用して、コメントを手動で入力するか、私のアドインであるAtomineer Pro Documentationを使用して、ほとんどの作業を取り除くことができます。次に、外部ドキュメントを生成するには、javadocを楽しく読み取るdoxygenを使用します。

別の方法は、(Jonが言ったように)XmlDoc形式のコメントを使用することです。これは、Visual Studio(インテリセンスツールチップ用)、Atomineer、Sandcastle、およびDoxygenで使用できます。人間が読める形式ではありませんが、Visual Studio環境内で大きな利点が得られるため、少し柔軟性があります。

どちらのアプローチもC#、C ++、Cで機能します(ただし、C#はインテリセンス側でより適切に機能します)

于 2009-12-20T20:16:19.690 に答える