Groupement de sujets Sandcastle

Question

Nous utilisons Sandcastle pour générer notre documentation de code source avec notre processus de construction. Cela fonctionne très bien pour créer un document de niveau API pour les classes, méthodes, propriétés, etc. De plus, Sandcastle vous permet d'ajouter des résumés à vos espaces de noms ainsi que du "Contenu conceptuel". Nous créons des fichiers de contenu conceptuel pour divers sujets "Comment faire", ainsi que des diagrammes d'architecture, etc. Tout cela fonctionne très bien.

Est-ce que quelqu'un sait s'il existe un moyen de regrouper ce contenu dans Sandcastle? Par défaut, Sandcastle semble créer toute la documentation de l'API à la racine de l'arbre d'aide, ainsi que tout contenu conceptuel. Je voudrais avoir un nœud dans l'arbre comme "Documentation API" et avoir tous les doc de code source sous ce nœud, puis avoir d'autres groupes des autres sujets doc que nous avons. J'ai du mal à trouver un moyen de le faire à Sandcastle. J'ai vu d'autres produits commerciaux avoir ce type de groupement dans leurs fichiers chm, mais je suppose qu'ils utilisent quelque chose comme RoboHelp.

Existe-t-il un moyen d'atteindre cet objectif avec Sandcastle?

Answer 1

Eric Wodruff a répondu à ma question over on the CodePlex discussion boards. La réponse courte est d'utiliser RootNamespaceContainer et RootNamespaceTitle pour effectuer un regroupement de base. Au-delà de cela, les plugins de contenu sont la voie à suivre. Espérons que cela aide quelqu'un d'autre