La version 2 de Pleade n'est plus officiellement développée par Anaphore et AJLSM. Si des bogues bloquants sont constatés, ils pourront toutefois être corrigés.
Nous encourageons tous les utilisateurs de Pleade 2 à songer à une migration vers la version 3.
La version 3.1 est disponible depuis le 24 février 2009 sur SourceForge : > > Télécharger...
Voir le site de démonstration de Pleade 3 : > > Démonstration de Pleade 3
Plus d'information sur Pleade 3 : http://pleade.com/
PLEADE est une application livrée avec son code source. Les lecteurs ou les éditeurs de contenus d'un site PLEADE ne devraient pas avoir à connaître ou modifier ces sources. Toutefois, il peut être intéressant pour les administrateurs et développeurs, ou tout simplement les curieux, de bien comprendre leur organisation. Dans ce document, nous allons présenter tous les dossiers que l'on trouve dans les sources de PLEADE, avec leur contenu et leur rôle.
Le dossier racine contient les scripts qui permettent d'installer PLEADE depuis les sources, ainsi que certaines autres opérations utiles aux développeurs. Ces scripts utilisent l'utilitaire Ant ru projet Apache. Le fichier pleade.properties contient les valeurs par défaut des propriétés d'installation de PLEADE.
Ce dossier contient les scripts génériques de pilotage de Ant.
Ce dossier contient les librairies Java qui sont nécessaires pour faire fonctionner les outils de compilation et d'installation de PLEADE. On y retrouve essentiellement Ant, Saxon (processeur XSLT) et Xerces (parseur XML).
Les sources de l'application PLEADE et de sa documentation.
La documentation de PLEADE, incluant le fichier source que vous consultez actuellement. Cette documentation est structurée en XML, DTD Docbook, avec un outil de publication réalisé par AJLSM. Cette documentation peut être consultée sur Internet à l'adresse http://www.pleade.org.
Ce dossier contient des documents EAD qui peuvent vous servir d'exemples pour tester PLEADE.
Ce dossier contient quelques outils nécessaires pour PLEADE, sans être au coeur de son fonctionnement. Pour l'instant, on y trouve la XSLT qui pilote la transformation de la documentation depuis le format XML vers HTML.
L'application Web elle-même, soit le code informatique qui sera exécuté par le serveur pour réaliser les fonctionnalités de PLEADE. La structure de ce dossier est très semblable à la structure finale de l'application qui sera installée sur le serveur SDX. Elle respecte notamment les contraintes imposées par SDX, en particulier la présence d'un dossier conf.
Ce dosser est obligatoire pour une application SDX. Il contient une configuration d'application SDX par défaut pour PLEADE. Cette configuration contient essentiellement des liens vers les parties de configuration que l'on trouve dans le dossier ../pleade-system/sdx-config. Lors de l'installation, le fichier pleade.xconf sera renommé en application.xconf (standard SDX) si un fichier de ce nom n'est pas déja présent.
Ce dossier contient des configurations et autres informations qui sont susceptibles d'être modifiées par les gestionnaires d'installations PLEADE. C'est pourquoi elles sont dans un dossier local. La plupart des fichiers qu'on y trouve sont soit des documents de configuration ou d'information, soit des programmes qui vont importer les programmes systèmes de PLEADE dans le but de surcharger, si nécessaire, les fonctionnalités de base.
De façon générale, l'installation de PLEADE ne va copier ces fichiers que si un fichier d'un nom équivalent n'existe pas sur le serveur.
Ce dossier contient des informations relatives aux différents formats d'affichage des documents des documents EAD. En particulier, le fichier ead-display-formats.xml qu'on y trouve fournit la liste des formats disponibles, avec un pointeur sur les XSLT qui les implémentent.
Dans ce dossier sont présents les fichiers qui décrivent les diverses méthodes de fragmentation des documents (ead-fragmentation.xml) et de la table des matières (ead-toc.xml).
Ce dossier contient les transformations XSLT en charge de l'indexation des documents dans SDX. Par défaut, ces transformations ne font qu'importer celles fournies dans ../pleade-system/sdx-index et elles permettent donc de surcharger les méthodes prévues par ces dernières.
Ce dossier contient les fichiers système de PLEADE, c'est-à-dire ceux qui contiennent le coeur du code et qui, logiquement, ne devraient pas être modifiés par les gestionnaires d'un site PLEADE. Ces fichiers sont organisés de manière à bien distinguer leur rôle, mais aussi de manière à pouvoir isoler certains regroupements afin de pouvoir les utiliser dans d'autres contextes que SDX.
Si jamais vous devez modifier l'un de ces fichiers pour réaliser une adaptation de PLEADE, veuillez le signaler aux développeurs.
Ce dossier rassemble tous les fichiers relatifs au traitement de documents EAD, en particulier leur affichage. L'idée est de ne rien mettre dans ce dossier qui soit propre à PLEADE ou SDX, afin de faciliter leur réutilisation.
Des CSS pour l'affichage de documents EAD, soit directement en XML, soit transformés en HTML.
Les DTD des versions 1 et 2002 de l'EAD. Le dossier contient également un fichier catalog qui permet de référencer les DTD par leur identifiant public.
Des transformations XSLT qui permettent de produire du HTML pour la consultation avec un navigateur Web. Nous ne détaillons pas ici les sous-répertoires que l'on trouve, mais l'idée générale est d'avoir un sous-répertoire par type d'affichage souhaité, le dossier _common étant réservé pour les parties communes réutilisables par différents affichages.
Les transformations XSLT qui permettent d'extraire les métadonnées pour constituer les enregistrements OAI en 4 étapes (récupération des paramètres propres à OAI, récupération des métadonnées issues d'autres unités documentaires, extraction vers le format Dublin Core qualifié puis vers le Dublin Core simple) ainsi que les schémas XML régissant les formats OAI.
Les fichiers de configuration pour une application SDX. Ces fichiers sont en fait des entités externes (au sens XML) et elles sont incluses par le document ../../conf/application-original.xconf.
Les transformations XSLT qui permettent d'indexer les documents EAD dans PLEADE, et ce en deux étapes.
La sitemap Cocoon pour PLEADE, avec la définition des pipelines système de l'outil. Pour ajouter de nouveaux pipelines propres à une installation locale, modifier ../../sitemap-original.xmap.
Des ressources utilisées pour l'interface Web, en particulier des CSS, Javascript et images. Les sous-dossiers ne seront pas détaillés ici.
Les transformations XSLT utilisées pour générer l'interface Web de PLEADE. Ces XSLT ont généralement pour mandat de transformer la sortie des pages XSP (du XML virtuel) vers un format HTML pour affichage dans le navigateur de l'utilisateur. Le sous-dossier _common contient les XSLT communes importées par la plupart des autres.
Ce dossier contient les habillages livrés dans la distribution standard de PLEADE. Pour l'instant, un seul habillage est fourni, soit celui nommé default, qui peut servir de base pour un gestionnaire d'une installation locale de PLEADE afin qu'il mette en place un habillage personnalisé.
L'habillage par défaut de PLEADE.
Les CSS associées à cet habillage. Il doit y avoir au moins une CSS nommée website.css qui sera toujours appelée par les pages HTML. Celle-ci peut importée d'autres CSS si souhaité.
Les barres de menus de l'interface souhaitée. PLEADE s'attend à trouver une barre de menus dans le fichier main.xml.
Les pages statiques de l'interface souhaitée. Ces pages sont à organiser dans des dossiers par langue, en utilisant le code ISO de la langue concernée. PLEADE est livré avec un jeu de pages statiques fictives en français et en anglais.
Les messages d'interface, c'est-à-dire les chaînes de caractères affichées à l'écran par PLEADE, et qui ne proviennent ni des documents EAD gérés ni des pages statiques. Ces messages sont dans des documents XML qui regroupent une certaine thématique qui correspond, de manière générale, à une XSLT qui produit l'interface.
PLEADE est livré avec des messages en anglais et en français.
Les XSLT qui permettent de produire l'interface utilisateur. Ces XSLT ne font qu'importer les XSLT systèmes de PLEADE, mais le gestionnaire local à tout le loisir de les modifier pour créer des adaptations de PLEADE pour son site, adaptations qui peuvent aller beaucoup plus loin que les simples couleurs ou polices.