sandcastle - 包含来自 xml 文档文件的常见内容

Question

我正在使用 Sandcastle 为项目生成文档。为了引用 xml 文档文件 include，使用了标签。

///<include file='xml_include_tag.doc' path='MyDocs/MyMembers[@name="test"]/*' />
public class Test

我想从这个 XML 文档文件中引用一些常见的内容。例如：

<MyDocs><MyMembers name="test">
        <summary>
           <include file='common.xml' path='MyDocs/MyMembers[@name="test"]/*' />
        </summary>
</MyMembers></MyDocs>

显然它不是这样工作的。做这些事情的正确方法是什么？Sandcastle 可能有一些扩展？

Answer 1

通过使用 MAML 令牌文件解决了该问题。Sandcastle 可以毫无问题地解决它们。

/// <summary>
/// <token>Token1</token>
/// </summary>