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 et Navimages

Dans ce document, nous expliquons comment installer, configurer et utiliser Navimages à l'intérieur d'une application PLEADE. Il est important de noter que nous n'expliquons pas ici comment préparer des séries d'images et des collections avec Navimages. Nous présentons seulement comment associer des séries d'images à des parties de documents EAD pour que PLEADE puisse permettre aux utilisateurs de les visualiser avec la visionneuse Navimages.

1) Installation de Navimages et configuration PLEADE

Il est très simple d'installer ensemble Navimages et PLEADE, car les deux ont été pensés pour fonctionner en commun, au sein d'une même application SDX. Ainsi, si vous souhaitez mettre en place un service de visionnement de séries d'images avec Navimages dans une application PLEADE, vous devez :

  1. Obtenir une distribution de Navimages et décompresser l'archive.

  2. Prendre le dossier examples/viewer/cocoon et le copier à l'intérieur de votre dossier d'installation de PLEADE (par exemple $SDX_HOME/pl (on appellera ce dossier $PLEADE_HOME dans la suite).

  3. Renommer le dossier cocoon en navimages (ce n'est pas obligatoire mais ça simplifiera la suite).

  4. Modifier le fichier $PLEADE_HOME/sitemap.xmap pour y ajouter un nouveau pipeline (avant celui existant par défaut) ainsi :

    
    <map:match pattern="navimages/**">
      <map:mount uri-prefix="navimages" src="navimages/" check-reload="yes"/>
    </map:match>
    
    
  5. Modifier le fichier $PLEADE_HOME/pleade-local/local.xconf pour y ajouter la mention suivante au sujet de Navimages (elle est présente dans le fichier livré par défaut avec PLEADE) :

    
    <navimages>
      <install dir="navimages/" url="navimages/"/>
    </navimages>
    
    

    L'attribut dir indique l'endroit où se trouvent les fichiers Navimages dans le dossier d'installation de PLEADE, alors que l'attribut url indique à quelle URL de base on peut atteindre les fonctions de Navimages dans l'application PLEADE.

  6. Modifier le fichier sitemap.xmap qui se trouve dans le dossier navimages, pour donner au serveur l'URL absolue du dossier navimages. Il faudra donc modifier, dans la section map:resources de ce sitemap, les deux occurrences de l'élément map:parameter ayant un attribut name de valeur serverUrlToNavimages. Voici comment ces éléments se présentent initialement :

    <map:parameter name="serverUrlToNavimages" value="@url.server.navimages@/{collectionId}/{collectionSubPath}"/>
    

    La modification consistera à remplacer la variable @url.server.navimages@ de l'attribut value par l'URL complète du dossier navimages, soit $PLEADE_HOME/navimages/. Par défaut, pour une installation simple de PLEADE, cela pourra donc donner :

    <map:parameter name="serverUrlToNavimages" value="http://127.0.0.1:8080/sdx/pl/navimages/{collectionId}/{collectionSubPath}"/>
    

  7. Configurer Navimages pour que les collections pointent au bon endroit. Ces informations sont dans le fichier navimages/collections.xml. Vous devez notamment connaître l'identifiant des collections pertinentes.

2) Publier un document EAD avec des liens vers Navimages

Si vous avez configuré PLEADE pour indiquer où se trouve Navimages, une nouvelle section apparaîtra dans la page de publication des documents ; cette section a pour objectif de renseigner certaines informations concernant les liens entre PLEADE et Navimages pour le ou les documents à publier. Si aucun lien avec Navimages n'est présent dans le ou les documents à publier, vous pouvez simplement ignorer cette section.

Cette section vous pose une seule question : quel est l'identifiant de la collection (au sens Navimages) où se trouvent la ou les séries référencées dans le document EAD. Cela implique donc que toutes les séries référencées dans un document EAD (en fait dans un groupe de documents EAD publiés au même moment) font partie de la même collection.

3) Renseigner un document EAD pour PLEADE et Navimages

Avant de publier un document EAD associé à un corpus d'images en utilisant PLEADE et Navimages, il faudra organiser et préparer les images avec Navimages ; cet aspect est expliqué en détail dans la documentation de Navimages. A ce sujet, précisons simplement ici qu'un document EAD peut aussi servir à organiser les images avec Navimages, préalablement à l'étape de publication. Encore une fois, la syntaxe à respecter pour renseigner les éléments de lien vers les images dans un tel scénario est expliquée dans la documentation de Navimages. Cette syntaxe pourra être conservée telle quelle et fonctionnera parfaitement lors de la phase de publication. Elle peut être combinée avec les règles détaillées ci-dessous, qui sont utiles dans le cas où le document EAD ne sert pas à organiser les images, mais seulement à en permettre la consultation avec PLEADE et Navimages.

PLEADE doit pouvoir savoir à quel moment il utilise Navimages pour visualiser les images associées à un document. C'est pourquoi un certain nombre de consignes doivent être suivies pour qu'un document EAD soit correctement interprété par PLEADE et Navimages. Nous donnons ces consignes ci-dessous.

Les éléments EAD utilisés par PLEADE pour relier des composants à des images numériques sont daoloc qui doit se situer dans un élément daogrp. Les attributs role et href de daoloc permettront de préciser le rôle exact du lien ainsi que sa cible, soit les images.

3.1) Pointer sur une série Navimages

Il est très simple d'ajouter, dans un document EAD, un lien vers une série d'images gérée par Navimages. La construction de base est :


<daogrp>
  <daoloc role="navimages:series" href="ALBUM-7664/"></daoloc>
</daogrp>

Dans cet exemple, l'attribut role indique qu'il s'agit d'une série, et l'attribut href indique le chemin du dossier qui contient cette série, dossier qui devra avoir été préparé avec le collecteur Navimages. Ce dossier fait nécessairement partie d'une collection, et cette collection sera renseignée lors de la publication du document EAD, comme paramètre général. La collection ne doit pas être présente dans le document EAD.

On peut ajouter une autre information, facultative, à cette structure, soit le nombre d'images dans la série, si elle est connue. A noter que le collecteur Navimages peut également modifier automatiquement les documents EAD pour ajouter cette information. Voici un exemple :


<daogrp>
  <daoloc role="navimages:series:8" href="ATLAS-8485/"></daoloc>
</daogrp>

On indique ici qu'il y a 8 images dans la série, ce que PLEADE pourra afficher avant même d'ouvrir la fenêtre Navimages.

3.2) Pointer sur une partie de série Navimages

Parfois, il peut être intéressant de pointer sur une partie seulement d'une série. Le cas le plus fréquent sera celui où on définit la série Navimages au niveau d'un dossier (au sens archivistique), mais qu'on a l'intention de décrire certaines pièces de ce dossier dans le document EAD. Dans une telle situation, l'élément c qui représente le dossier aura un lien vers la série Navimages, et les sous-élément c qui décrivent les pièces auront des liens vers une ou des images dans la série.

Voici tout de suite un exemple relativement complet :


<c level="file">
  ...
  <daogrp>
    <daoloc role="navimages:series:8" href="ATLAS-8485/"></daoloc>
  </daogrp>

  <c level="item">
    <daogrp>
      <daoloc role="navimages:image" href="ATLAS-8485/atlas8485-03.jpg"></daoloc>
    </daogrp>
  </c>
  <c level="item">
  ...
    <daogrp>
      <daoloc role="navimages:image" href="ATLAS-8485/atlas8485-04.jpg"></daoloc>
      <daoloc role="navimages:image" href="ATLAS-8485/atlas8485-05.jpg"></daoloc>
      <daoloc role="navimages:image" href="ATLAS-8485/atlas8485-06.jpg"></daoloc>
    </daogrp>
  </c>
  <c level="item">
    <daogrp>
      <daoloc role="navimages:image:first" href="ATLAS-8485/atlas8485-04.jpg"></daoloc>
      <daoloc role="navimages:image:last" href="ATLAS-8485/atlas8485-06.jpg"></daoloc>
    </daogrp>
  </c>
</c>

Dans cet exemple, le premier élément c pointe sur la série comme dans les exemples précédents. Par contre, les sous-éléments c n'ont pas de lien vers une série, ils ont seulement des liens vers des images gérées par Navimages (avec un role navimages:image, et dans ce cas le chemin complet vers l'image est renseigné. Le troisième item, quand à lui, renseigne uniquement la première et la dernière image, en utilisant des valeurs particulières pour l'attribut role, mais le résultat sera le même.

Concrètement, cela permet de faire un lien vers la visionneuse Navimages en ouvrant la série d'images correspondant au dossier, mais la première image affichée sera la première image référencée dans la description de la pièce.

3.3) Quelques autres remarques

Si un élément daoloc qui pointe sur une série contient un sous-élément daodesc, alors ce dernier sera utilisé comme texte source pour le lien hypertexte vers la visionneuse Navimages.

Les liens vers une série ou partie de série Navimages peuvent être dans n'importe quel composant c dans un document EAD. De plus, l'organisation hiérarchique des descriptions archivistiques (éléments c) peut ne pas suivre exactement l'organisation également hiérarchique des séries Navimages, même si très souvent ce sera le cas.

Eventuellement, il sera possible de contrôler comment la visionneuse Navimages est affichée, notamment si on doit avoir les images à côté des descriptions ou dans une nouvelle fenêtre. Pour l'instant, seule cette dernière possibilité est offerte.

3.4) Quelques modes d'affichage particuliers des images avec Navimages

Si on utilise des sources CVS récentes de PLEADE, et qu'on respecte certaines règles supplémentaires lors de la saisie de certains éléments dans le document EAD, on pourra obtenir un affichage des images adapté à des besoins particuliers.

3.4.1) Liens vers Navimages à partir de vignettes incluses dans la version HTML de l'instrument de recherche

Si l'on dispose d'images numériques de documents figurés (cartes, plans, photographies, affiches...) on souhaitera peut-être que l'utilisateur final de PLEADE se fasse une première idée de ces images numériques en consultant des vignettes représentant ces images numériques et incluses dans la version HTML de l'instrument de recherche, et qu'il puisse ensuite cliquer sur ces vignettes pour atteindre les images dans la fenêtre de la visionneuse Navimages.

Pour que ce mode d'affichage fonctionne, il faudra :

  • se procurer (ou créer, éventuellement au moyen du module collecteur de Navimages) des vignettes correspondant aux images numériques ;

  • saisir dans le document EAD, dans l'élément Composant c décrivant les documents numérisés, pour établir les liens vers ces vignettes et faire en sorte que PLEADE les traite comme des documents attachés au document EAD, un élément dao ou daogrp ayant un attribut role de valeur navimages:thumbnails ;

  • saisir dans le document EAD, dans le même élément Composant c, pour établir les liens vers la série ou la partie de série d'images numériques correspondant aux vignettes, un élément dao ou un élément daogrp respectant l'une ou l'autres des syntaxes décrites ci-dessus dans les sections 3.1 et 3.2.

Attention, ce dispositif ne fonctionnera bien que si les vignettes à afficher dans l'instrument de recherche ont le même nom (hors extension, et hors éventuel suffixe désignant une vignette et saisi après un tiret bas) que les images numériques destinées à être consultées avec la visionneuse Navimages.

Voici un exemple concret illustrant une syntaxe possible :

<c level="recordgrp">
 <did>
  <unitid>planches 1 à 16</unitid>
  <unittitle>"N°365. Loire, Rhône. R. n° 8. Généralité de Lyon. n° 1. Route de Paris à Lyon par Roanne. 16 cartes".</unittitle>
  <physdesc><dimensions>Chaque planche mesure environ 85 x 60 cm</dimensions></physdesc>
  <materialspec type="scale">Echelle  de 11 cm pour 500 toises, soit 1/8863e</materialspec>
 </did>
 <scopecontent>
  <p>Tracé de la route royale numéro 8, partant des limites du Bourbonnais, traversant les départements de la Loire
et du Rhône et arrivant à Lyon.</p>
 </scopecontent>
 <!-- etc. -->
 <daogrp role="navimages:thumbnails">
  <daoloc href="DAFANCH01_NC120001820_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001821_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001822_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001823_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001824_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001825_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001826_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001827_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001828_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001829_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001830_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001831_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001832_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001833_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001834_V.JPG"/>
  <daoloc href="DAFANCH01_NC120001835_V.JPG"/>
 </daogrp>
	<daogrp role="navimages:series" title="Atlas de Trudaine : généralité de Lyon, route de Paris à Lyon par Roanne">
  <daoloc role="navimages:image:first" href="TRUDAINE/8485/PLANCHES1A16/DAFANCH01_NC120001820_2.JPG"/>
  <daoloc href="TRUDAINE/8485/PLANCHES1A16/DAFANCH01_NC120001835_2.JPG" role="navimages:image:last"/>
 </daogrp>
</c>

Dans cet exemple (extrait de l'inventaire analytique des atlas de Trudaine réalisé par le Centre historique des Archives nationales), on a choisi de présenter à l'utilisateur, dans l'instrument de recherche, la totalité des vignettes produites à partir des 16 images numériques des planches d'atlas. On aurait pu ne présenter à l'utilisateur que la première, qui concerne la planche 1, comme représentative du tout. On note que les vignettes et les images numériques qui forment la série d'images à consulter avec la visionneuse Navimages ont le même nom, sauf pour ce qui est du suffixe précédé du tiret bas, qui est "_V" pour les vignettes et "_2" pour les images correspondantes.

3.4.2) Juxtaposition à l'écran de la transcription d'un document d'archives numérisé et de la série d'images numériques correspondante

Dans le cas où l'on disposerait d'une édition critique ou d'une transcription d'un texte numérisé, on souhaitera peut-être que l'utilisateur final puisse consulter en même temps cette transcription et la série d'images numériques qui lui correspond, dans la visionneuse Navimages.

En attendant une solution plus générique (qui consisterait à utiliser la DTD TEI pour structurer en XML la transcription du document numérisé, puis à publier les documents TEI produits dans une application PLEADE, ce qui suppose que le logiciel PLEADE accepte de tels documents), il est possible d'obtenir un tel mode d'affichage, à partir d'une transcription simplement saisie dans un élément scopecontent du document EAD, pourvu que cet élément soit doté d'un attribut altrender de valeur transcription.

Voici un exemple de mise en oeuvre de cette syntaxe dans la description d'une pièce (exemple extrait d'un document EAD produit par le Centre historique des Archives nationales dans le cadre du projet Napoléon) :

<c level="item">
 <did>
  <unitid type="sous-identifiant">pièce 1</unitid>
  <unittitle>Lettre autographe signée BP (<geogname normal="Roverbella (Lombardie, Italie)">Roverbella</geogname>).</unittitle>
  <unitdate normal="1797-01-17" calendar="revolutionnaire">28 nivôse [an V] (17 janvier 1797)</unitdate>
  <physdesc><extent>1 pièce</extent> manuscrite. <dimensions type="hauteur x largeur" unit="centimètre">37,5 x 23,5</dimensions></physdesc>
 </did>
 <scopecontent altrender="transcription" audience="external">
  <head>Transcription selon l'ouvrage de  Chantal de Tourtier-Bonazzi,
<emph render="italic">Napoléon, lettres d'amour à Joséphine</emph>,
présentées par Jean Tulard, Paris, Fayard, 1981 - lettre n°40, page 132-133</head>
  <p>Au quartier général, Roverbella, le 28 nivôse an [an V] de la République,
une et indivisible<note><p>La date du 18 messidor an IV
(6 juillet 1796) donnée dans le recueil publié par la reine Hortense a été reproduite
par tous les éditeurs successifs, à l'exception d'Haumont qui a adopté la date du 6 juillet 1797.</p></note></p>
  <p>Bonaparte, général en chef de l'armée d'Italie,</p>
  <p>A Joséphine.</p>
  <p>J'ai battu l'ennemi<note><p>Bataille de la Favorite.</p></note>. <persname normal="Kilmaine">Kilmaine</persname>
<note><p>Kilmaine (1751-1799), général irlandais au service de la France.</p></note> t'enverra la copie de la relation.
Je suis mort de fatigue. Je te prie de partir de suite pour te rendre à <geogname normal="Vérone (Italie)">Vérone</geogname>.
J'ai besoin de toi, car je crois que je vais être bien malade. Je te donne mille baisers. Je suis au lit.</p>
  <p>B.P.</p>
  <p>Adresse : A la citoyenne Bonaparte, à Milan<note><p>L'adresse n'est pas de la main de Bonaparte.</p></note>.</p>
 </scopecontent>
 <daogrp title="Lettres d'amour de Napoléon à Joséphine (1796-1813)" role="navimages:series">
  <daoloc role="navimages:image:first" href="400AP6_8/400AP6DOSSIER1_DOSSIER3/400AP6DOSSIER1/PIECE1/FRDAFANCH97_MIC001002559.JPG"/>
  <daoloc role="navimages:image:last" href="400AP6_8/400AP6DOSSIER1_DOSSIER3/400AP6DOSSIER1/PIECE1/FRDAFANCH97_MIC001002560.JPG"/>
 </daogrp>
</c>

Les sources de PLEADE incluent les programmes et fichiers nécessaires pour générer, dans la version HTML de l'instrument de recherche, depuis les premiers mots de la transcription, un lien vers un jeu de cadres présentant, à gauche, cette transcription (avec le rappel du "titre" PLEADE de l'unité documentaire et de son contexte archivistique), à droite, la visionneuse Navimages et la série d'images numériques associées.


© 2003, 2004, 2005 PLEADE / AJLSM / Anaphore
Des questions ? Des remarques ? Utilisez les listes de discussions ! Vous voulez l'utiliser ? Vous pouvez le télécharger !