Discussion :

[YuGiOhJCJ]

Bonjour,

la documentation sur la bibliothèque de classes .NET Framework[1] est disponible en ligne via le site de Microsoft.

Je développe en utilisant le compilateur mono[2] sous un système d'exploitation GNU/Linux[3][4].

Je ne connais pas par coeur le nom des classes, méthodes, constructeurs, namespaces de la bibliothèque de classes .NET Framework. Donc j'ai souvent besoin de me connecter au site de Microsoft pour lire la documentation.

Mais je n'ai que rarement accès à Internet lorsque je développe. Donc je me retrouve souvent sans documentation et je suis coincé.

Avec Java, je parviens à télécharger l'API Java[5] sur le site d'Oracle (sous la forme d'une archive zip de 56.4MB contenant pleins de fichiers HTML).

Avec Dotnet, je me connecte au site de Microsoft et j'imprime mes pages préférées dans un fichier PDF. C'est très long à faire et je ne dispose pas de l'intégralité de la documentation (je ne l'ai fait que pour les classes, méthodes, constructeurs, namespaces que j'utilise le plus souvent).

Donc ma question est simple : comment récupérer (comme pour l'API Java) la documentation complète la bibliothèque de classes .NET Framework afin de la consulter hors ligne?

Merci.

[1] http://msdn.microsoft.com/en-us/library/w0x726c2.aspx
[2] http://www.mono-project.com/
[3] http://www.gnu.org/
[4] http://www.kernel.org/
[5] http://www.oracle.com/

[BenoitM]

installer visual studio

sinon c'est pas compris quand tu télécharge le sdk?

[tomlev]

Tu peux télécharger la MSDN library ici :
http://www.microsoft.com/downloads/f...displayLang=fr

[YuGiOhJCJ]

tomlev>Je viens de télécharger l'ISO de 2Go grâce à ton lien. Il y a un installeur que j'ai lancé. Ensuite, je me retrouve avec un logiciel installé qui s'appelle "Microsoft Document Explorer". Grâce à lui, je peux naviguer dans la documentation et retrouver la documentation sur la bibliothèque de classes .NET Framework (disponible sur le site de Microsoft).
Le problème c'est que c'est super complexe. Ca semble passer par un protocole appelé "ms-help". Je dispose de fichiers .hxs dans le dossier d'installation MSDN/MSDN9.0/1036. Impossible de lire ça avec mon navigateur web habituel.
Cette documentation n'existerait pas au format HTML comme avec l'API Java?

BenoitM>Je vais tester avec la version d'évaluation de Visual Studio 2008 Professionnel. Je vais aussi essayer avec le SDK. Par contre est-ce que j'aurai des fichiers HTML ou des fichiers .hxs?

Le format HXS (comme le format CHM) est un format HTML compressé que je peux décompresser avec un utilitaire (j'ai décompressé un HXS avec 7zip).
D'ailleurs, j'ai l'impression que le fichier HXS contenant la documentation sur la bibliothèque de classes .NET Framework se nomme : "dv_fxgenrefhxs.hxs".
Il contient un dossier HTML de 666 fichiers HTML (666! Ça ne vous rappelle pas quelqu'un?)

Le problème c'est que les fichiers HTML portent des noms pas vraiment "human readable" (exemple "00a8a761-4a45-493b-82d0-241b344be1ef.htm").
Donc il me faudrait écrire un script qui analyse chaque fichiers HTML, récupère des informations permettant de donner un nom plus sympathique au fichier. Je ne suis pas certain que je vais avoir le temps pour ça... Je laisse tombé l'affaire. Je vais me contenter de ma technique manuelle pour l'instant.

Avez-vous une meilleure idée pour récupérer cette documentation au format HTML?

[tomlev]

Je ne pense pas que cette doc existe au format HTML, sauf en ligne bien sûr...

Par contre j'ai pas compris pourquoi tu te prenais la tête avec les fichiers HxS... normalement tu as pas à t'en préoccuper pour utiliser la doc

[YuGiOhJCJ]

C'est juste que j'essaye de récupérer la documentation au format HTML (pour éviter d'utiliser Microsoft Document Explorer) alors j'ai étudié le format dans lequel était encodé la documentation. C'est le format HXS. J'aurai préféré un format plus simple car je travaille sous un système GNU/Linux et je souhaitais utiliser mon navigateur web ou mon lecteur PDF pour lire cette documentation...