爲什麼我的代碼塊不能在Sandcastle幫助文件中渲染？

Question

我正在使用與VS.NET 2012集成的Codeplex中的Sandcastle的當前版本來構建.cmh幫助文件。幫助文件正在創建，但我似乎無法讓我的任何<code>塊在幫助文件中發出。我有以下簡單的例子我一直有工作：

/// <summary> 
/// This is the summary 
/// </summary> 
/// <code>var s;</code> 
public string SomeValue { get; set; } 

當我看到在輸出.chm文件，該var s;代碼並沒有出現在任何地方。我已完成以下操作：

• 在Sandcastle項目屬性中添加了對Code Block Component的引用。
• 嘗試製作標籤<code lang="C#">var s;</code>和<code language="C#">var s;</code>但都沒有區別。
• 以下網站上詳細介紹這一過程，但無濟於事閱讀文檔：
  https://www.simple-talk.com/dotnet/.net-tools/taming-sandcastle-a-.net-programmers-guide-to-documenting-your-code/
  http://www.ewoodruff.us/shfbdocs/

的例子顯然是一個簡化版本，但我只是想獲得的基本知識在這裏工作。我做錯了什麼或失蹤？

Answer 1

我不認爲代碼標記本身是允許的，請嘗試將它放在<example>標記內，如<example><code>var s;</code></example>。所以這應該工作：

/// <summary> 
/// This is the summary 
/// </summary> 
/// <example> 
/// <code>var s;</code> 
/// </example> 
public string SomeValue { get; set; }