Résumé
Ce document décrit l'installation du filtre Flat Writer XML (FlatXMLfilter) dans OpenOffice.org (Windows et Linux). Ce filtre permet à OpenOffice d'enregistrer directement des fichiers OpenOffice-Writer au format XML.
Table des matières
Le filtre FlatXML (FlatXMLfilter) ajoute à OpenOffice la capacité d'enregistrer (et d'ouvrir) directement un document au format OpenOffice-XML. Au lieu d'obtenir un fichier monDocument.sxw, on obtient un fichier monDocument.xml.
Après l'installation du filtre, on trouvera une nouvelle entrée « Flat Writer XML file » dans les boîtes d'ouverture et d'enregistrement d'OpenOffice-Writer.
L'intérêt de ce filtre est que le document produit peut immédiatement être traité comme n'importe quel document XML et notamment être converti grâce à une feuille de style et un processeur XSLT (Saxon, Xsltproc, etc.).
Le filtre FlatXML est disponible pour Windows, Linux et Solaris. L'installation sur Solaris n'est pas abordée dans ce document.
Dans une précédente version de ce document, j'ai prétendu que les images incorporées étaient perdues lors de la conversion au format « Flat XML » et que seules les images liées devaient être utilisées. C'est totalement faux. Les images incorporées au document sont parfaitement conservées dans le fichier « Flat XML ».
Dans une précédente version de ce document, un des chemins indiqués pour l'installation sous Linux était erroné.
Voici le chemin erroné :
> cd /usr/lib/openoffice/program/FlatXMLfilter/Linux
Voici le chemin correct :
> cd /usr/lib/openoffice/FlatXMLfilter/Linux
Téléchargez l'archive flatxmlfilter.zip à l'adresse suivante :
http://api.openoffice.org/servlets/ProjectDownloadList
L'installation a été réalisée sur une Linux-Mandrake 8.2 et une installation d'OpenOffice 1.0 faite à partir du RPM OpenOffice.org-1.0-5.mdk.i586.rpm. N'oubliez pas d'adapter les exemples qui suivent à votre installation.
Quittez OpenOffice et ouvrez un terminal.
Décompressez l'archive flatxmlfilter.zip.
> unzip flatxmlfilter.zip |
Vous obtenez un répertoire FlatXMLfilter
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 |
Saisissez la commande suivante :
> regcomp -register -r applicat.rdb -c libgenericxmlfilter.so |
A la fin de l'opération, le message suivant s'affiche :
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.
Quittez OpenOffice ainsi que le démarrage rapide d'OpenOffice s'il est lancé.
Décompressez l'archive flatxmlfilter.zip. Vous obtenez un répertoire FlatXMLfilter.
Copiez ce répertoire à la racine du répertoire d'installation d'OpenOffice. Par défaut, il s'agit de :
C:\Program Files\OpenOffice.org1.0
Vérifiez que vous obtenez bien une arborescence du type :
C:\Program Files\OpenOffice.org1.0\FlatXMLfilter\Windows
Ouvrez un fenêtre de ligne de commande (i.-e. une session DOS).
Ajoutez le chemin vers C:\Program Files\OpenOffice.org1.0\program à la variable d'environnement PATH en faisant:
set PATH=%PATH%;C:\Program Files\OpenOffice.org1.0\program |
Cette variable permettra l'accès à la librairie sal3.dll requise pour l'installation du filtre.
Placez-vous dans le répertoire de la librairie genericxmlfilter.dll :
cd C:\Program Files\OpenOffice.org1.0\FlatXMLfilter\Windows |
Lancez la déclaration du filtre :
regcomp -register -r C:\PROGRA~1\OpenOffice.org1.0\program\applicat.rdb -c genericxmlfilter.dll |
Veillez à bien écrire c:\PROGRA~1 et pas c:\Program Files sinon la déclaration échouera. Les noms longs avec espaces ne sont pas si bien gérés que cela sous Windows...
Lorsque la déclaration a réussi, vous obtenez un message du type :
Register component "genericxmlfilter.dll" in registry "C:\PROGRA~1\OpenOffice.org1.0\program\applicat.rdb" successfull! |
Enfin, il ne vous reste plus qu'à copier le fichier TypeDetection.xml (Il se trouve dans le dossier FlatXMLfilter) dans le répertoire :
C:\Program Files\OpenOffice.org1.0\user\config\¬ registry\instance\org\openoffice\Office
En environnement multi-utilisateurs (OpenOffice.org installé en mode "Station de travail"), votre répertoire peut être différent. Ainsi, mon répertoire personnel se trouve dans :
C:\Documents and Settings\ebellot\OpenOffice.org1.0
J'ai donc copié le fichier TypeDetection.xml dans :
C:\Documents and Settings\ebellot\OpenOffice.org1.0\user\¬ config\registry\instance\org\openoffice\Office
Il ne vous reste plus qu'à relancer OpenOffice pour profiter du nouveau filtre.
Par défaut, le fichier généré par le filtre « Flat XML » a une extension *.xml. Toutefois, il peut être intéressant d'attribuer une extension propre à ce type de fichier XML (par exemple *.ooo) et de l'associer à OpenOffice.org. Il suffira alors d'un double-clic sur le fichier pour l'ouvrir avec OpenOffice.
Dans le fichier TypeDetection.xml, modifier la ligne :
<Data cfg:type="string">0,,,,xml,20002,</Data> |
et remplacer « xml » par « ooo » (ou l'extension que vous avez choisie) :
<Data cfg:type="string">0,,,,ooo,20002,</Data> |
Dorénavant, lorsque vous choisirez d'enregistrer au format « Flat XML », l'extension *.ooo sera automatiquement ajoutée.
Ouvrez ensuite l'Explorateur de fichiers et faites Outils > Options des dossiers > onglet Types de fichiers. Cliquez sur bouton Nouveau et saisissez les 3 lettres de la nouvelle extension « ooo ».Validez.
Sélectionnez la ligne du type « OOO » nouvellement créé et cliquez sur Modifiez. Dans la boîte de dialogue d'ouverture qui s'affiche, cliquez sur le boutons Autres et allez dans le répertoire d'installation d'OpenOffice.org. Sélectionnez ooowriter.exe puis validez toutes les boîtes de dialogues.
A partir de maintenant, les fichiers XML d'OpenOffice s'ouvriront directement avec OpenOffice-Writer.
Pour télécharger le filtre :
La documentation officielle (succincte) :
Guidelines for writing the Developer Manual
Le filtre est initialement destiné à la rédaction du manuel de développement d'OpenOffice.
Le forum de développement du projet api.openoffice.org :
http://api.openoffice.org/servlets/SummarizeList?listName=dev
Dans le forum, une recherche sur le mot-clef « flatxml » donne de bons résultats.
Note
Ce document a été rédigé sur OpenOffice.org 1.0.1. Il a été converti en XML avec le filtre « Flat XML ». Le fichier « Flat XML » a été converti au format Docbook-XML avec Saxon 6.5.2 et la feuille XSLT docbook.xsl. Le document Docbook a été converti au format HTML avec Saxon et les Docbook stylesheets 1.52.2 de Norman Walsh.