Générer un fichier d'aide Sandcastle pour un site Web sans le & # 8220; Fichier de documentation XML & # 8221; option

Question

J'essaie de générer un fichier d'aide Sandcastle pour un site Web. Dans la fenêtre de propriétés du projet, aucune option ne permet de créer le fichier de documentation XML requis pour Sandcastle.

L'onglet Générer dans les pages de propriétés contient uniquement les options suivantes: validation de l'action de démarrage, création de l'action de solution et validation de l'accessibilité. Je n'ai aucune option pour Output, ni pour la documentation XML, contrairement à mes autres projets.

Le site Web sur lequel je travaille ne contient pas de fichier .proj, ce qui pourrait être le problème. Si tel est le problème, quel est le meilleur moyen de le créer pour un projet sous contrôle de source et sur lequel de nombreuses personnes travaillent avec un minimum de perturbations?

Ceci utilise Visual Studio 2005 Professional.

Answer 1

Le problème avec les sites Web dans VS2K5 est que, lorsqu'ils sont compilés, les DLL qui en résultent sont un gâchis. Aucun espace de noms, noms étranges, etc.

Si vous souhaitez vraiment générer un fichier d’aide Sandcastle, envisagez de convertir votre site Web en une application Web. Vous pouvez certainement générer des documents de code source pour cela.

Answer 2

Je n'ai pas encore essayé, mais vous voudrez peut-être essayer ce qui suit Documentation de sites / projets Web du site d'Eric Woodruff . Il donne les détails sur la façon dont cela peut être fait.

Mise à jour: je l’ai essayé et cela fonctionne pour les sites Web classiques. Le seul problème que je peux voir est que les sites Web n'ont pas d'espaces de noms. Donc, quand je le lance, je reçois un sujet par FolderName_WebPage Format de classe sans groupement logique. C'est donc alhpabetical par dossier et nom de la page. Une fois le contenu créé, vous pouvez éditer le fichier d’aide en utilisant un compilateur / constructeur d’aide et regroupez les sujets au besoin.