Discussion :

[kedare]

Hello ,
je voudrais realiser quelques documentation en rapport avec la programmation ,
mais je ne sait pas quelle langage choisir pour les structurer ...
j'aimer soit que ca ressorte en pdf ou en html
donc j'hésite entre ces 3 langages :
- Html+css
- LaTeX
- lout

que me conseillez vous ?
sachant que je serais interessé par la possibiliter d'include des blocs de code (avec coloration de la syntax si possible) et que je cherche quelque chose de complet et d'extensible
voila merci

[GnuVince]

Hello ,
je voudrais realiser quelques documentation en rapport avec la programmation ,
mais je ne sait pas quelle langage choisir pour les structurer ...
j'aimer soit que ca ressorte en pdf ou en html
donc j'hésite entre ces 3 langages :
- Html+css
- LaTeX
- lout

que me conseillez vous ?
sachant que je serais interessé par la possibiliter d'include des blocs de code (avec coloration de la syntax si possible) et que je cherche quelque chose de complet et d'extensible
voila merci

Quel langage de programmation? Dans le Perl, les gens utilisent POD, en Ruby c'est RDoc, Python c'est ReST, etc. La plupart de ces outils ont des mécanismes d'exportation vers le HTML, le LaTeX (pour faire des PDF), etc.

[kedare]

bah .. c'est pas une doc de "librairie" que je veut faire , pas comme ce que genere la rdoc ,
c'est plus quelque chose comme ce qu'on peut trouver par exemple dans le cours de Swinnen (python) , et des tutorials

[GnuVince]

bah .. c'est pas une doc de "librairie" que je veut faire , pas comme ce que genere la rdoc ,
c'est plus quelque chose comme ce qu'on peut trouver par exemple dans le cours de Swinnen (python) , et des tutorials

ReST

[cavo789]

J'ai posé cette même question il y a trois mois d'ici, sur ce même forum;-)

Depuis, j'ai fait l'acquisition de Fast-Help. C'est un programme commercial, peu cher et super bien fait.

Tu peux générer un DOC, PDF, HMTL, HMW, ...

J'en suis super content.

[Anthony.Desvernois]

LaTeX sans éditer. Le package listings permet d'inclure du code et d'avoir la coloration syntaxique (la liste des langages supportés est énorme et tu peux tout paramétrer). Par contre il faut se mettre à LaTeX