Installation et utilisation d'OOo2sDbk

2002-12-29

Version 0.3 pour Ooo2sDbk-0.4.2

Eric Bellot

Licence

Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la Licence GNU Free Documentation License, Version 1.1 ou ultérieure publiée par la Free Software Foundation ;

Avec les sections inaltérables suivantes : - La section « Licence »

Avec le texte de première page de couverture suivant: - pas de texte de première page de couverture -

Avec le texte de dernière page de couverture suivant : - pas de texte de dernière page de couverture -

La licence officielle peut être consultée sur le Web à l'adresse suivante :

http://www.gnu.org/licenses/fdl.html


Table des matières

1. Présentation
1.1. Principe de fonctionnement d'OOo2sDbk
1.2. Le modèle et le fichier autotexte
2. Installation des scripts et des feuilles de styles
2.1. Programmes requis
2.2. Étapes d'installation pour Linux
2.3. Installation pour Windows
3. Utilisation d'OOo2sDbk
4. Utilisation pour les scripts en Python
4.1. Étapes
4.2. Syntaxe
4.3. Exemples de scripts
5. Fichier de configuration
5.1. xslt-command
5.2. xslt-stylesheet
5.3. images
6. Installation du modèle et du fichier d'autotexte

1. Présentation

OOo2sDbk est un ensemble de feuilles de styles XSLT qui permettent de convertir un document OpenOffice au format Docbook. Elles sont pilotées par une série de scripts Python qui automatisent le processus.

Pour pouvoir fonctionner Ooo2sDbk requiert Python et un processeur XSLT (Saxon, Xalan, xsltproc, etc.).

Les utilisateurs du filtre FlatXML peuvent se dispenser du recourt aux scripts Python. Le filtre FlatXML permet de produire directement un document OpenOffice au format XML. Il suffit donc d'un processeur XSLT et de la feuille ooo2sdbk.xsl pour réaliser la conversion.

1.1. Principe de fonctionnement d'OOo2sDbk

OOo2sDBK converti un document SXW en Docbook en 3 étapes :

  1. Décompression des fichiers XML du document OpenOffice-Writer[1] et, s'il y a lieu, extrraction des images in­corporées.

  2. Concaténation de ces différents fichiers en un gros document XML temporaire[2],

  3. Conversion du document temporaire au format Docbook simplifié par le processeur XSLT et la feuille de styles ooo2sdbk.xsl.

1.2. Le modèle et le fichier autotexte

Le modèle ooo2sdbk.stw facilite la rédaction de documents Docbook avec OpenOffice.

Il ajoute à OpenOffice toutes une série de styles de caractères et de paragraphes adaptés à la création de balises Docbook. Plus d'une cinquantaine de styles "spécial Docbook" a été ajoutés. On trouvera par exemple un style de paragraphe Abstract. Le paragraphe sur lequel on applique ce style sera encadré de balises <abstract> dans le document Docbook généré par Ooo2sDbk.

On trouvera une présentation détaillées des styles et de leur utilisation dans le guide Rédaction d'un document Docbook avec OpenOffice.

Le fichier d'autotexte ooo2sdbk.bau propose des exemples de pages de titre pour OpenOffice. Elles contribuent à générer des sections <infoarticle> correctes dans les documents Docbook.

[Note]Note

Ooo2sDbk peut parfaitement fonctionner sans le modèle, ni l'autotexte. Il est capable de convertir des documents OpenOffice standards. Toutefois, le modèle permet de réaliser des documents nettement meilleurs.



[1] Un document OpenOffice est une collection de documents XML compressés au format Zip.

[2] Ce document XML est compatible avec la DTD officielle d'OpenOffice.


Copyright©2002 Eric Bellot
http://www.chez.com/ebellot/ooo2sdbk
Miroir : http://membres.lycos.fr/ebellot