Gestion de la documentation des softs ( + fichiers d'aide Windows) - Divers - Programmation
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/
Marsh Posté le 06-11-2002 à 15:14:52
bide
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 , ça donne une idée de la taille du fichier d'aide)
Marsh Posté le 06-11-2002 à 15:15:13
DarkLord a écrit a écrit : bide |
on est pas sur blabla
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 , ça donne une idée de la taille du fichier d'aide) |
Copier/Coller est ton ami
Marsh Posté le 06-11-2002 à 15:57:59
antp a écrit a écrit : on est pas sur blabla |
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
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...
Marsh Posté le 08-11-2002 à 15:50:41
ReplyMarsh 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.
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