[VB 2005] Documentation depuis fichier XML
Bonsoir tout le monde (la seconde),
Bon en faisant au mieux mon projet, je suis forcément obligé de documenter mon joli code VB.Net... jusque là rien de bien impressionnant.
Petit exemple, simple :
Code:
1
2
3
4
5
6
7
|
''' <summary>
''' Classe représentant un utilisateur actif du logiciel de facturation.
''' L'utilisateur étant autorisé par une authorité pourra utiliser l'application pour effectuer divers traitements.
''' Le service de l'utilisateur joue également un rôle primordial car il permettra de limiter les faits et gestes
''' de cet utilisateur. Chaque utilisateur n'aura pas les mêmes droits.
''' </summary> |
... à la sauce XML!
C'est bien sympa tout ça, je génère mon projet et voilà qu'un fichier .xml apparait dans mon dossier release et debug.
Bon alors ma question :
Où peut-on associer dans Visual Studio 2005 une feuille de style à ce fichier XML, je parle de fichier XSLT. J'aimerais que mon fichier soit plus lisible et surtout en format HTML.
Y a t-il un générateur de documentation style JavaDoc ou DoxyGen pour ce type de document généré par VS ? Je n'ai pas besoin ni envie de faire moi même un XSLT à ma sauce... surtout que les balises utilisées sont standards.
Voilà le contenu du fichier XML :
Code:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
...
</member><member name="T:FactDiverse.Utilisateur">
<summary>
Classe représentant un utilisateur actif du logiciel de facturation.
L'utilisateur étant autorisé par une authorité pourra utiliser l'application pour effectuer divers traitements.
Le service de l'utilisateur joue également un rôle primordial car il permettra de limiter les faits et gestes
de cet utilisateur. Chaque utilisateur n'aura pas les mêmes droits.
</summary>
<remarks>Prendre conscience que l'identifiant (CX ou U) est récupéré grâce au "logon" de l'utilisateur au domaine Citroën.</remarks>
</member><member name="M:FactDiverse.Client.#ctor(System.Int32,System.String,System.String,System.String,System.String,System.String,System.String,System.String,System.String,System.String)">
<summary>
Constructeur de la classe Client. Il construira une nouvelle instance de Client.
</summary>
<param name="identifiant">Identifiant unique du client.</param>
<param name="nom">Le nom du client.</param>
<param name="rue">Le nom de la rue et numéro de bâtiment (adresse du client).</param>
<param name="localite">Le nom de la localité du client (adresse du client).</param>
<param name="cP">Le code postal du client (adresse du client).</param>
<param name="numeroTVA">Le numéro de TVA (Taxe du la Valeur Ajoutée) du client.</param>
<param name="langue">La langue parlée du client (F, N, D, etc).</param>
<param name="pays">Le code du pays du client (adresse su client) : BE, LU, DE, FR,...</param>
<param name="statut">La statut du client : variable ou fixe (ne sera jamais écrasé par le fichier d'importation).</param>
<param name="commentaire">Le commentaire facultatif décrivant une particularité du client.</param>
<remarks>Version 1.0</remarks>
... |
Et NDoc2005 me fait des exceptions assez bizarres. Solution à mon problème ?
Merci beaucoup à toutes et à tous pour votre lecture et peut-être votre savoir ;-)
Martin :yaisse2:
