Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] jw, docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt - (Jade Wrapper) assurent la conversion de documents SGML vers d'autres formats (masquant l'action de Jade). [size=18] [b]Résumé[/b] [/size] [b]jw[/b] [ [b]-f[/b] [i]frontend[/i][b][/b] \| [b]--frontend[/b] [i]frontend[/i][b][/b] ] [ [b]-b[/b] [i]backend[/i][b][/b] \| [b]--backend[/b] [i]backend[/i][b][/b] ] [ [b]-c[/b] [i]fichier[/i][b][/b] \| [b]--cat[/b] [i]fichier[/i][b][/b] ] [ [b]-n[/b] \| [b]--nostd[/b] ] [ [b]-d[/b] [i]fichier[/i][b]\|default\|none[/b] \| [b]--dsl[/b] [i]fichier[/i][b]\|default\|none[/b] ] [ [b]-l[/b] [i]fichier[/i][b][/b] \| [b]--dcl[/b] [i]fichier[/i][b][/b] ] [ [b]-s[/b] [i]chemin[/i][b][/b] \| [b]--sgmlbase[/b] [i]chemin[/i][b][/b] ] [ [b]-p[/b] [i]programme[/i][b][/b] \| [b]--parser[/b] [i]programme[/i][b][/b] ] [ [b]-o[/b] [i]répertoire[/i][b][/b] \| [b]--output[/b] [i]répertoire[/i][b][/b] ] [ [b]-V[/b] [i]variable[/i][b][=[/b][i]valeur[/i][b]][/b] ] [ [b]-u[/b] \| [b]--nochunks[/b] ] [ [b]-i[/b] [i]section[/i][b][/b] \| [b]--include[/b] [i]section[/i][b][/b] ] [ [b]-w[/b] [i]type[/i][b]\|list[/b] \| [b]--warning[/b] [i]type[/i][b]\|list[/b] ] [ [b]-e[/b] [i]type[/i][b]\|list[/b] \| [b]--error[/b] [i]type[/i][b]\|list[/b] ] [ [b]-h[/b] \| [b]--help[/b] ] [ [b]-v[/b] \| [b]--version[/b] ] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2dvi[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2html[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2man[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2pdf[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2ps[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2rtf[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2tex[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2texi[/b] [b][/b][i]fichier-SGML[/i][b][/b] [b]docbook2txt[/b] [b][/b][i]fichier-SGML[/i][b][/b] [size=18] [b]Description[/b] [/size] Le script shell [b]jw[/b] permet de convertir un fichier DocBook (ou tout autre format basé sur le SGML) vers d'autres formats (incluant HTML, RTF, PS et PDF) avec une syntaxe facile à comprendre. Il masque la part complexe de Jade ou d'OpenJade et apporte de confortables fonctionnalités. D'autres scripts comme [b]docbook2html[/b], [b]docbook2rtf[/b] ou [b]docbook2ps[/b] fournissent des manières différentes d'appeler [b]jw[/b] qui peuvent être plus aisées à retenir. Pour le moment, jw ne traite pas le XML, seulement le SGML. Cet utilitaire présume que plusieurs autres composants soient installés. La liste inclut : [table][row][col]    [/col][col](bu l'entité caractère ISO pour SGML[/col][/row][/table] [table][row][col]    [/col][col](bu le moteur DSSSL de James Clark, jade, ou un analyseur syntaxique comme OpenJade[/col][/row][/table] [table][row][col]    [/col][col](bu la DTD DocBook du consortium OASIS[/col][/row][/table] [table][row][col]    [/col][col](bu les feuilles de style modulaires DocBook de Norman Walsh (ou d'autres jeux de feuilles de style DSSSL)[/col][/row][/table] [table][row][col]    [/col][col](bu l'ensemble jadetex, de Sebastian Rahtz, de macros TeX pour jade (pour les backends prévus pour des formats d'« impression » comme PDF, RTF ou PostScript)[/col][/row][/table] [table][row][col]    [/col][col](bu un interpréteur perl (pour les backends qui utilisent perl)[/col][/row][/table] [table][row][col]    [/col][col](bu le module perl SGMLSpm du CPAN (pour les backends qui utilisent sgmls)[/col][/row][/table] [table][row][col]    [/col][col](bu le navigateur HTML Lynx (pour le backend [i]txt[/i])[/col][/row][/table] le script jw se lance essentiellement comme ceci : .nf jw mon_doc.sgml .fi où [i]mon_doc.sgml[/i] est un fichier SGML. La ligne de commande ci-dessus utilise les options par défaut : elle convertit à partir de DocBook (le frontend par défaut) vers HTML (le backend par défaut), ne met pas le résultat dans un sous-répertoire (à moins que cela ne soit spécifié autrement dans les feuilles de style), etc. Dans cet exemple, le nom de fichier « mon_doc » aussi bien que l'extension « .sgml » peuvent être remplacés par n'importe quoi d'autre. Les extensions actuelles pour les fichiers DocBook SGML incluent « .sgml », « .sgm », « .docbook », et « .db ». Le fichier traité [i]mon_doc.sgml[/i] peut se trouver dans tout autre répertoire que le répertoire courant. Ici, nous avons choisi de générer une sortie HTML. En fait, nous pouvons utiliser n'importe lequel des backends stockés dans le sous-répertoire du répertoire de la distribution DocBook-utils (habituellement [i]/usr/share/sgml/docbook/utils-0.6.14[/i]). De la même manière, vous pouvez utiliser chacun des frontends définis dans le sous-répertoire [i]frontends/[/i] pour convertir à partir d'un autre format d'entrée. Cette commande échantillon crée un ou plusieurs fichiers HTML avec des noms de fichier arbitraires dans le répertoire courant. Ce fonctionnement par défaut peut être modifié à travers des options de la ligne de commande et/ou une personnalisation des feuilles de style. [size=18] [b]Options[/b] [/size] Les options suivantes sont applicables au script de conversion : [table][row][col]    [/col][col][b][/b] -f [i]frontend[/i][b][/b] \| --frontend [i]frontend[/i][b][/b] Permet de spécifier un autre frontend que celui par défaut [i]docbook[/i]&. La liste des frontends actuellement disponible est :[table][row][col]    [/col][col][/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]docbook[/i][b][/b] Convertit docbook avec les feuilles de style de Norman Walsh. Ce frontend cherche, dans les sous-répertoires du répertoire SGML de base, un fichier nommé [i]html/docbook.dsl[/i] ou [i]print/docbook.dsl[/i] (suivant le type de backend : html ou print).[/col][/row][/table][/col][/row][/table] [table][row][col]    [/col][col][b][/b] -b [i]backend[/i][b][/b] \| --backend [i]backend[/i][b][/b] Permet de spécifier un autre backend que celui par défaut [i]HTML[/i]&. La liste des backends actuellement disponible est :[table][row][col]    [/col][col][/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]dvi[/i][b][/b] Convertit vers DVI (fichier DeVice Independant) en appelant [b]Jade[/b] ou [b]OpenJade[/b]&.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]html[/i][b][/b] Convertit vers HTML (HyperText Markup Language) en appelant [b]Jade[/b] ou [b]OpenJade[/b]&.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]man[/i][b][/b] Convertit une « refentry » vers une page de manuel Unix en appelant docbook2man. Ne fonctionne pas avec des types de documents SGML autres que DocBook.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]pdf[/i][b][/b] Convertit vers PDF (Portable Document Format) en appelant [b]Jade[/b] ou [b]OpenJade[/b]&.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]ps[/i][b][/b] Convertit vers PostScript en appelant [b]Jade[/b] ou [b]OpenJade[/b]&.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]rtf[/i][b][/b] Convertit vers RTF (Rich Text Format) en appelant [b]Jade[/b] ou [b]OpenJade[/b]&. Le fichier résultant peut être ensuite importé dans [b]MS[/b] Word ou un de ses programmes de remplacement sous Linux.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]tex[/i][b][/b] Convertit vers TeX en appelant [b]Jade[/b] ou [b]OpenJade[/b]&.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]texi[/i][b][/b] Convertit vers des pages GNU TeXinfo en appelant docbook2texi. Ne fonctionne pas avec des types de documents SGML autres que DocBook.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]txt[/i][b][/b] Convertit vers un fichier texte nu en appelant [b]Jade[/b] ou [b]OpenJade[/b], puis [b]Lynx[/b]&.[/col][/row][/table][/col][/row][/table] [table][row][col]    [/col][col][b][/b] -c [i]fichier[/i][b][/b] \| --cat [i]fichier[/i][b][/b] Permet d'utiliser un Catalogue Ouvert SGML supplémentaire qui listera d'autres fichiers comme des feuilles de styles personnalisées, des adaptations de la Définition de Type de Document DocBook (NdT : DocBook Document Type Definition ou DocBook DTD), des entités de caractères spéciaux, etc. Ce catalogue est ajouté à la liste des catalogues déterminée par le script (voir l'option [b]--nostd[/b] ci-dessous)[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -n \| --nostd Ne pas utiliser les Catalogues Ouverts SGML standards. Normalement, la liste des catalogues standards est déterminée comme suit :[table][row][col]    [/col][col][/col][/row][/table] [table][row][col]    [/col][col](bu si le catalogue centralisé existe, alors l'utiliser. Le catalogue centralisé est une liste de tous les catalogues qui peuvent être nécessaires et qui se situent habituellement dans [i]/etc/sgml[/i]&. Son nom est fourni par le frontend, par exemple le frontend [i]docbook[/i] renvoie [i]/etc/sgml/sgml-docbook.cat[/i]&.[/col][/row][/table] [table][row][col]    [/col][col](bu Autrement, prend tous les fichiers nommés [i]catalog[/i] dans les sous-répertoires du répertoire de base SGML (habituellement [i]/usr/share/sgml[/i]).[/col][/row][/table] Cette option est utile conjointement avec l'option [b]--cat[/b] pour utiliser seulement les catalogues spécifiés sur la ligne de commande[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -d [i]fichier[/i][b]\|default\|none[/b] \| --dsl [i]fichier[/i][b]\|default\|none[/b] Permet d'utiliser une feuille de style personnalisée à la place de celle par défaut. Une « cible », débutant par un signe dièse « # », peut être ajoutée au nom du fichier. Le résultat sera que seule la partie correspondante de la feuille de style sera exécutée (la « spécification de style » dont l'« identificateur » est égal au nom de la cible). Une utilisation ordinaire de ce mécanisme est de définir les cibles « #html » et « #print » pour déclencher la partie correspondante d'une feuille de style de remplacement qui est commune aux conversions HTML et sortie d'impression. En remplaçant le nom du fichier par « default », la feuille de style fournie avec le frontend est utilisée. Par exemple, le frontend [i]docbook[/i] renvoie [i][/i]&./docbook.dsl#html (ou [i][/i]&./docbook.dsl#print) dans le répertoire de base SGML. En remplaçant le nom du fichier par « none », aucune feuille de style de remplacement n'est utilisée, pas même la feuille de style par défaut. La feuille de style qui sera utilisée est alors déterminée par le frontend. Par exemple, le frontend [i]docbook[/i] renvoie le [i]html/docbook.dsl[/i] (ou [i]print/docbook.dsl[/i]) de Norman Walsh trouvé quelque part dans le répertoire de base SGML. Si aucune option --dsl n'est spécifiée, alors « --dsl default » est utilisée.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -l [i]fichier[/i][b][/b] \| --dcl [i]fichier[/i][b][/b] Permet d'utiliser une déclaration SGML personnalisée plutôt que celle par défaut. Le nom du fichier de la déclaration SGML par défaut n'est pas fixé pour les fichiers SGML, mais est fixé à [i]xml.dcl[/i] dans le répertoire de base SGML pour les fichiers XML.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -s [i]chemin[/i][b][/b] \| --sgmlbase [i]chemin[/i][b][/b] Permet d'utiliser une autre localisation pour le répertoire de base SGML. C'est dans ce répertoire que sont installées toutes les DTDs SGML, feuilles de style, entités, etc. La valeur par défaut est [i]/usr/share/sgml[/i].[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -p [i]programme[/i][b][/b] \| --parser [i]programme[/i][b][/b] Spécifie l'analyseur syntaxique à utiliser ([b]Jade[/b] ou [b]OpenJade[/b]) si plusieurs sont installés. Si cette option n'est pas spécifiée, le script essaie d'abord d'utiliser Jade, ensuite il essaie [b]OpenJade[/b]&.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -o [i]répertoire[/i][b][/b] \| --output [i]répertoire[/i][b][/b] Fixe le répertoire de sortie où tous les fichiers résultants seront enregistrés. Si les feuilles de style définissent également un sous-répertoire où les fichiers résultants doivent être enregistrés, alors le sous-répertoire défini par les feuilles de style sera placé dans le sous-répertoire défini par cette option.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -V [i]variable[/i][b]=[[/b][i]valeur[/i][b]][/b] Fixe une variable (à une valeur, si celle-ci est spécifiée).[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -u \| --nochunks Produit un gros fichier unique. Cette option est utile seulement pour générer du HTML, car la sortie peut être partagée dans plusieurs fichiers. Cette option annule la configuration qui a pu être réalisée dans les feuilles de style.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -i [i]section[/i][b][/b] \| --include [i]section[/i][b][/b] Déclare une section marquée SGML comme « include ». Une section marquée SGML est une sorte de partie conditionnelle d'un document. Si elle est déclarée « ignore », elle sera ignorée, autrement, elle sera traitée. Un exemple de telle section marquée peut être :[/col][/row][/table] .nf <DOCTYPE mon_doc [ <!ENTITY % confidentiel "ignore"> ]> <mon_doc> ... <![ %confidentiel [ Du texte confidentiel... ]]> ... </mon_doc> .fi [table][row][col]    [/col][col][b][/b] -w [i]type[/i][b]\|list[/b] \| --warning [i]type[/i][b]\|list[/b] Active ou désactive l'affichage de types donnés d'avertissements. Plusieurs options -w peuvent être entrées sur la ligne de commande. Les types d'avertissements qui commencent par « no- » désactivent les avertissements correspondants, les autres types les activent. Si le type d'avertissement est remplacé par « list », alors une liste des types d'avertissements autorisés est affichée.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -e [i]type[/i][b]\|list[/b] \| --error [i]type[/i][b]\|list[/b] Désactive les types donnés d'erreurs. Plusieurs options -e peuvent être entrées sur la ligne de commande. Tous les types d'erreurs commencent par « no- ». Si le type d'erreur est remplacé par « list », alors une liste des types d'erreurs autorisées est affichée.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -h \| --help Affiche un court message d'aide et quitte.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -v \| --version Affiche l'identificateur de version et quitte. [/col][/row][/table] [size=18] [b]Fichiers[/b] [/size] [table][row][col]    [/col][col][b][/b][i]/etc/sgml/sgml-docbook.cat[/i][b][/b] Le catalogue ouvert SGML centralisé. Ce nom de fichier peut varier si un autre frontend que [i]docbook[/i] est utilisé.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]/usr/share/sgml/docbook/utils-0.6.14/backends[/i][b][/b] Les différents backends.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]/usr/share/sgml/docbook/utils-0.6.14/frontends[/i][b][/b] Les différents frontends.[/col][/row][/table] [table][row][col]    [/col][col][b][/b][i]/usr/share/sgml/docbook/utils-0.6.14/helpers[/i][b][/b] Les différents scripts assistants comme docbook2man ou docbook2texi. [/col][/row][/table] [size=18] [b]Auteurs[/b] [/size] Éric Bischoff (le script shell jw et quelques backends), Jochem Huhmann (les backends [i]man[/i] et [i]texi[/i]) [size=18] [b]Traduction[/b] [/size] Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> 12 février 2003 et révisée le 19 novembre 2004. L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « [b]LANG=en[/b] man 1 jw ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel. [size=18] [b]Voir aussi[/b] [/size] [b]docbook2man-spec.pl[/b](1), [b]docbook2texi-spec.pl[/b](1), [b]install-catalog[/b](8), [b]nsgmls[/b](1), page d'accueil docbook-utils <URL:http://sources.redhat.com/docbook-tools/>.
Fichier