Visual Studio 2008 permet de générer la documentation xml.
Existe - t - il un outil qui permette de mettre en page simplement ce xml ?
Je voudrai donc un soft qui s'appuie sur la documentation xml générée par VS 2008 pour la mettre en page
merci
Version imprimable
Visual Studio 2008 permet de générer la documentation xml.
Existe - t - il un outil qui permette de mettre en page simplement ce xml ?
Je voudrai donc un soft qui s'appuie sur la documentation xml générée par VS 2008 pour la mettre en page
merci
Finalement je me rabats sur l'éxplorateur d'objet de Visual Studio.
Ce qui m'embête c'est qu'il n'est pas exportable.
Si ce que tu cherches, c'st un genre de javadoc, tu as sandcastle
http://philippe.developpez.com/articles/SandCastle
Oui mais le problème avec sandcastle c'est qu'il fait sa propre interprétation des commentaires.
C'est très long et un petit peu buggé.
Pourquoi ne pas utiliser directement le xml généré par visual studio (même si il n'est pas très propre) ?
Un outil qui prend du xml en entrée, lui applique le bon xsl et on a notre doc html.
Je suis vraiment étonné de ne pas trouvé cela.
Tres long, oui, ca tourne a une ou deux minutes pour un projet moyen...ceci dit, tu le fais pas tourner a chaque modif ;)Citation:
Oui mais le problème avec sandcastle c'est qu'il fait sa propre interprétation des commentaires.
C'est très long et un petit peu buggé.
Unpeu bugge, la, je demande plus d'infos ;). Perso, j'ai une quizaine de projets en ce moment qui utilisent sandcastle pour generer la doc, la doc est generee tous les soirs a 22h, et j'ai eu aucun pb en 2 ans
Sinon, tu as docu:Citation:
Un outil qui prend du xml en entrée, lui applique le bon xsl et on a notre doc html.
http://docu.jagregory.com/
(Perso, je le trouve moche, mais...)
Ce qui est gênant pour l'instant avec sandcastle, et ce doit être un problème de paramètrage, c'est qu'il ne me trouve absolument aucun tag.
Il me ressort tous les objets bien ordonnées j'ai des "Missing" dès qu'il s'agit d'un commentaire (j'utilise les commentaires C#).
Une idée de la propriété à modifier ?
merci
Tu utilise juste sandcastle, ou une interface genre SHFB ?
Si tu n'utilise rien, mais direct Sandcastle a la main, je te conseille de changer de methode (parce que a la main, sandcastle, c'est lourd...)
Désolé pour cette omission, j'utilise bien sandcastle helpfile builder.
Je retire ce que j'ai dit sandcastle est un très bon outil. Il faut juste penser à générer le xml dans visual studio.
Sinon je ne comprends pas pourquoi il est aussi long pour générer une documentation Html surtout si le Xml est déjà généré.
Il y a - t - il des paramètres dans Sandcastle Help File Builder qui permettent d'optimiser la génération ?
Cette lenteur serait - elle dût au Xml de Visual Studio qui n'est pas très bien fait ?
Si je me rappelle bien, la lenteur est du a la phase de linking entre les assemblys et les referencesCitation:
Sinon je ne comprends pas pourquoi il est aussi long pour générer une documentation Html surtout si le Xml est déjà généré.
Il y a - t - il des paramètres dans Sandcastle Help File Builder qui permettent d'optimiser la génération ?
Cette lenteur serait - elle dût au Xml de Visual Studio qui n'est pas très bien fait ?
Une optimisation qui fait gagner du temps est de changer SdkLinkType de Msdn a none, pour eviter des requetes a la msdn pour recuperer les references