Gestion de la documentation des softs ( + fichiers d'aide Windows)

Gestion de la documentation des softs ( + fichiers d'aide Windows) - Divers - Programmation

Marsh Posté le 06-11-2002 à 11:51:59    

Personnellement j'utilise des fichiers html compilés en chm, pour des petits programmes ça va.
 
Mais ici au boulot on a actuellement d'un côté des fichiers rtf, hpj, ... gérés avec ForeHelp 98, et d'un autre côté un document Word avec le même contenu mais formaté autrement.
 
Qu'est-ce qu'y aurait comme technique pour avoir d'un côté un fichier d'aide (hlp ou chm peu importe) avec gestion des numéros de topic etc (pour l'appel depuis le programme) et d'un autre côté un fichier Word, PDF, ou similaire (destination = impression sur pages A4), tout en n'ayant les infos qu'à un endroit ?
Sachant qu'il faut pouvoir récupérer la doc actuelle, et qu'il faudrait pas un truc trop complexe à mettre en place.
Y a des softs bien pour ça ?


Message édité par antp le 06-11-2002 à 11:55:52

---------------
mes programmes ·· les voitures dans les films ·· apprenez à écrire
Reply

Marsh Posté le 06-11-2002 à 11:51:59   

Reply

Marsh Posté le 06-11-2002 à 15:13:28    

JavaDoc?  
 
On utilise un truc pour la JVCL ca permet de sortir sur n'importe quel format quasi, seul problème c'est pas gratos. (Help&Manual je pense)
Mais ils nous ont fait une donation de licence \o/


Message édité par zion le 06-11-2002 à 15:13:42

---------------
Informaticien.be - Lancez des défis à vos amis
Reply

Marsh Posté le 06-11-2002 à 15:14:52    

bide


---------------
Just because you feel good does not make you right
Reply

Marsh Posté le 06-11-2002 à 15:15:00    

Ha ?
mais faut pouvoir récupérer le contenu actuel (Le doc Word fait 130 pages [:mlc], ça donne une idée de la taille du fichier d'aide)


---------------
mes programmes ·· les voitures dans les films ·· apprenez à écrire
Reply

Marsh Posté le 06-11-2002 à 15:15:13    

DarkLord a écrit a écrit :

bide




 
:heink: on est pas sur blabla :na:


---------------
mes programmes ·· les voitures dans les films ·· apprenez à écrire
Reply

Marsh Posté le 06-11-2002 à 15:16:51    

antp a écrit a écrit :

Ha ?
mais faut pouvoir récupérer le contenu actuel (Le doc Word fait 130 pages [:mlc], ça donne une idée de la taille du fichier d'aide)




 
Copier/Coller est ton ami  :D


---------------
Informaticien.be - Lancez des défis à vos amis
Reply

Marsh Posté le 06-11-2002 à 15:57:59    

antp a écrit a écrit :

 
 
:heink: on est pas sur blabla :na:




 
 :fuck:


---------------
Just because you feel good does not make you right
Reply

Marsh Posté le 06-11-2002 à 17:07:57    

Salut,  
 
J'ai développé une solution similaire basé sur XML pour gérer la documentation et l'analyse d'une legacy app. Tout les documents dont j'ai hérité étaient sous forme de documents Word.  
 
Mise au point d'une DTD personalisée mais basée sur docBook, conversion de la doc Word en XML (d'abord par copier/coller, plus tard à l'aide de majix), développement de stylesheets XSL pour générer du HTML et du PDF (en passant par XSL:FO et Fop).  
 
Toutes les générations se font avec msXSL.exe qui permet d'utiliser le parser msXML 3 en batch et qui pèse 16Ko tout mouillé.
 
La partie la plus hardie c'est la conversion de Word/XML et il faut trouver une solution pour la maintenance de la doc si elle n'est pas faite par une personne qui puisse travailler directement dans l'XML...
 
Si tu as des ? n'hésite pas! Avander


---------------
A thing of beauty is a joy forever (John Keats)
Reply

Marsh Posté le 06-11-2002 à 17:09:12    

Et pour ce qui est des fichiers d'aide HLP/CHM :??: parce qu'on ne doit pas perdre les info contenue dans les fichiers HLP actuels, à savoir l'ID de chaque topic/page :/ C'est ça le plus gros problème...


---------------
mes programmes ·· les voitures dans les films ·· apprenez à écrire
Reply

Marsh Posté le 08-11-2002 à 15:50:41    

Reply

Marsh Posté le 08-11-2002 à 15:50:41   

Reply

Marsh Posté le 14-11-2002 à 05:06:31    

Je ne suis qu'un touriste de la documentation.
Un peu au pif, j'ai entendu parler de Doxygen http://www.stack.nl/~dimitri/doxygen/
J'ai vu aussi Litterate Programming http://www.literateprogramming.com/
 
Si ça ne résoud pas ton problème, ça peut être intéressant pour les liens.


---------------
Bricocheap: Montage de ventilo sur paté de mastic silicone
Reply

Sujets relatifs:

Leave a Replay

Make sure you enter the(*)required information where indicate.HTML code is not allowed