Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Add type column to Sandcastle Property table

So I'm generating a documentation website using Sandcastle Help File Builder. Everything is generated great! However, when looking at a page for a class, I'd like for the Properties table (which currently has the icon, name, and description columns, see below) to include a column for the type of property (int, bool, string, etc).

Properties Table

I was reading somewhere about the xsl files that are used for the templates, but honestly it was a little overwhelming trying to find exactly what I'm looking for.

So basically, I'd like to add a column to the above table that lists the type (string, int, etc). Is that possible? Thanks!

like image 542
jmgardn2 Avatar asked Mar 27 '14 19:03

jmgardn2


1 Answers

Unfortunately after a lot of searching I still haven't been able to find a way to do it exactly as I wanted (as a separate column). The best, as Darraugh pointed out, is to include it manually in the description. There are two ways of doing this. Using the <See> tag or using the <seealso> tag.

The <see> tag can be used as such:

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

And produces the following:

<see> tag sample

The <seealso> tag can be used as such:

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

And produces the following:

<seealso> tag sample

This is a little redundant since you have to go into the property in order to see it, which already displays the property type.

Hopefully this answer will become obsolete at some point when this is implemented into sandcastle itself. But for right now this may help other as it has helped me.

like image 106
jmgardn2 Avatar answered Nov 01 '22 01:11

jmgardn2