将类型列添加到Sandcastle属性表

Question

所以我正在使用Sandcastle帮助文件生成器生成文档网站.一切都很棒!但是,在查看某个类的页面时,我希望Properties表(当前有图标,名称和描述列,见下文)包含属性类型的列(int,bool,string等).

我正在阅读有关用于模板的xsl文件的某个地方,但老实说,尝试找到我正在寻找的东西有点压倒性.

所以基本上,我想在上面的表中添加一个列,列出类型(string,int等).那可能吗？谢谢!

Answer 1

不幸的是，经过大量搜索后，我仍然无法找到一种完全按照我想要的方式进行操作的方法（作为单独的专栏）。正如 Darraugh 指出的那样，最好的方法是将其手动包含在描述中。有两种方法可以做到这一点。使用<See>标签或使用<seealso>标签。

该<see>标签可以这样使用：

/// <summary>
/// Assessment ID to be copied
/// <see cref="System.Int32">System.Int32</see>
/// </summary>

并产生以下结果：

该<seealso>标签可以这样使用：

/// <summary>
/// Assessment ID to be copied
/// <seealso cref="System.Int32"/>
/// </summary>

并产生以下结果：

这有点多余，因为您必须进入属性才能看到它，它已经显示了属性类型。

希望当这个答案被实现到沙堡本身时，这个答案会在某个时候变得过时。但就目前而言，这可能对其他人有帮助，就像它对我有帮助一样。