Создайте файл справки Sandcastle для веб-сайта без опции «Файл документации Xml»

Question

Я пытаюсь создать файл справки Sandcastle для веб-сайта. В окне свойств для проекта нет никаких параметров для создания файла документации XML, необходимого для Sandcastle.

Вкладка «Строительство» на страницах свойств содержит только следующие параметры: «Начать действие», «Действие решения для решения» и «Проверка доступности». У меня нет каких-либо параметров для вывода или файла документации XML, как и у моих других проектов.

Веб-сайт, с которым я работаю, не имеет фактического файла .proj, что может быть проблемой. Если это проблема, то каков наилучший способ создать ее для проекта, который находится под контролем источника и над которым работают многие люди с минимальными нарушениями?

Это профессиональный профессионал Visual Studio 2005.

Answer 1

Проблема с веб-сайтами в VS2k5 заключается в том, что при их компиляции результирующие библиотеки DLL являются беспорядком. Нет пространств имен, странных имен и т. Д.

Если вы действительно хотите создать файл справки Sandcastle, посмотрите на преобразование своего веб-сайта в веб-приложение. Вы можете определенно создать исходные коды для этого.

Answer 2

Я еще не пробовал, но вы можете попробовать следующее: Documenting Web Sites/Projects с сайта Эрика Вудраффа. Он дает информацию о том, как это можно сделать.

Обновление: я попробовал и работает на обычных сайтах. Единственная проблема, которую я вижу, - это , что на сайтах нет пространств имен. Поэтому, когда я запускаю его, я получаю тему по FolderName_WebPage Class без каких-либо логических группировок. Таким образом, это альбатетерическое название папки и названия страницы: . После того, как вы создали контент, вы можете отредактировать файл справки, используя helpcompiler/builder, и сгруппируйте темы по мере необходимости.