.net - サンドキャッスルは、ヘッダー コメントの代わりに外部ファイルから XmlDoc を読み取ることができますか?

Question

Sandcastle Help File Builder (SHFB)は、次のようにトリプル スラッシュ コメントをドキュメントに変換します。

///<summary>A class called Bob</summmary>
public sealed class Bob {}

ドキュメントのスキーマは非常に堅牢です。ただし、ドキュメンテーションが堅牢で冗長であればあるほど、実際にソース コードを参照して編集するのが煩わしく感じる人もいます。良い妥協点は、次のようなことができるでしょう

///<summary>A class called Bob</summmary>
///<include href="projectDocs.xml" xpath="/Company/Product/Bob" />
public sealed class Bob {}

このようなことは可能ですか？

Answer 1

はい、可能です。インクルードコメント タグがあります。私たちのVSdocmanはそれをサポートしており、Sandcastle もサポートしていると思います。