Хорошие альтернативы Sandcastle для создания документации в стиле MSDN

Я использую Sandcastle в течение 2 лет для создания документации для библиотеки с открытым исходным кодом. Но теперь я ищу альтернативу, потому что:

  • Даже при использовании Sandbule Help File Builder, Sandcastle слишком сложна для моего вкуса. Создание документации должно быть таким же простым, как щелчок кнопки или меню в Visual Studio.
  • Проект, похоже, больше не поддерживается; последняя версия была выпущена в июне 2010 года, и, похоже, кто-то еще не работает над ней. Ошибки больше не исправлены, что для меня большая проблема (моя библиотека сильно использует методы расширения, а эта ошибка испортила все)
  • Поскольку это будет проект с открытым исходным кодом, коммерческие продукты, такие как VSdocman и Document! X для меня не может быть и речи.

Уже есть несколько похожих questions на SO, но они все довольно старые, и предложенные альтернативы не соответствуют моим потребностям. NDoc был довольно хорош, но он больше не поддерживается и не поддерживает последние функции (методы расширения, прикрепленные свойства...). Мне не нравится стиль документации, созданной Docu и Doxygen, я ищу инструмент, который создает документацию в стиле MSDN.

Итак, есть ли другой инструмент, который я мог бы использовать? Или я застрял с Sandcastle?

Ответы

Ответ 1

Существует несколько коммерческих продуктов, таких как

http://www.doc-o-matic.com/features.html

Но лично я думаю, что вы можете рассмотреть Monodoc,

http://www.mono-project.com/Monodoc

Он по-прежнему активно используется Mono (MonoTouch/Mono для Android), поэтому он не будет работать как Sandcastle.

Ответ 2

Для С#: Документ Innovasys! X для документации по С#

Тип документации MSDN. Я уверен, что есть много других хороших вариантов, зависящих от цены.

Example (очень хороший пользовательский интерфейс)

Help Studio: Innovasys HelpStudio 2011

Кросс-платформенный справочный генератор. Формат с несколькими выходами. Позволяет импортировать также.

Также:

Ответ 3

GhostDoc Pro от Roland Weigelt:

Создайте файл справки - CHM, MS Help 2, MS Help Viewer и веб-сайт

Sandbule Help File Builder отлично работает для меня.

Другой альтернативный вариант Helixoft VSdocman:

Создайте профессиональную техническую документацию в нескольких и локализованных форматах - HTML, CHM, Microsoft Help Viewer (Справка VS 2013/2012/2010), MS Help 2 (Справка VS 2002 - 2008), Docx (формат OOXML, используемый в MS Word, который можно легко экспортировать в PDF), RTF, Help и Manual, XML и другие.

Ответ 4

ApiStack.net находится в бета-версии. Это веб-сайт, а не автономный инструмент для создания автономных документов, но это не должно быть проблемой для проекта с открытым исходным кодом. Он был разработан для поддержки F #, но авторы утверждают, что он должен работать на других языках .net, включая С#.

Немногие из проектов, открытых на apistack.net, имеют полную документацию на данный момент, см. основную библиотеку F # для интересного примера возможностей сайта.

Ответ 5

Я новичок в создании документов для .Net, но, по-видимому, Sandcastle April 2012 v2.7.0.0 Полная версия доступна и доступна для скачивания по следующей ссылке,

http://sandcastlestyles.codeplex.com/releases/view/86091

В нем указано, что эта сборка исправляет все предыдущие известные ошибки. Поэтому, вероятно, стоит изучить.