Создание файлов HTML / справки из документации VS 2010 C # XML

Я ищу хороший инструмент для создания файлов HTML / справки из моей XML-документации VS2010. Я нашел несколько коммерческих инструментов, таких как

Я уверен, что их гораздо больше, я просто перечисляю эти два как примеры. Также существуют простые таблицы стилей XSLT для преобразования документации XML в HTML.

Что вы используете, например, есть ли бесплатный инструмент для преобразования, возможно, в виде надстройки. Чтобы уточнить, в основном я нашел два типа инструментов:

  1. Те, которые конвертируют файл XML-документации в различные целевые форматы, это то, что я ищу.
  2. Инструменты, помогающие мне создавать XML-документацию в источнике код. Это не (!) То, что я ищу.

Спасибо за вашу помощь.


Комбинация Sandcastle / SHFB отлично работает. Спасибо всем, кто помог.

Некоторые замечания:

  1. NDoc кажется устаревшим, последние обновления датированы 2005 годом. Вот почему я пропустил это.
  2. Аналогичную ветку, также очень подробную, можно найти здесь: https://stackoverflow.com/questions/3082044/how-to-turn-c-xml-doc-comments-into-something-useful Спасибо за подсказку!
  3. Есть несколько источников для Sandcastle, последняя версия, которую я нашел, находится здесь: http: //sandcastle.codeplex. com /
  4. Для создания MsHelp2 мне пришлось установить VS 2008 SDK, содержащий hscomp.exe . Есть версии 1.0 и 1.1, насколько я понял, версия 1.0 содержит компилятор. См. Подробности в Helixsoft и Social MSDN .
  5. В моем случае сгенерированная WebHelp некорректно работает с Chrome. Он всегда перезагружает страницу index.html.
  6. В разделе здесь показано, как добавить информацию о пространстве имен в документацию Sandcastle.
  7. Обновление от ноября 2012 г .: Для небольших проектов я использую Doxygen - Мне немного проще настроить.

26
задан albert 24 March 2019 в 16:51
поделиться