On Mon, Apr 23, 2001 at 11:57:49PM +0200, Jean-Luc et Anna-Maria Donnadieu wrote:

> > Je fais tout à partir du XML à la place: il y a plus de souplesse ainsi

> > et j'ai jamais trop apprécié les logiciels de transformations

> > tex->html... c'est généralement du bizounage pas très solide.

> > 

> > Pour information (attention, je deviens technique là), voici un peu

> > l'arbre de transformations:

> > 

> > XML+DSL -->{jade}--> HTML -->{HTML2TEXT}--> Text

> >                  |        +-> {html2ps} --> PS

> >                  +-> TeX  --> {jadetex} --> DVI -->{dvips} --> PS

> >                  |                      +-> PDF -->{ps2pdf}--> PS

> >                  +-> RTF

> > 

> > Ça demande toutefois pas mal de matériels installés:

> > ...

> > apt-get install task-sgml make w3m xfig gs

> > ...

> 

> Je me suis mis a la debian, et je vais essayer d'utiliser jade. Mais

> j'ai du mal a debuter. J'ai telecharge les sources des arpeges, j'ai

> tape make, et j'ai tout un tas de formats qui ont ete generes, c'est

> super !

> Maintenant, j'ai du pain sur la planche pour comprendre le

> fonctionnement ;-)

Tout est dans le fichier Makefile.rules qui peut-être pratiquement

utilisé comme tel pour un autre projet similaire.  Tu y trouveras les

lignes de commandes nécessaire pour faire les transfo.  Avec le schéma

ci-dessus, tu devrais être capable de t'y retrouver... Et rappelle-toi,

man et /usr/share/doc/package sont tes amis!

L'autre partie de la magie est dans les fichiers .dsl et dans le

répertoire dtd. Voici une petite description de chacun:

print.dsl:  Fichier DSSSL contenant les instructions pour formatter

les éléments XML dans une version imprimable (TeX, PS, PDF).  C'est du

scheme principalement, avec quelques primitives supplémentaires.   Ca

vaut la peine de lire la doc fourni dans le paquet

docbook-stylesheets-doc pour s'y retrouver un peu.  Il donne un bon

exemple sur comment ajouter un formattage spécial lorsqu'on ajoute un

élément à Docbook (en l'occurence les éléments complist et comp).

html.dsl:  Meme chose que print.dsl, mais comme le html est une forme de

SGML (comme le XML), c'est plus des instructions de transformations

(transformer un <emphasize>...</emphasize> en <em>...</em>).  Le

principe est donc un peu différent.  Même paquet pour la doc.

arpeges.dtd:  Fichier principal qui se contente d'inclure les autres DTD

(Document Type Description).  C'est ça qui va définir qu'est-ce qui est

permis et qu'est-ce qui l'est pas.

comp.dtd:  Ajout des éléments complist et comp à docbook.  Un bon

exemple de comment augmenter docbook avec ces propres définitions.  Le

paquet docbook-doc donne plus d'infos là-dessus, ainsi que Docbook, the

definitive guide chez O'Really (aussi disponible sur le net sur

www.docbook.org!).  Le livre est une excellente référence.

struct.dtd:  Définition des fichiers des Arpèges.  Dans la version

courante, tu retrouveras une inclusion conditionnelle:  c'est la version

simplifié des arpèges, dans laquelle de nombreux fichiers sont exclus

(simplement en les faisant pointer vers /dev/null).  Note que tu peux

définir deux fois la même entité mais seule la PREMIÈRE définition (pas

de redéfinition possible!) est prise en compte (ce qui permet de faire

un parser en une seule passe)... C'est pourquoi l'ordre d'inclusion est

très important.

terms.dtd:  Définition d'abbréviations.  En fait, très peu sont des

abbréviations... Ce sont plus des termes que je veux garder afin de les

retrouver plus facilement s'il change.  J'ai mis quelques abrégés connus

(&mj; => meneur du jeu) mais l'expérience m'a montré qu'à la longue,

c'était bon d'éviter d'en faire trop et que c'était plus facilement

lisible ainsi.  De plus, avec un éditeur comme Emacs et le mode PSGML,

c'est pas plus long à écrire.  La touche miracle?  Ctrl-/ qui complète

un mot à partir des mots déjà écrit.  Par exemple, si tu as déjà écrit

une fois &Competence;, tu n'as qu'à faire &Com<CTRL-/> et il va te

trouver la première occurence d'un mot qui commence par &Com... Si c'est

pas le bon, C-/ à nouveau et tu passes au suivant.  Chouette, n'est-ce

pas.  Si tu préfères Vim, dans le mode d'insertion, c'est C-N (en mode

insertion) qui fait un truc semblable.  ':help completion' pour les

autres raccourcis.

Le reste, c'est du SGML bien standard, du texte.

Toutefois, j'avoue sans humilité que les Arpèges sont un exemple

intéressant des capacités des Arpèges.

> Connais-tu une bonne adresse pour trouver de la doc ?

Pour le XML, XMLfr.org est excellent et contient beaucoup de tutoriels

en français.  Par contre, ça parle beaucoup des XPath, XSL et tout le

reste, dont les outils sont encore plutôt bêta (et principalement en

Java en plus; très lourd pour ma machine donc).  Même chose pour

www.xml.org et www.w3.org.  Le paquet wdg-html-reference contient

plusieurs des documents (standards) qu'on retrouve sur le site de

w3.org.  Mais c'est un peu lourd parfois comme lecture.  À utiliser plus

comme référence.

J'utilise présentement du DSSSL pour les Arpèges qui est du Scheme avec

des primitives pour l'impression.  Le site de Normand Walsh

(www.nwalsh.com) et celui de James Clark (www.jclark.com) contiennent

beaucoup d'infos et tutoriel à ce niveau mais la spec elle-même est peu

digestible.  Si tu as le courage et que tu es prêt à faire des

tentatives, Norman Walsh a déjà un docbook-stylesheets en XSL ainsi que

des instructions à ce sujet sur son site.  D'excellents livres à ce

sujet ainsi que sur le XML.  J'ai bien apprécié the XML companion ainsi

que the XSL companion chez Addison Wesley.  Ce dernier peut aussi

fournir une bonne introduction au modèle de mise-en-page utiliser pour

le DSSSL (et les CSS) puisque c'est pratiquement le même avec des

primitives presque identiques.  Il y'a aussi the XML Blackbook chez

Coriolis qui semble aussi bien fourni.

Finalement, il y a aussi le site de openjade.sourceforge.net.  Je n'ai

toutefois pas encore essayé ce dernier mais les dernières nouvelles (qui

sont quand même assez vieille) indiqué l'introduction de quelques

incompabilité avec jade standard... c'est donc à tes risques.

> 

> Jean-Luc

Bonne chance!  Moi, il me reste juste à mettre tout ça dans un fichier

HACKING pour ne pas avoir à le réécrire la prochaine fois ;) A+ et

bienvenue sur Debian...

En passant, si tu as upgradé sur woody, un petit package bien cool et

pratique pour faire le ménage: debfoster...  ça ajoute le petit rien qui

manquait à apt pour en faire mon package tool de rêve.  C'est d'ailleurs

probablement recompilable sur potato (dépendance sur libc seulement)...

Faudrait que j'y vois.  http://packages.debian.org/debfoster pour plus

d'infos.

Fabien

-- 

-------------------------------*  *-------------------------

Fabien Niñoles                /  /          fabien@tzone.org

Chevalier Servant de Sa Dame /  /   C15D FE9E BB35 F596 127F

Veneur Gris par la Clef     /  /    BF7D 8F1F DFC9 BCE0 9436

Développeur pour Debian    /  / http://www.tzone.org/~fabien

--------------------------*  *------------------------------