2

私はいくつかのプロジェクトを持っています。マネージド コードを使用するものもあれば、アンマネージド コードのみを使用するものもあります。すべてに XML コメントが追加され、XML ドキュメントが正しく生成されています (生成された xml ファイルと中間の xdc ファイル)。

確かに、これらのファイル (xdcmake の出力) を取得して、MSDN スタイルの chm ヘルプを生成できるものがあります! ? 私の理解では、doxygen と sandcastle の両方がその明白なステップを無視し、車輪を再発明してコードを再スキャンします。(sandcastle は .NET 以外のプロジェクトでは明らかに役に立たないという事実もあります)。

doxygen (恐ろしい出力ですが高速) と sandcastle (MSDN スタイルの出力は良いが遅い) を試してみたところ、どちらももっと単純なものに負けそうになっています。

また、API ドキュメントにも必要な「Getting Started」や「Information」などのページを作成できるエディタが関連付けられていると便利です。

誰かが解決策を知っていますか?

4

3 に答える 3

0

正直なところ、サンドキャッスルはあなたの最善の策です。設定するのは少し面倒かもしれませんが、ドキュメントはまさにあなたが探しているスタイルです。

于 2009-07-01T03:25:13.320 に答える
0

人々がまだNDocConsoleを使用しているプロジェクトを知っています

ただし、 http: //ndoc.sourceforge.net/ には2005 年以降更新がないため、NDoc は死んだプロジェクトだと思います。

于 2009-07-20T15:35:27.347 に答える
0

DoxyCommentを試してみてください。Doxygen のHelper tools & scriptsからの説明は次のとおりです。

DoxyComment と呼ばれる Visual Studio 2005 のアドインは、Troels Gram によって作成されました。これは、状況依存のコメント ブロックを C/C++ ソース ファイルに挿入する際に役立つように設計されています。DoxyComment には、MSDN ライブラリのようなドキュメントを生成できる xslt テンプレートも付属しています。

于 2009-07-20T16:00:46.357 に答える