On Thursday  7 December 2000 08:08 +0000, Thomas NOEL wrote:
> 
> Une solution serait plutot d'utiliser DocBook. Pour cela, regarder du cot�
> de chez Gnome, c'est avec �a qu'ils font leurs doc. Ca marche bien, c'est
> joli, �a sort en html, ps, pdf... avec des images.
> 
> Quelques URLs :
> http://developer.gnome.org/arch/doc/
> http://www.labs.redhat.com/whitepapers/tutorial/
> 

�a a l'air pas mal, mais nettement plus complexe que debiandoc.
L'avantage de ce dernier, c'est qu'il utilisait des commandes toutes
b�tes (debiandoc2XXX) pour convertir facilement les docs. Et qu'il y
avait un tutorial simple pour apprendre � l'utiliser.

Merci pour les URL, �a � l'air sympa.

En SGML pur, je n'y comprend rien... Entre les jade, DSSSSSSSSSSL,
DTD, sgmltools v1 et v2, linuxdoc, et autres joyeuset�s, pour r�ussir
� comprendre de quoi on parle et � convertir mon .sgml en .autrechose
c'est la croix et la banni�re...

> Je crois qu'il existe une version XML, en plus, ce qui est encore plus
> chouette (pas de transformation dsssl horribles � programmer). 
> Il y a aussi une version alleg�e de DocBook... Voir tout �a sur :
> http://www.docbook.org/
> 

Je vais peut-�tre me mettre � DocBook, malgr� mes r�ticences de
d�part. Pour l'instant, je n'ai pas un besoin pressant d'images ; ce
serait simplement un plus. Mais plus tard, si j'en ai besoin, j'ai pas
envie de r�apprendre un nouveau type de document.  En plus, l'avantage
de DocBook, c'est qu'il a l'air plus g�n�rique que DebianDoc. Ce qui
peut �tre pratique...

PS : franchement, faut avoir le moral pour faire du SGML. <mode flame
war> � c�t�, TeX a presque l'air simple </mode flame war> :) Sans
compter que la doc est on ne peut plus foutoir...  J'ai plus qu'�
essayer de convertir comme un malade.  Y'aurait pas un petit
debiandoc2docbook ? :)


-- 
Alexandre Vitrac
CS SI


Répondre à