= Le format Docbook = Le format D''''''ocBook est un format de texte balisé (comme le HTML), se concentrant sur la sémantique, contrairement au HTML qui se concentre sur la présentation. <> == Le format DocBook lui-même == * Le [[Guides_pratiques/Suivi/DocBook-Demystification-HOWTO/Document|Comprendre Docbook]] - un guide pratique de synthèse expliquant le format DocBook et les outils qui l'accompagnent. * Le [[http://opensource.bureau-cornavin.com/crash-course/fr/index.html|Écrire de la documentation en utilisant DocBook]] (cours accéléré) de David Rugge, Mark Galassi, Éric Bischoff, traduit en français par Marc Blanc. * Le [[http://tdg.docbook.org/tdg/4.5/docbook.html|Livre de référence du format Docbook version 4.5]] (en anglais) par Norman Walsh et Leonard Muellner. Ce livre offre notamment un [[http://tdg.docbook.org/tdg/4.5/part2.html|dictionnaire complet des balises Docbook]]. C'est un document de référence indispensable. * Le [[http://feloy.free.fr/doc2book/html/index.html|manuel Docbook]] (un peu ancien) de Philippe Martin. * La [[http://feloy.free.fr/dbrefcard.pdf|carte de référence DocBook]] de Philippe Martin. Cette carte est pour l'instant limitée à une partie du format D''''''ocBook, mais elle devrait être étendue à l'avenir. * Le [[https://l10n.kde.org/docs/doc-primer/docbook-reference.html|Guide DocBook du projet KDE]] (en anglais) qui liste quelques règles de bonne pratique pour l'écriture des balises D''''''ocBook. == Guides généralistes == * Le [[http://www.tldp.org/LDP/LDP-Author-Guide/|Guide des auteurs]] du Projet de documentation Linux (en anglais). * Le [[https://github.com/docbook/wiki/wiki|Wiki DocBook]] (en anglais). * Le [[http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html|Guide DocBook pour les débutants]] est un document destiné aux nouveaux venus dans le monde merveilleux de D''''''ocBook (en anglais). == Production à partir de feuilles de style DSSSL (pour le SGML ou XML) == * Les [[http://sourceforge.net/projects/docbook/|feuilles de style DSSSL]]. * Le [[Guides_pratiques/Suivi/DocBook-OpenJade-SGML-XML-HOWTO/Document|Guide pratique de conversion en utilisant OpenJade]]. == Production à partir de feuilles de style XSL (pour le XML) == * [[Guides_pratiques/Petit-guide-du-traducteur.html#production-simple|Produire simplement une version HTML en utilisant Xsltproc]] - cette section du ''Petit guide du traducteur'' explique comment produire la version HTML d'un document XML DocBook en utilisant une distribution Linux/GNU Debian. * [[Guides_pratiques/Petit-guide-du-traducteur.html#production|Procédure de production avec Xalan d'une version HTML]] - cette procédure explique comment produire la version HTML du ''Petit guide du traducteur'' en utilisant Xalan-Java. La même procédure pourra être facilement reprise pour d'autres documents. * Les [[http://sourceforge.net/projects/docbook/|Feuilles de style XSL]]. * La [[http://www.happy-monkey.net/docbook/|feuille de style XSL personnalisée]] du Projet de documentation Linux (LDP). Cette feuille de style s'utilise en complément de la feuille de style XSL pour D''''''ocBook. * La [[http://www.traduc.org/style.css|feuille de style CSS]] du projet Traduc.org. Il suffit de copier cette feuille de style dans le même répertoire que le document HTML<> pour obtenir un meilleur rendu. == Convertir un document HTML au format DocBook == * [[http://www.eecs.umich.edu/~ppadala/projects/tidy/|html2db]] est un petit outil utilisant la bibliothèque ''tidylib'' pour analyser le fichier HTML source et produire un document XML ou SGML au format D''''''ocBook. Cet outil n'est plus mis à jour. * [[http://osteele.com/software/xslt/html2db/index.html|html2db.xsl]] est une feuille de style XSL permettant de convertir un document en XHTML au format XML D''''''ocBook. Il est possible d'ajouter des annotations au code source pour personnaliser la production de la version D''''''ocBook. * [[http://wiki.docbook.org/topic/Html2DocBook|Html2DocBook]] est une autre feuille de style XSL permettant de convertir un document HTML en document au format D''''''ocBook. == Quel éditeur utiliser pour rédiger du DocBook == === Éditeurs XML et DocBook === * [[http://www.lyx.org/|LyX]] est un éditeur graphique pour LaTeX. Il permet aussi de rédiger des document au format DocBook, en choisissant un format approprié dans la boîte de dialogue « Format de document ». * [[http://kxmleditor.sourceforge.net/|KXML Editor]] est un éditeur XML pour KDE. * L'éditeur HTML [[http://bluefish.openoffice.nl/index.html|Bluefish]] connaît aussi les balises DocBook. * [[http://www.gnu.org/software/emacs/|Emacs]] est un éditeur très puissant, mais difficile d'accès, disposant d'extensions XML. * [[http://www.fr.xemacs.org/|XEmacs]] est une version alternative d'Emacs. * [[http://www.jedit.org/|JEdit]] est un éditeur libre écrit en Java. Il dispose d'un module d'extension pour l'édition XML. * [[http://www.xmlmind.com/xmleditor/|XML Editor]], de XMLmind, est un éditeur XML dont l'édition standard est disponible gratuitement. C'est un programme Java, qui donc peut fonctionner sans problème sous Linux, Mac OS X ou Windows. === Éditeurs disposant d'une coloration syntaxique === * [[http://www.nano-editor.org|Nano]] est un éditeur de texte en mode console très simple. Pour utiliser la coloration syntaxique avec un fichier XML, il vous suffit par exemple d'ajouter les lignes suivantes à votre fichier `.nanorc` : {{{ syntax "XML" "\.xml$" "\.html$" "\.sgml$" color yellow start="<" end=">" color red "&[^; ]*;" color green start="" color ,green " " }}} * [[http://www.vim.org|Vim]] est un éditeur difficile d'accès, mais puissant. == Vérifier l'orthographe d'un document XML DocBook avec aspell == Utilisez simplement la commande suivante : {{{ aspell -H check mon_document.xml }}} cf. le [[Guides_pratiques/Petit-guide-du-traducteur.html#verifier-l-orthographe|Petit guide du traducteur]]. ----