Discussion :

[Jeecer]

Bonjour!

j'ai commenté mon projet à l'aide de jolies balises XML, j'ai généré mon doc, et j'aimerais savoir comment le convertir en une aide lisible.

J'ai bien téléchargé Sandcastle, mais la dernière version ne veut rien savoir si je ne suis pas en framework 4.0, or avec le 2008 je suis en 3.5. Il ne veut pas reconnaitre mon projet!

J'ai bien tenté de prendre des versions plus anciennes.. qui ne fonctionne qu'avec VS 2005!

Bref grosse galère.. si quelqu'un à la solution! je suis preneur!

Merci!

[Jeecer]

Finalement Sandcastle fonctionne..
J'ai surtout du mal à l'utiliser!

Existe-t-il un tuto "simple", c'est-à-dire qui fonctionne sans qu'on ait à passer par l'invite de commande??

(Je n'en ai pas trouvé)

[tomlev]

Perso j'utilise Sandcastle Help File Builder, qui est un GUI pour Sandcastle

[Jeecer]

Yep merci! c'est ce vers quoi je me suis tourné!

Par contre je ne sais pas comment générer la doc.

J'ai créer un projet Sandcastle, puis j'ai mis le fichier XML généré par VS dans documentation source, mais il doit manquer qque chose! Sancastle ne compile pas

[Jeecer]

Il me dit dans la console :

SHFB: Error BE0035: Could not find the path to the Microsoft Sandcastle documentation compiler tools. See the error number topic in the help file for details.

[tomlev]

Il faut aussi que Sandcastle soit installé, et il faut configurer les chemins des outils
Tout est expliqué ici :
http://www.ewoodruff.us/shfbdocs/Ind...4826ce6700.htm

[Jeecer]

AAah ok!
Ah ok, donc je dois installer les deux!
ça marche merci! je teste ça!

[Jeecer]

Pourquoi ce machin est-il si compliqué!

je n'arrive vraiment pas à le faire fonctionner, malgré le site anglais et le tuto qui date tous deux de Mathusalem...
Toujours ce foutu problème de Path.. Autant j'aime beaucoup VS, et le 2010 est vraiment abouti, autant là..

Bref!

[Jeecer]

Alors j'ai une deuxième question qui peut paraitre stupide, mais la réponse peut certainement m'aider à comprendre pourquoi je n'y arrive pas!

J'ai généré mon fichier XML avec VS. Est-il possible de l'exploiter en javadoc?

[tomlev]

Je sais pas si ça va régler ton problème, mais voilà comment sont configurés les chemins chez moi (dans la section Paths des propriétés du projet) :

SandcastlePath :
C:\Program Files (x86)\Sandcastle\

HtmlHelp1xCompilerPath : (pour générer la doc au format CHM)
C:\Program Files (x86)\HTML Help Workshop\

HtmlHelp2xCompilerPath : (pour générer la doc au format VS2005/2008)
C:\Program Files (x86)\Common Files\microsoft shared\Help 2.0 Compiler\

Si tu veux juste générer la doc en HTML, je pense que seul Sandcastle est nécessaire...

Aussi, n'oublie pas de configurer la propriété HelpFileFormat (section Build), pour indiquer les formats de sortie que tu veux ; commence par essayer avec seulement HTML (Website), normalement c'est le format qui nécessite le moins d'outils externes

Regarde le projet de doc de Dvp.NET si tu veux un exemple (pas forcément un très bon exemple vu qu'il y a quelques bidouilles, mais c'est tout ce que j'ai à te proposer...)
http://projets.developpez.com/projec...ation.shfbproj

J'ai généré mon fichier XML avec VS. Est-il possible de l'exploiter en javadoc?

Euh... c'est à dire ?

[Jeecer]

Parfait parfait Merci! c'est impec!

Non mais c'était une question stupide en fait