Я ищу хороший инструмент для создания файлов HTML / справки из моей XML-документации VS2010. Я нашел несколько коммерческих инструментов, таких как
Я уверен, что их гораздо больше, я просто перечисляю эти два как примеры. Также существуют простые таблицы стилей XSLT для преобразования документации XML в HTML.
Что вы используете, например, есть ли бесплатный инструмент для преобразования, возможно, в виде надстройки.
Чтобы уточнить, в основном я нашел два типа инструментов:
- Те, которые конвертируют файл XML-документации в различные целевые форматы, это то, что я ищу.
- Инструменты, помогающие мне создавать XML-документацию в источнике код. Это не (!) То, что я ищу.
Спасибо за вашу помощь.
Комбинация Sandcastle / SHFB отлично работает. Спасибо всем, кто помог.
Некоторые замечания:
- NDoc кажется устаревшим, последние обновления датированы 2005 годом. Вот почему я пропустил это.
- Аналогичную ветку, также очень подробную, можно найти здесь: https://stackoverflow.com/questions/3082044/how-to-turn-c-xml-doc-comments-into-something-useful Спасибо за подсказку!
- Есть несколько источников для Sandcastle, последняя версия, которую я нашел, находится здесь: http: //sandcastle.codeplex. com /
- Для создания
MsHelp2
мне пришлось установить VS 2008 SDK, содержащий hscomp.exe
. Есть версии 1.0 и 1.1, насколько я понял, версия 1.0 содержит компилятор. См. Подробности в Helixsoft и Social MSDN .
- В моем случае сгенерированная WebHelp некорректно работает с Chrome. Он всегда перезагружает страницу index.html.
- В разделе здесь показано, как добавить информацию о пространстве имен в документацию Sandcastle.
- Обновление от ноября 2012 г .: Для небольших проектов я использую Doxygen - Мне немного проще настроить.
задан albert 24 March 2019 в 16:51
поделиться