Сандкасл Тематическая группировка - PullRequest
2 голосов
/ 22 июля 2009

Мы используем Sandcastle для генерации документации по исходному коду в процессе сборки. Это прекрасно работает для создания документации уровня API для классов, методов, свойств и т. Д. Кроме того, Sandcastle позволяет добавлять сводки в ваши пространства имен, а также в «Концептуальное содержимое». Мы создаем файлы концептуального контента для различных тем «Как», таких как диаграммы архитектуры и т. Д. Все это прекрасно работает.

Кто-нибудь знает, есть ли способ в Sandcastle сгруппировать этот контент? По умолчанию Sandcastle создает всю эту документацию по API в корне дерева справки, а также любое концептуальное содержимое. Я хотел бы иметь узел в дереве, такой как «Документация API», и иметь весь исходный код документа под этим узлом, а затем иметь другие группы других тем документации, которые у нас есть. Я изо всех сил пытаюсь найти способ сделать это в Сандкасле. Я видел, что другие коммерческие продукты имеют такой тип группировки в своих файлах chm, но я подозреваю, что они используют что-то вроде RoboHelp.

Есть ли способ добиться этого с помощью Sandcastle?

1 Ответ

1 голос
/ 28 июля 2009

Эрик Водруфф ответил на мой вопрос на форумах CodePlex . Краткий ответ - использовать RootNamespaceContainer и RootNamespaceTitle для базовой группировки. Помимо этого, плагины контента - это путь. Надеюсь, это поможет кому-то еще

...