Комментарий XML со ссылкой на файл

Question

Я хочу добавить ссылку на файл в комментарий xml для класса. Я могу это сделать так:

/// <summary> 
/// Condition with the content of the text <a href="file:///d:/a.jpg">file</a> 
/// </summary> 

Как я могу использовать относительный путь к файлу?

Answer 1

В дорожках Sandcastle относительно рабочей папки (папка .\Working под выходным путем, установленным в настройках). Чтобы указать путь относительно вашего проекта, укажите его {@ProjectFolder}. Например:

<a href="{@ProjectFolder}/a.jpg">File</a> 

Вы можете найти полный список таких запасных тегов здесь:

Customizing the Build Process - Replacement Tags

---

вы знаете, вы можете заменить cref с href в документации ли теги:

<see href="http://www.example.com/">Example</see> 

<seealso href="http://www.example.com/">Example</seealso>