「Xml ドキュメント ファイル」オプションを使用せずに Web サイトの Sandcastle ヘルプ ファイルを生成する
-
01-07-2019 - |
質問
Web サイト用の Sandcastle ヘルプ ファイルを生成しようとしています。プロジェクトのプロパティ ウィンドウには、Sandcastle に必要な XML ドキュメント ファイルを作成するためのオプションがありません。
プロパティ ページの [ビルド] タブには、次のオプションのみが含まれています。アクションの開始、ソリューションのビルド アクション、およびアクセシビリティの検証。他のプロジェクトにあるような、出力または XML ドキュメント ファイルのオプションはありません。
私が作業している Web サイトには実際の .proj ファイルがありません。これが問題である可能性があります。これが問題である場合、ソース管理下にあり、多くの人々によって作業されているプロジェクト用に、中断を最小限に抑えてプロジェクトを作成する最善の方法は何でしょうか?
ここでは Visual Studio 2005 professional を使用しています。
解決
VS2k5 の Web サイトの問題は、コンパイル時に生成される DLL が混乱していることです。名前空間や奇妙な名前などはありません。
本当に Sandcastle ヘルプ ファイルを生成したい場合は、Web サイトを Web アプリケーションに変換することを検討してください。そのためのソースコードドキュメントを生成することは間違いなく可能です。
他のヒント
まだ試していませんが、次のことを試してみるのもいいかもしれませんWeb サイト/プロジェクトの文書化 エリック・ウッドラフのサイトより。具体的にどのようにすればよいのかを説明します。
アップデート:実際に試してみたところ、通常のウェブサイトでは機能しました。私が見ることができる唯一の問題は、ウェブサイトに名前空間がないことです。したがって、私がそれを実行するとき、私は論理的なグループ化なしにfoldername_webpageクラス形式でトピックを取得します。したがって、それはフォルダーとページ名でアルパベティカルです。コンテンツを作成したら、HelpCompiler / Builderを使用してヘルプファイルを編集し、必要に応じてトピックをグループ化できます。