Créer des documents docbook simplifiée avec openoffice
Auteur: Bruno Adele
07/12/2002
Table des matières
- 1. Introduction
- 1.1. Remerciement
- 1.2. Présentation
- 2. Installation
- 3. Démonstration
- 4. Conseil d'utilisation
Je voudrais remercier particulièrement Éric Bellot pour nous avoir facilité la tache pour la création de docbook simplifier, et je voudrais également le remercier pour m'avoir dépanner à l'installation de flatXML.
DocBook est une norme XML développée pour baliser des documents, Il n'y a aucune information sur la mise en page, La mise en page s'effectue grâce à une feuille de style XSLT (XML Stylesheet Language, Transformation spécification). C'est cette feuille de style qui permet de convertir un document docbook sous différent format ( HTML, PDF, RTF, etc...).
A moins d'avoir des outils comme emacs+PSGML ou Kate+plugins, il n'existe pas beaucoup d'outils pour pouvoir écrire des docbooks simplifier de façon simple. Je vais donc tenter d'expliquer comment écrire des docbooks avec openoffice et ooo2sDBK.
OpenOffice -- Openoffice est une suite logicielles qui ressemble à « Microsoft word » à la différence prés, c'est qu'il est libre. Openoffice gères les documents Textes, Tableur, Dessin vectoriel, Editeur HTML. Le format de fichier retenu par la communauté d'openoffice est le XML. Plus d'info à: http://fr.openoffice.org
Docbook -- Docbook est un format de fichier XML, permettant de convertir un howto, livre, etc en un format HTML, PDF, RTF, PS, etc... Ce format commence à devenir une norme. Des projets comme TLDP, KDE, etc, utilise exclusivement ce format. Plus d'info à: http://www.docbook.org
Xsltproc -- c'est un parseur qui convertir les document xml en d'autres format, il à besoins de feuille de style XSL. Plus d'info à: http://xmlsoft.org/XSLT/
DocBook XSL -- Ce sont les feuilles de style XSLT pour pouvoir convertir le document docbook dans d'autres format. Plus d'info à: http://docbook.sourceforge.net/projects/xsl
FlatXML -- FlatXML, est une extenssion à openoffice, qui permet de sauvegarder un document openoffice en un document XML(non compressé)
plus d'info à:http://api.openoffice.org/servlets/projectsDownloadList
Ooo2sDBK -- Ooo2sDBK est un script python d'Éric Bellot qui permet de convertir un document xml compressé d'openoffice en un document docbook simplifié.
![[Note]](../common/images/note.png) | Note |
|---|---|
Si vous utilisé les images liée, depuis l'apparition de flatxML, le script d'Éric Bellot, n'est plus nécéssaire pour faire un docbook, il suffit simplement d'utilise sa feuille de style docbook.xsl. Plus d'info à:http://ooo2sdbk.sourceforge.net/ | |
Les explications qui vont suivre concerne la distribution Debian(woody) et le systeme d'exploitation windows
Linux
J'utilise les paquets non officiel du site http://linux-debian.de/openoffice/
Ajout de la source dans le fichier /etc/apt/sources.listdeb
deb http://ftp.openoffice.tuxfamily.org/openoffice testing main contrib
Installation
apt-get install openoffice.org openoffice.org-bin openoffice.org-l10n-fr
Windows
Télécharger open office installation
etc.....
- Installation du dictionnaire sous windows uniquement
Télécharger à http://www.ooodocs.org/dictinstall/
decompresser le fichiers
executer dictinstall.exe
Selectionner les dictionnaire désirés
Se rendre dans "Outils / Options / Paramètres linguistiques / Linguistique" ;
Puis dans la case "Modules de langue disponibles", choisir "Éditer" ; pour la langue francais cocher "OpenOffice MySpell SpellChecker"
Choisir son dictionnaire, se rendre à nouveau Se rendre dans "Outils / Options / Paramètres
linguistiques / Langue" ; verifier si c'est à default pour un OS parametrer en francais ou verfier si c'est selectinner francais pour un OS non francophone
plus d'info à http://www.ooodocs.org/dictinstall/fr/nexthelp.html
Linux(issu de la doc de Ooo2sDBK)
Décompressez l'archive flatxmlfilter.zip.
unzip flatxmlfilter.zip
Copiez-le dans le répertoire d'installation d'OpenOffice.
cp -R FlatXMLfilter /usr/lib/openoffice
Exportez la variable d'environnement LD_LIBRARY_PATH d'OpenOffice :
export LD_LIBRARY_PATH=/usr/lib/openoffice/program:$LD_LIBRARY_PATH
Cette variable permettra l'accès à la librairie libsal.so.3 requise pour l'installation du filtre.
Placez vous dans le répertoire où se trouve regcomp :
cd /usr/lib/openoffice/FlatXMLfilter/Linux
Changé les droit d'execution
chmod 755 regcomp
Installation de flatxml :
regcomp -register -r applicat.rdb -c libgenericxmlfilter.so
Vous devrez normalement avoir le message suivant:
register component "libgenericxmlfilter.so" in registry "applicat.rdb" succesfull!
Enfin, copiez le fichier TypeDetection.xml dans votre répertoire personnel de la façon suivante :
cp /usr/lib/openoffice/FlatXMLfilter/TypeDetection.xml \ ~/.openoffice/user/config/registry/instance/org/openoffice/Office
Redémarrer OpenOffice pour profiter du nouveau filtre.
Windows
Petite précision: j'ai télécharger le kit xmerge, l'instal c'est bien passé, par contre les fichiers sauvegarder avec FlatXML son érroné.
Télécharger donc le fichier le programme flatxmlfilter à http://api.openoffice.org/servlets/ProjectDownloadList.
Je n'utilise pas le script python, car je trouve inutile d'installer python pour seulement extraire les images incorporés au document OpenOffice
Télécharger OOo2sDBK a : http://www.chez.com/ebellot/ooo2sdbk/
Décompressez le fichier:
unzip ooo2sdbk-0.4.2-all.zip
copier la feuile de style docbook.xsl
cp ooo2sdbk.xsl /usr/local/docbook
Copier le script suivant dans /usr/local/docbook/oo_docbook
#!/bin/sh
filename=`basename $1 .xml`
if [ -f $1 ]; then
xsltproc /usr/local/docbook/ooo2sdbk.xsl $filename".xml" > \
$filename"_dbk.xml"
xsltproc -nonet \
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl \
$filename"_dbk.xml" > $filename".html"Faite un lien symbolique de vers oo_docbook
ln -s /usr/local/docbook/oo_docbookk /usr/local/bin/oo_docbook
Vous avez maintenant des outils pour faire des docbook sans dificulté.
Nous allons utiliser pour la démonstration le fichier example.sxw situé dans doc-example
Ouvrez le document avec OpenOffice, ensuite sauvegardez le au format xml, avec la commande « enregistrer sous ». Sélectionnez le type de fichier « Flat Write XML file »