Sandcastle Help File Builder не может найти источник документации
Я создаю документ проекта VS 2010 C# с помощью построителя файлов справки Sandcastle. Я добавил .xml документация, созданная компилятором и решением Visual Studio .sln файл проекта в Источники Документации. Я также добавил исполняемый файл проекта .exe to ссылки. Однако это не строительство. Я получаю там предупреждения и ошибки:
SHFB: предупреждение BE0006: не удается найти источники документации для 'C:UsersuserMusicDocumentsVisual Studio 2010проектыSFML_PlatformerSFML_Platformer.sln' (конфигурация: платформа отладки: AnyCPU)
SHFB: ошибка BE0042: необходимо указать хотя бы один источник документации в виде сборки или файла решения/проекта Visual Studio
в чем проблема?
4 ответов
вы должны добавить только файлы документации XML в качестве источника документа. Библиотеки dll добавляются автоматически после добавления XML-файлов.
вот ответ от Эрика А. к. A EWoodruff разработчик Sandcastle Help File Builder.
BE0006 означает, что он не смог найти источник документации на основе проект. BE0042 является вторичным результатом этого значения, которое он нашел вообще нечего документировать. Какие проекты находятся в решение? Если это проект-сайт, имейте в виду, что они не обычно создаются все сборки, перечисленные в качестве выходных данных в проект и любые комментарии XML файлы. В этом случае вам нужно добавить поставщики веб-кода для вашего проекта, чтобы получить комментарии XML и вручную добавьте веб-сайт .папку \bin в качестве источника документации в проект ШФБ. Есть тема документирования веб-сайтов в Раздел начало работы, если это так.
все другие типы проектов должны работать. Если все остальное не удается, попробуйте добавить непосредственно файлы комментариев сборки и XML. Полагаю, это возможно. в выпусках Express используется diffent идентификаторы типов проектов. Если вы можете отправить меня решение файл и файл проекта, я могу взглянуть на них и увидеть почему он не находит цели. Мой адрес электронной почты находится в About окно в standalone GUI и в футере страницы в помощь файл.
еще одна вещь, убедитесь, что настройки конфигурации и платформы выбранные на панели инструментов SHFB соответствуют конфигурации и платформе настройки, используемые для создания проекта (например, Debug/AnyCPU, Выпуск / AnyCPU, Debug / x86 и т. д.). Если нет, то это вызовет его не найдите правильные выходные цели.
Эрик
у меня возникла эта проблема, когда я переключил сборку проекта VS.NET на моем главном приложении от Debug до Release. Я предполагаю, что он больше не мог найти .dll я указал для создания документации. Я мог бы исправить отображение, но возвращаясь к Debug работал просто отлично для меня, чтобы удалить эту ошибку.