Я использовал Sandcastle вместе с Sandcastle Help File Builder, и по умолчанию он предлагает три стиля представления: hana, прототип и vs2005.
Хотя стиль vs2005 выглядит нормально, мне особенно нравится последний облегченный стиль MSDN. Есть ли способ настроить Sandcastle так, чтобы он генерировал документацию в этом стиле?
Соответствующие политики / стратегии продуктов Microsoft действительно немного странные и в некоторой степени расходятся с переходом к более открытому процессу разработки в последние годы - Комментарии к документации, SandCastle и новые преобразования документации - хорошая напыщенная речь, обобщающая официальную положение дел.
Тем не менее, похоже, существует неофициальное (и, таким образом, юридически сомнительное оспаривается, см. Ниже) доступное решение: Project sandcastle-presentation направлен на создание нового шаблона презентации для Sandcastle, который будет генерировать документацию в стиле упрощенного брендинга MSDN.
В частности, он нацелен на интеграцию с настоятельно рекомендуемым Sandcastle Help File Builder (SHFB), который устраняет другие упомянутые недостатки. в вышеупомянутой тираде, а именно, он был создан для заполнения пробелов, предоставления недостающих функций, подобных NDoc, которые используются наиболее часто, и предоставления графических инструментов и инструментов на основе командной строки для автоматического создания файла справки .
Просмотрите ветку обсуждения SHFB стиль представления MSDN, доступный в коде Google!, чтобы узнать о различных точках зрения относительно законности sandcastle-presentation и сделайте свое собственное суждение.
