我正在尝试使用< code> < example>内的标记标记以在xml文档中显示示例代码。但是,当我构建Sandcastle项目时,我发现它显示为C#。 < code>中没有语言属性标签。我在Sandcastle的项目属性中找不到设置。我错过了什么吗?
BTW,我使用的是HtmlHelp1格式。
答案 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>
元素的更多详细信息。