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
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 modifOui 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: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 referencesSinon 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
Vous avez un bloqueur de publicités installé.
Le Club Developpez.com n'affiche que des publicités IT, discrètes et non intrusives.
Afin que nous puissions continuer à vous fournir gratuitement du contenu de qualité, merci de nous soutenir en désactivant votre bloqueur de publicités sur Developpez.com.
Partager