WikiDer > VSdocman

VSdocman
VSdocman
Иконка vsdocman 32.gif
Разработчики)Helixoft
Стабильный выпуск
9.0 / 24 апреля 2019 г. (2019-04-24)
Операционная системаWindows
ТипГенератор документации
ЛицензияПроприетарный
Интернет сайтhttp://www.helixoft.com

VSdocman это генератор документации что позволяет комментировать код и автоматически генерировать техническую документацию из C # и VB .NET проекты. Он напрямую интегрирован в Visual Studio как расширение.

Обзор

VSdocman - это расширение для Visual Studio 2017, 2015, 2013 и 2012. Оно состоит из двух основных частей - компилятора документации и редактора комментариев. Компилятор создает окончательную документацию класса в различных форматах. Редактор комментариев предоставляет инструменты для полуавтоматической вставки или редактирования XML-комментариев, используемых компилятором.[1]

Компилятор документации

В зависимости от настроек пользователя VSdocman сканирует код в проектах Visual Studio и автоматически создает документация. Это можно сделать непосредственно из пользовательского интерфейса VS или из командной строки, например в автоматизированной сборке. Документация соответствует стилю MSDN с оглавление, индекс, API документация класса и настраиваемые темы, Перекрестные ссылки, поиск, IntelliSense и F1 контекстно-зависимая помощь.[2]

Поскольку компилятор имеет доступ к проекту Visual Studio, он может также включать исходный код и диаграммы классов (файлы .cd) в документации. Проекты можно задокументировать отдельно или создать единую документацию для всего решения.[3]

Формат выходной документации можно настроить. Стандартные форматы:

Вывод может быть локализован, и некоторые языки уже включены.[4]

Редактор комментариев

VSdocman умеет читать XML-комментарии от исходный код. Редактировать комментарии вручную может быть непросто, поэтому он содержит WYSIWYG редактор комментариев, который помогает писать комментарии XML и настраиваемые темы. Можно вставлять таблицы, списки, изображения, диаграммы классов, ссылки и другое форматирование непосредственно в исходный код. В зависимости от типа элемента кода пользователь может указать для него комментарий по умолчанию. Этот комментарий будет автоматически добавлен, когда пользователь впервые добавит или изменит комментарий. Например, «Получает или задает значение, указывающее, создается ли ...» сводный текст автоматически для логических свойств.[5]

История

Первоначально VSdocman назывался VBdocman .NET, потому что он произошел от VBdocman. VBdocman .NET поддерживает только Visual Basic .NET. Он был переименован в VSdocman после добавления поддержки C # в 2006 году.[6]

Смотрите также

Рекомендации

  1. ^ VSdocman в Visual Studio Marketplace
  2. ^ Возможности VSdocman
  3. ^ Руководство VSdocman
  4. ^ Шаблоны вывода VSdocman
  5. ^ Комментирование исходного кода
  6. ^ Примечания к выпуску VSdocman

внешняя ссылка