ASP時代にさかのぼる非常に古いアプリケーションがあり、徐々にASP.NET + VB.NETコードベースにリファクタリングしています。
以下のタイプのファイルが多数含まれています。
aspx、asmx、ascx、vb、js (JavaScript)、html、vbs (VBScript)。
バックエンド データベースは、多数の sproc を備えた SQL Server 2005 です。
コード ファイル内のコメントから自動的に生成されるコード ドキュメントを作成したいと考えています。Doxygen はとても気に入りましたが、上記のテクノロジーをサポートしていないようです。できれば単一のツールまたはツールのグループを提案してください。
どうもありがとう。
アジット。
あなたはマイクロソフトのサンドキャッスルツールを見ることができます。私はこれを何度も使用しましたが、.NETコードで提供されたコメントに基づいてドキュメントを生成します。正しく覚えていれば、JavaScriptライブラリのドキュメントを生成することもできます。
私はSandCastleを使用しましたが、コードに xml コメントがあるとうまく機能します。
まず、[プロジェクト プロパティ] -> [コンパイル] -> [XML ドキュメントの生成] で設定して、プロジェクトで xml ドキュメントを有効にします。
完了したら、警告をエラーとして扱うように設定する必要がある場合があります。これにより、Studio は、XML コメントがどこにあり、すべてが欠落しているかを指摘できます。
XML コメントを追加するには、カーソルをクラス定義または関数定義の前に置き、型を入力します。
///
これにより、ドキュメント用の xml タグが自動的に生成されます。完了したら、プロジェクトをインポートしてドキュメントのビルドを開始できます。
良い点は、クラスを適切に文書化している場合、マウスオーバー時にアプリケーションでそれらの関数を使用すると、インテリセンスの文書がどのように機能するかのように、記述した説明を見つけることができることです。
他に問題が発生した場合はお知らせください。
私の最後の提案は、Hello World プロジェクトを作成し、それを xml 文書化して、サンドキャッスルに慣れることです。