Включите общий контент из файла документации xml

Я использую Sandcastle для создания документации по проекту. Для ссылки на файл xml-документации используется тег include.

///<include file='xml_include_tag.doc' path='MyDocs/MyMembers[@name="test"]/*' />
public class Test

И я хотел бы сослаться на некоторый общий контент из этого файла XML-документа. Например:

<MyDocs><MyMembers name="test">
        <summary>
           <include file='common.xml' path='MyDocs/MyMembers[@name="test"]/*' />
        </summary>
</MyMembers></MyDocs>

Очевидно, так не работает. Как правильно поступать с такими вещами? Возможно есть какое-нибудь расширение для Sandcastle?


xml-documentation sandcastle
person k0stya    schedule 12.11.2012    source источник
comment
Вы пытаетесь включить XML-файл из другого включенного XML-файла? В ваших примерах мне кажется, что первое включение добавляет второй файл, а оттуда вы хотите включить common.xml. Это так?   -  person Jorge Poveda    schedule 23.11.2012
comment
Я провел тест с использованием Visual Studio 2012, и он разрешает включение включенных файлов, поэтому для меня он работает так, как ожидалось. Какие результаты вы получите, когда это сделаете?   -  person Jorge Poveda    schedule 24.11.2012
comment
@JorgePoveda, я получаю точно такой же тег include, что и в резюме. Не могли бы вы привести свой пример?   -  person k0stya    schedule 27.12.2012

Ответы (1)


arrow_upward
1
arrow_downward

Решил проблему с помощью файлов токенов MAML. Sandcastle решает их без проблем.

/// <summary>
/// <token>Token1</token>
/// </summary>
person k0stya    schedule 26.12.2012