OK, j'avais pas compris que c'était en fait pour que cela tourne sous Windows.
Personnellement, j'ai abandonné docbook car c'était trop 'chiant'. Mon opinion personnelle est que si on veut écrire des documents, il faut privilégier le texte et qu'il soit facile de baratiner des paragraphes... Or le XML est vraiment inhumain, même au niveau des paragraphe (la dessus, docbook est encore plus pénible que le XHTML).
En science, on fait quasiment tous du TeX (sauf les maso qui écrivent sous MS Office) et cela marche super bien tant sous Linux que MacOS-X, que sous Windows. Au moins, c'est un soucis en moins pour l'administrateur système.
Pour en revenir au sujet, si la doc concernant le programme est 'facile', c'est à dire n'utilise que quelques balises, pourquoi ne pas utiliser une syntaxe de type Wiki ? J'ai fait cela dans le passé en mettant toute la doc sous le format POD (doc de Perl). L'avantage est que le format POD est facile à comprendre et qu'un simple
perldoc mon_fichier_de_doc
Et on a le résultat. Encore une fois, c'est muti-OS, pérenne (le POD est à mon sens plus pérenne que pas mal de format Wiki qui traine ici ou la), simple pour l'utilisateur et ne prends pas trop de temps pour l'administrateur système.
Sinon, on utilise aussi TRAC ou SPIP pour la doc. Cela marche plutôt bien mais ne marche pas dans le TGV ;-)
[^] # Re: Comprends pas
Posté par Sytoka Modon (site web personnel) . En réponse au journal Eclipse & Docbook. Évalué à 3.
Personnellement, j'ai abandonné docbook car c'était trop 'chiant'. Mon opinion personnelle est que si on veut écrire des documents, il faut privilégier le texte et qu'il soit facile de baratiner des paragraphes... Or le XML est vraiment inhumain, même au niveau des paragraphe (la dessus, docbook est encore plus pénible que le XHTML).
En science, on fait quasiment tous du TeX (sauf les maso qui écrivent sous MS Office) et cela marche super bien tant sous Linux que MacOS-X, que sous Windows. Au moins, c'est un soucis en moins pour l'administrateur système.
Pour en revenir au sujet, si la doc concernant le programme est 'facile', c'est à dire n'utilise que quelques balises, pourquoi ne pas utiliser une syntaxe de type Wiki ? J'ai fait cela dans le passé en mettant toute la doc sous le format POD (doc de Perl). L'avantage est que le format POD est facile à comprendre et qu'un simple
perldoc mon_fichier_de_doc
Et on a le résultat. Encore une fois, c'est muti-OS, pérenne (le POD est à mon sens plus pérenne que pas mal de format Wiki qui traine ici ou la), simple pour l'utilisateur et ne prends pas trop de temps pour l'administrateur système.
Sinon, on utilise aussi TRAC ou SPIP pour la doc. Cela marche plutôt bien mais ne marche pas dans le TGV ;-)