XML Publication: publication de documents sur Internet par XML

par J.M. Vanel , Copyright © J.M. Vanel - 2001

Last update:

Télécharger XMLPublication version courante; User documentation ; page accueil en anglais

XML Publication est un ensemble d'outils pour publier des pages Web à partir de documents bureautiques ou autres, en utilisant à fond les techniques XML et en particulier XSLT.

C'est un outil en ligne de commande (pour l'instant), utilisable en production, sous license GNU. Si votre besoin immédiat est de mettre en ligne rapidement un gros volume de documents bureautiques, alors XMLPublication est fait pour vous. A plus long terme si le besoin est de mettre en place une chaîne de publication peu coûteuse, utilisant des outils bureautiques, avec validation et indexation, XMLPublication est aussi pour vous. Enfin, l'architecture extrêmement modulaire combinant des transformations XSLT élémentaires avec des enchaînements par Ant intéressera les développeurs.

Note: pour l'instant, cette documentation est moins aboutie que celle en anglais, mais certains détails ne sont qu'ici ...

Installation

Tout le nécessaire à installer est cité dans : http://jmvanel.free.fr/Principales_sources_technologiques.htm :

• ant
• saxon

plus pour les connecteurs bureautiques:

• tidy
• Pour les fichiers XLS, j'ai utilisé en production un module Perl (Spreadsheet::ParseExcel) qui lit directement ce format propriétaire.

L'installation de ant est bien expliquée; attention, il ne faut pas installer ant dans un répertoire avec un nom long. Après il faut rendre accessible saxon.jar (le processeur XSLT) à Ant, comme expliqué dans l'installation de ant. Ensuite il n'y a qu'a taper ant dans un répertoire d'une des publications exemples fournies.

Installer Spreadsheet::ParseExcel (facultatif)

Après avoir installé Perl, il faut décompresser et installer dans cet ordre les modules ci-après :

• IO-stringy-1.220
• OLE-Storage_Lite-0.08
• Spreadsheet-ParseExcel-0.20.1

Pour installer un module Perl (comme expliqué dans les distrib.) :

         perl Makefile.PL

         make

         make test

         make install    # You may need to be root

         make clean      # or make realclean

Windows users without a working "make" can get nmake from: ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe

Utilisation

Les répertoires d'exemple fonctionnent en tapant ant dans une fenêtre de commande (Shell, DOS, Cygwin, ...). La page d'accueil générée est html/index.html .

Pour traiter votre document source, copier le répertoire empty_project. On pourra aussi s'inspirer d'un des répertoires d'exemple , soit XSLTLibrary-publish/ pour des données tabulaires, soit text+index/ pour des données de type texte avec des paragraphes et des sous-paragraphes délimités par des titres.

Déposer dans le répertoire empty_project un ou des fichiers .table.htm , .table.html, .parag.htm, .parag.html, .xls . Lancer execute.bat . Vous pouvez aussi tout de suite taper ant edit; ant dans une fenêtre de commande, vous verrez bien ce qui sort ... Voir aussi le fichier readme.txt dans le répertoire empty_project . Vous aurez ensuite à éditer , dans USER_SETTINGS/ , les fichiers suivants, dans l'ordre d'importance :

• item_file_name.xslt : pour spécifier la génération d'un nom et d'une clé (nom de fichier) pour les articles (items);
• thesaurus.xml: pour spécifier la génération d'un nom et d'une clé (nom de fichier) pour les rubriques, ainsi que la politique à suivre pour générer un index des mots figurant dans la rubrique;
• presentation.html : la bannière de votre site; doit contenir un marqueur pour le point d'insertion du contenu; c'est n'importe quelle balise qui a un attribut class='xmlpub-add-content' ; la balise est gardée avec ses attributs, et le contenu est remplacé par l'article (item) formatté en XHTML.
• book-title.html : quelque chose qui est ajouté dans chaque page après la bannière et avant l'insertion du contenu; bien sûr ceci pourrait être partie de presentation.html, mais l'idée est de gérer une seule bannière de site (presentation.html) et plusieurs en-têtes de documents (book-title.hmtl).

Après toute modification, il suffit de retaper ant dans une fenêtre de commande, et tout se régénère.