Почему мои блоки кода не отображаются в файле справки Sandcastle?

Я использую текущую версию Sandcastle от Codeplex, интегрированную с VS.NET 2012, для создания файла справки .cmh. Файл справки создается, но я не могу заставить какой-либо из моих <code> блоков выдаваться в файле справки. У меня есть следующий простой пример, с которым я продолжаю работать:

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

Когда я смотрю на выходной файл .chm, код var s; отсутствует нигде. Я сделал следующее:

Пример, очевидно, является упрощенной версией, но я просто пытаюсь заставить работать основы. Что я делаю неправильно или упускаю?


c# sandcastle
person atconway    schedule 19.03.2013    source источник
comment
Я не думаю, что тег code может быть сам по себе, попробуйте поместить его внутри тега <example>, например <example><code>var s;</code></example>.   -  person vcsjones    schedule 19.03.2013
comment
@vcsjones - Хороший звонок, я поклялся, что пробовал это раньше, но я должен был что-то истолковать. Я рекомендую предоставить ваше предложение в качестве ответа с полным примером, чтобы я мог его отметить. Забавно, что в статье «Укрощение замка из песка» это не показано.   -  person atconway    schedule 19.03.2013

Ответы (1)


arrow_upward
2
arrow_downward

Я не думаю, что тег кода может быть сам по себе, попробуйте поместить его внутри тега <example>, например <example><code>var s;</code></example>. Итак, это должно работать:

/// <summary>
/// This is the summary 
/// </summary>
/// <example>
/// <code>var s;</code>
/// </example>
public string SomeValue { get; set; }
person vcsjones    schedule 19.03.2013
comment
Это решило проблему, с которой я столкнулся, и теперь выдает код в разделе Examples в разделе Syntax, который уже существовал. Спасибо большое. - person atconway; 20.03.2013