Chapitre 3. Comment obtenir les différents formats de sortie

Table des matières

En utilisant Jade / Openjade
Sous Windows
Sous Linux

En utilisant Jade / Openjade

Sous Windows

Sous Windows, c'est à peu prêt simple : il suffit de tapez la commande suivante pour avoir une sortie en HTML (sous reserve d'avoir respecter les noms des repertoires que j'ai donné lors de l'installtion, sinon il faut adapter) :

jade -t html -d c:\Docbook\html\Docbook.dsl le_fichier_source.sgm

Pour avoir une sortie en RTF, c'est quasiment pareil :

jade -t rtf -d c:\Docbook\print\Docbook.dsl test.sgm

Par contre le problème rencontré est celui des alias ... on est obligé à chaque fois de se taper le nom complet... sans la complétion automatique. Il est donc conseillé d'installer des clones de bash (ou 4DOS si ca existe encore). Car de même, on ne peut pas voir les premières erreurs si elle sont trop nombreuses. Voila plein de raison de préférer l'utilisation de Docbook et jade sous Linux. Cela vous permettera en plus d'avoir des sorties au format LateX.

Sous Linux

Sous Linux, c'est tout simple : il suffit d'invoquer jade avec le type de sortie souhaitée, et l'emplacement de la feuille de style. Les principales sorties sont en RTF ou en HTML.

Pour le rtf, il suffira donc de taper la commande suivante : jade -t rtf -d /usr/share/sgml/Docbook/dsssl-stylesheets-1.57/print/Docbook.dsl le_fichier_source.sgml Il se peut cependant que le chemin ne soit pas le même pour votre distribution. Il suffira de localiser le repertoire contenant les feuille de style. Le sous-repertoire s'appelle print et la feuille de style Docbook.dsl.

Pour le html, il faut savoir que jade ne permet pas de faire en sortie du html, mais uniquement du sgml, la ligne de commande se ressemble, il suffit de préciser dans le type sgml (attention html ne fonctionnera pas) et la feuille de style se trouve dans le sous repertoire html. La commande sera donc : jade -t sgml -d /usr/share/sgml/Docbook/dsssl-stylesheets-1.57/html/Docbook.dsl le_fichier_source.sgml

Un petit conseil pour finir, comme le chemin n'est pas forcement simple à se souvenir, il peut être interressant de faire deux alias jadertf et jadesgml en ajoutant ces deux lignes dans ~/.bashrc :

alias jhtml='jade -t sgml -d /usr/share/sgml/Docbook/dsssl-stylesheets-1.57/html/Docbook.dsl'
alias jrtf='jade -t rtf -d /usr/share/sgml/Docbook/dsssl-stylesheets-1.57/print/Docbook.dsl'

vous n'aurez ensuite qu'à taper : jadehtml le_fichier_source.sgml ou jadertf le_fichier_source.sgml

Sous linux, sous réserve d'installer jadetex, on peut obtenir une sortie postscript du document Docbook. En effet, la sortie obtenue sera beaucoup plus propre pour imprimer et ne nécessitera pas de visualisateur rtf. Il ne faut pas se tromper car jadetex contrairement au alias ne convertis pas le document en Latex, il faut le faire d'abord avec jade. On va donc créer un alias jtex de la facon suivante :

alias jtex = 'jade -t tex -d /usr/share/sgml/Docbook/dsssl-stylesheets-1.57/print/Docbook.dsl'

On peut donc ensuite créer le fichier latex : jtex le_fichier_source.sgml Ensuite il ne faut pas utiliser latex sur le fichier créé, mais jadetex le_fichier_source.tex. Pour ma part, j'ai des erreurs sur des références non définies ... mais le fichier est valide. Je pense que cela vient des liens hypertextes. Ensuite vous pouvez convertir le fichier de sortie en Postscript avec la commande suivante : dvips -o le_fichier_source.ps le_fichier_source.dvi. Puis enfin visualiser le resultat : gv le_fichier_source.ps