所以我正在使用Sandcastle帮助文件生成器生成文档网站。一切都很棒!但是,在查看某个类的页面时,我希望Properties表(当前有图标,名称和描述列,见下文)包含属性类型的列(int,bool,string等等。)
我正在阅读有关用于模板的xsl文件的某处,但老实说,尝试找到我正在寻找的内容时有点压倒性。
所以基本上,我想在上面的表中添加一个列,列出类型(string,int等)。那可能吗?谢谢!
答案 0 :(得分:1)
不幸的是,经过大量的搜索后,我仍然无法找到一种方法来完全按照我的意愿(作为一个单独的专栏)。正如Darraugh指出的那样,最好的是将其手动包含在描述中。有两种方法可以做到这一点。使用<See>
tag或使用<seealso>
tag。
<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>
并产生以下内容:
这有点多余,因为你必须进入该属性才能看到它,它已经显示了属性类型。
希望这个答案在某些时候已经过时了,当它被实现到sandcastle本身时。但就目前而言,这对其他人有帮助,因为它帮助了我。