Xml文档<code> tag shows C# for VB.NET code</code>

时间:2011-07-28 10:06:13

标签: vb.net sandcastle xml-documentation

我正在尝试使用&lt; code&gt; &lt; example&gt;内的标记标记以在xml文档中显示示例代码。但是,当我构建Sandcastle项目时,我发现它显示为C#。 &lt; code&gt;中没有语言属性标签。我在Sandcastle的项目属性中找不到设置。我错过了什么吗?

BTW,我使用的是HtmlHelp1格式。

1 个答案:

答案 0 :(得分:11)

实际上,如果你超越Sandcastle到Sandcastle Help File Builder(SHFB),  您将获得两个更容易使用的Sandcastle 界面和文档集的其他功能,包括您想要的内容:语言属性(language<code>元素。

请注意,SHFB会生成语言选择器菜单,但只能让您使用 显示或隐藏一组特定的语言(C#,VB.NET,C ++,J#,JScript.NET,XAML和JavaScript)。但它支持着色更大的集合(C#,VB.NET,JScript.NET,C ++,J#,C,JavaScript,VBScript,XAML,XML,HTML,SQL脚本,PowerShell脚本和Python)。 (来自SHFB文档的Code Block Component部分。)

我在Simple-Talk.com上发表的文章Taming Sandcastle: A .NET Programmer's Guide to Documenting Your Code中,就这一点,以及Sandcastle和SHFB的许多其他技巧和陷阱进行了广泛的撰写。除了主要文章之外,我还整理了一个wallchart/quick reference,它为您提供了在一个页面上使用Sandcastle / SHFB所需要知道的一切 - 链接也出现在文章的最后。

您可以在我文章的Displaying Sample Code部分以及Importing and Colorizing Code from Source Files上的官方SHFB文档中找到有关<code>元素的更多详细信息。