Il y a 389 articles et 19 utilisateurs inscrits (ce bandeau est défini dans MediaWiki:Sitenotice)

« Pleade module METS » : différence entre les versions

De AJLSM
Aller à la navigation Aller à la recherche
← Modification précédenteModification suivante →

Groche (discussion | contributions)

2 groupes d'utilisateurs
312 modifications
annuler
VisuelWikicode
Ligne 176 : Ligne 176 :
Ce document est à utiliser en complément de la documentation ''Installation et exploitation de Pleade'' et du ''Module {{abbr|EADEAC}}''.
Ce document est à utiliser en complément de la documentation ''Installation et exploitation de Pleade'' et du ''Module {{abbr|EADEAC}}''.
=== Paramètres de publication ===
=== Paramètres de publication ===
Les paramètres de publication permettent d'indiquer là façons dont les documents {{METS}} seront interprétés à la publication.
Les paramètres de publication permettent d'indiquer là façons dont les documents {{METS}} seront interprétés à la publication. Le paramétrage se fait dans le fichier {{path|{{app}}/module-eadeac/conf/mets-documents-property-sets.xconf}}. Les paramètres indiqués dans ce fichier sont communs à tout les documents {{METS}}.
Le paramétrage correspondant se fait dans le fichier {{path|{{app}}/module-eadeac/conf/mets-documents-property-sets.xconf}}. Les paramètres indiqués dans ce fichier sont communs à tout les documents {{METS}}.


Cependant, lors de la publication d'un documents ou d'un répertoire, il est possible de spécifier un paramétrage particulier pour ces derniers. Cela se fait en allant dans l'onglet "Paramètre de publication" dans la page de publication des documents {{METS}}.
Noter, que comme avec le module {{EAD}}EAC, il est possible de spécifier un paramétrage particulier lors de la publication d'un documents ou d'un répertoire. Cela se fait en allant dans la page de publication des documents {{METS}} puis dans l'onglet « Paramètre de publication ».


Comme pour le module {{EAD}}, lors d'une re-publication, si on passe par la page de "gestion des documents {{METS}} publiés", les paramètres de publication seront conservés.
De la même façon, lors d'une re-publication, si l'on passe par la page de « Gestion des documents {{METS}} publiés », les paramètres de publication seront conservés.




==== Paramétrage des méta-données ====
==== Paramétrage des méta-données : {{tag|property {{attr|name}}="{{value|dc…}}"}} ====
Pour assurer l’interopérabilité, le module {{METS}} travail avec le format {{Dublin Core}}. De ce fait, chaque méta-données d'un document {{METS}} doit correspondre à un élément du {{Dublin Core}}.
Pour assurer l'inter-opérabilité, le module {{METS}} s'appuie sur le format {{Dublin Core}}. De ce fait, chaque méta-données d'un document {{METS}} correspond à un élément {{Dublin Core}}.
Avec ce mécanisme, les index correspondant à des méta-donnés seront toujours des éléments {{Dublin Core}}. Les méta-donnés seront ainsi traiter de façons automatique comme pour les éléments de l'{{EAD}}.
Par conséquent, les index correspondants à des méta-donnés seront toujours des éléments {{Dublin Core}}. Les méta-donnés seront ainsi traitées de façons automatiques comme pour les éléments de l'{{EAD}}.
Par exemple, l'index {{value|dctitle}} corresponds au champ {{DC}} {{value|dc:title}}.


Exemple, l'index correspondant à {{value|dc:title}} est {{value|dctitle}}, sans les « {{value|:}} » (deux points). On ajoute le préfix « {{value|dc}} » suivi du nom de l'élement sans le namespace.
La correspondance entre les méta-données d'un document {{METS}} et les méta-données du {{Dublin Core}} se fait dans le fichier {{path|{{app}}/module-mets/conf/mets-documents-property-sets.xconf}}, avec les propriétés de type {{attr|name}}="{{value|dc…}}" (p. ex. {{value|dccontributor}}, {{value|dcidentifier}}, etc.).


Le mapping entre les méta-données d'un document {{METS}} quelconque et ceux du {{Dublin Core}} se fait avec les propriétés des éléments de type dc.
Ces propriétés contiennent dans leur attribut {{attr|default}} une expression {{XPATH}} valide vers l'élément ou l'attribut du document {{METS}} auquel ils font référence. Par exemple, pour construire l'index pleade {{value|dcidentifier}} en récupérant la valeur de l'attribut {{attr|OBJID}} de chaque document {{METS}}, on fera le paramétrage suivant :
Ces propriétés contiennent dans leur champs "default" une expression {{XPATH}} correct vers la méta données auquel il font référence.
 
Exemple pour l'élément {{tag|dc:identifier}}, le paramétrage correspondant est :
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<property name="dcidentifier" type="dc" default="/mets/@OBJID" />
<property name="dcidentifier" type="dc" default="/mets/@OBJID" />
</syntaxhighlight>
</syntaxhighlight>
Ici, dans les documents mets, on considère que l'élément {{path|/mets/@OBJID}} correspondant à l'élément {{Dublin Core}} {{tag|indentifier}}.
On considérera que l'attribut {{path|/mets/@OBJID}} correspondant à l'élément {{Dublin Core}} {{value|indentifier}}.


Lorsque qu'un élément du {{Dublin Core}} peut correspondre à plusieurs type de méta données, dans le champs default, on spécifie la liste des {{XPATH}} des élément correspondant séparées par le caractère « {{value|;}} » (point-virgule).
===== Méta-données complexes =====
 
Lorsque qu'un élément du {{Dublin Core}} peut correspondre à plusieurs type de méta données, l'attribut {{attr|default}} spécifiera une liste de {{XPATH}} séparées par des « {{value|;}} » (point-virgule). Par exemple, si l'on veut construire l'élément {{DC}} {{value|dc:format}} à partir de plusieurs informations ({{attr|MIMETYPE}}, {{tag|page-count}} et {{attr|resolution}}), voici comment faire :
Exemple:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<property
<property
Ligne 209 : Ligne 205 :
/>
/>
</syntaxhighlight>
</syntaxhighlight>
On considère que l'élément {{value|dc:format}} correspond dans le {{METS}} aux éléments :
# {{path|/mets/dmdSec/mdWrap/@MIMETYPE}},
# {{path|/mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count}},
# {{path|/mets/amdSec/techMD/mdWrap/xmlData/*:root/*:resolution}}.


Ici, on considère que l'élément dc:format correspond dans le {{METS}} aux éléments suivant:
==== Champs de recherche par date : {{tag|property {{attr|name}}&#61;"{{value|empl-date-dc}}"}} ====
# {{path|/mets/dmdSec/mdWrap/@MIMETYPE}}
{|class="wikitable centre"
# {{path|/mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count}}
! Paramètre !! Défaut !! Valeurs possibles !! Description
# {{path|/mets/amdSec/techMD/mdWrap/xmlData/*:root/*:resolution}}
|-
| {{tag|property name&#61;"empl-date-dc"}} || {{value|date}}|| liste d'éléments {{DC}} ||
{{important|Cette fonctionnalité est encore expérimentale}}
Indique les éléments {{DC}} à considérer pour la gestion des recherches par date dans le module {{METS}}.


- La propriété "{{var|empl-date-dc}}" indique les éléments Dublin core à considérer pour la gestion des recherches par date dans le module {{METS}}.
Par « recherche par date », on entend la possibilité de faire des recherches sur des dates exactes ({{value|1779}}, {{value|1901}}, etc.) ou des écarts de dates ({{value|1779}} à {{value|1803}}, etc.).
Exemple:
|}
 
Si l'on veut, par exemple, que la recherche par date se fasse sur les index {{value|dccoverage}} et {{value|dcdate}}, on fera le paramétrage suivant :
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<property name="empl-date-dc" default="coverage;date"/>
<property name="empl-date-dc" default="coverage;date"/>
</syntaxhighlight>
</syntaxhighlight>
les recherches par date se feront sur les champs dccoverage et dcdate.


Par "recherche par date", on attend la possibilité de faire des recherche sur des plages ou des écarts de date ou bien sur des dates exacts. Cette fonctionnalité est encore expérimentale.
==== Bloc référençant les images {{JPEG}} : {{tag|property {{attr|name}}&#61;"{{value|filegrp-use-jpg}}"}} ====
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"filegrp-use-jpg"}} || {{value|JPEG}}|| chaîne de caractères ||
Indique le bloc d'éléments qui contient les références vers les fichiers {{JPEG}}. Cela ''doit correspondre'' à la valeur de l'attribut {{attr|USE}} de l'éléments {{tag|fileGrp}}, dans le document {{METS}}.
|}


 
Par exemple, la configuration par défaut ({{attr|defaut}}="{{value|JPEG}}") fait référence au bloc suivant dans le document {{METS}} :
- la propriété "{{cmd|filegrp-use-jpg}}": indique les types des éléments fileGrp (attribut "USE") qui contiennent les références vers les fichiers JPEG.
 
Exemple: <property name="filegrp-use-jpg" default="JPEG"/> indique ce type d'élément:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<fileGrp USE="JPEG">
<fileGrp USE="JPEG">
<file ID="jpeg-100779-10000001" MIMETYPE="image/jpeg" AMDID="doc-100779" DMDID="f-1007791">
<file ID="jpeg-100779-10000001" MIMETYPE="text/xml" AMDID="doc-100779">
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./jpeg-100779/10000001.jpg" LOCTYPE="URL"/>
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./jpeg-100779/10000001.xml" LOCTYPE="URL"/>
</file>
</file>
<file ID="jpeg-100779-10000002" MIMETYPE="image/jpeg" AMDID="doc-100779" DMDID="f-1007792">
⋮
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./jpeg-100779/10000002.jpg" LOCTYPE="URL"/>
</file>
...
</fileGrp>
</fileGrp>
</syntaxhighlight>
</syntaxhighlight>


==== Bloc référençant les images {{ALTO}} : {{tag|property {{attr|name}}&#61;"{{value|filegrp-use-alto}}"}} ====
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"filegrp-use-alto"}} || {{value|ALTO}}|| chaîne de caractères ||
Fonctionnement identique à la propriété {{tag|property {{attr|name}}&#61;"{{value|filegrp-use-jpg}}"}}
Indique le bloc d'éléments qui contient les références vers les fichiers {{ALTO}}.
|}


- la propriéte "{{var|filegrp-use-alto}}" fonctionne comme "filegrp-use-jpg". Il permet d'indiquer les élément de type {{ALTO}}.
Par exemple, la configuration par défaut ({{attr|defaut}}="{{value|ALTO}}") fait référence au bloc suivant dans le document {{METS}} :
 
Exemple:  <property name="filegrp-use-alto" default="ALTO"/> indique  ce type d'élément:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<fileGrp USE="ALTO">
<fileGrp USE="ALTO">
Ligne 249 : Ligne 259 :
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./alto-100779/10000001.xml" LOCTYPE="URL"/>
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./alto-100779/10000001.xml" LOCTYPE="URL"/>
</file>
</file>
<file ID="alto-100779-10000002" MIMETYPE="text/xml" AMDID="doc-100779">
⋮
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./alto-100779/10000002.xml" LOCTYPE="URL"/>
</file>
...
</fileGrp>
</fileGrp>
</syntaxhighlight>
</syntaxhighlight>
- la propriéte "{{var|filegrp-use-tiff}}" fonctionne comme "{{var|filegrp-use-jpg}}". Il permet d'indiquer les élément de type TIFF.


Exemple: <property name="filegrp-use-tiff" default="TIFF"/> indique  ce type d'élément:
==== Bloc référençant les images {{TIFF}} : {{tag|property {{attr|name}}&#61;"{{value|filegrp-use-tiff}}"}} ====
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"filegrp-use-tiff"}} || {{value|TIFF}}|| chaîne de caractères ||
Fonctionnement identique à la propriété {{tag|property {{attr|name}}&#61;"{{value|filegrp-use-jpg}}"}}
Indique le bloc d'éléments qui contient les références vers les fichiers {{TIFF}}.
|}
 
Par exemple, la configuration par défaut ({{attr|defaut}}="{{value|TIFF}}") fait référence au bloc suivant dans le document {{METS}} :
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<fileGrp USE="TIFF">
<fileGrp USE="TIFF">
<file ID="tiff-100779-10000001" MIMETYPE="image/tiff" AMDID="doc-100779" DMDID="f-1007791">
<file ID="tiff-100779-10000001" MIMETYPE="text/xml" AMDID="doc-100779">
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./tiff-100779/10000001.tif" LOCTYPE="URL"/>
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./tiff-100779/10000001.xml" LOCTYPE="URL"/>
</file>
<file ID="tiff-100779-10000002" MIMETYPE="image/tiff" AMDID="doc-100779" DMDID="f-1007792">
<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./tiff-100779/10000002.tif" LOCTYPE="URL"/>
</file>
</file>
⋮
</fileGrp>
</fileGrp>
</syntaxhighlight>
</syntaxhighlight>


- La propriété "{{var|subset-list}}" indique le subset auquel appartient le document mets
==== Subset par défaut : {{tag|property {{attr|name}}&#61;"{{value|subset-list}}"}} ====
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"subset-list"}} || {{value|vide}}|| chaîne de caractères ||
Indique le subset auquel appartient le document {{METS}}.
|}
 
==== {{tag|property {{attr|name}}&#61;"{{value|docUrl}}"}} ====
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"docUrl"}} || {{value|vide}} ||
{{todo|?}}
||
{{important|Propriété utilisée par le système. Il ne faut pas le modifier}}
|}
 
=== Visionneuse ===
==== Navigation par folio : {{tag|property {{attr|name}}&#61;"{{value|mets-folio-type}}"}} ====
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"mets-folio-type"}} || {{value|logical;physical}}|| chaîne de caractères ||
Indique les éléments {{tag|structMap}} qui contiennent les informations de foliotage.
 
Ce sont ces informations qui seront utilisés dans la navigation par folio de la visionneuse {{METS-ALTO}}.


- La propriété "{{var|docUrl}}" est utilisé par le système. Il ne faut pas le modifier.
Les valeurs du paramètre ''doivent correspondre'' à la valeur d'un  attribut {{attr|TYPE}} d'un élément {{tag|strucMap}}, dans le document {{METS}}.
|}


-La propriété "{{var|mets-folio-type}}" indique les types de structMap qui contiennent des informations de foliotage. Ce sont ces informations qui seront utilisés dans la navigation par foliotage de la visionneuse {{METS-ALTO}}.
Par exemple, la configuration par défaut ({{attr|defaut}}="{{value|logical;physical}}"), considère que les {{tag|strucMap}} de type {{attr|pysical}} ou {{attr|logical}} contiennent des informations de foliotage. Et fait référence au bloc suivant dans le document {{METS}} :
<syntaxhighlight lang="xml">
<structMap TYPE="logical">
<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
⋮
</structMap>
<structMap TYPE="physical">
<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
⋮
</structMap>
</syntaxhighlight>
{{important|le document {{METS}} doit contenir '''au moins un {{tag|strucMap}} de type {{attr|physical}}'''. Si cette contrainte n'est pas respecté, la publication échoue dès son lancement}}


Exemple: <property name="mets-folio-type" default="logical;physical" />
==== Navigation par table des matières : {{tag|property {{attr|name}}&#61;"{{value|mets-tdm-type}}"}} ====
Dans cette exemple, on considére que les strucMpa de type "pysical" ou "logical" contiennent des informations de foliotage.
{|class="wikitable centre"
! Paramètre !! Défaut !! Valeurs possibles !! Description
|-
| {{tag|property name&#61;"mets-tdm-type"}} || {{value|book;tdm}}|| chaîne de caractères ||
Indique les types de {{tag|structMap}} qui contiennent des informations pour la table des matières.


{{remarque|le document {{METS}} doit contenir au moins un strucMap de type "physical". Si cette contrainte n'est pas respecté, la publication échoue dés son lancement}}
Ce sont ces informations qui seront utilisées dans la navigation par tables des matières de la visionneuse {{METS-ALTO}}.


Les valeurs du paramètre ''doivent correspondre'' à la valeur d'un  attribut {{attr|TYPE}} d'un élément {{tag|strucMap}}, dans le document {{METS}}.
|}


- La propriété "{{var|mets-tdm-type}}" indique les types de structMap qui contiennent des informations pour la table des matiéres. Ce sont ces informations qui seront utilisés dans la navigation par tables des matières de la visionneuse {{METS-ALTO}}.
Par exemple, la configuration par défaut ({{attr|defaut}}="{{value|book;tdm}}"), considère que les {{tag|strucMap}} de type {{attr|book}} ou {{attr|tdm}} contiennent des informations de la table des matières. Et fait référence au bloc suivant dans le document {{METS}} :
Exemple: <property name="mets-tdm-type" default="book;tdm" />
<syntaxhighlight lang="xml">
<structMap TYPE="book">
<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
⋮
</structMap>
<structMap TYPE="tdm">
<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
⋮
</structMap>
</syntaxhighlight>


=== Formulaire de recherches ===
=== Formulaire de recherches ===

Version du 2 janvier 2013 à 14:00

Cette section décrit l'utilisation du METS dans Pleade, pour plus d'information sur la spécification, voir la section METS.


To do :
L'intégration de la documentation de Modou est partielle, il faut la complétée/terminée'. Cela concerne les sections :
  1. Paramètres d'administration
  2. Paramètres de publication
    1. Paramétrage des méta-données
  3. Formulaire de recherches
  4. Graphisme
.

Ce document est à utiliser en complément de la documentation Installation et exploitation de Pleade et du Module EADEAC.

Paramètres d'administration

Les paramètres d'administration du module METS se situe dans le fichier <app>/WEB-INF/properties/pleade-mets.properties

Notice :
L'utilisation de caractères non-imprimables (p. ex. espace insécable) dans la valeur des différents paramètre est à proscrire. En effet, il seront interprétés comme la fin de la valeur, il s'ensuivra des comportements abérrants.

pleade.mets-docs-dir

Paramètre Défaut Valeurs possible Description
pleade.mets-docs-dir context://module-mets/exemples/mets
  • /chemin/absolu/vers/les/documents
  • context://chemin/relatif/à/l'application

Indique le répertoire contenant les documents METS à publier. La valeur de ce paramètre peut être donner soit en indiquant :

  • un chemin absolue depuis la racine du serveur.
  • le schème context:// pour indiquer un répertoire qui se trouve à l'intérieur de l'application.

pleade.mets-jpeg-dir

Paramètre Défaut Valeurs possible Description
pleade.mets-jpeg-dir vide /chemin/absolu/vers/les/images-mets

Ce paramètre donne le chemin d'accès du répertoire contenant les document JPEG liés aux documents METS. La valeur de ce paramètre doit être un chemin absolue depuis la racine du serveur.


pleade.mets-alto-dir

Paramètre Défaut Valeurs possible Description
pleade.mets-alto-dir __DEFAULT__ __AVAILABLE__

Ce paramètre donne le chemin d'accès du répertoire contenant les documents ALTO liés aux METS.


Remarques : Si les deux paramètres précédent sont vides, on considère par défaut que les documents numériques qu'ils indiquent se trouvent dans le même répertoire que le document METS correspondant.

pleade.mets-file-prefix

Paramètre Défaut Valeurs possible Description
pleade.mets-file-prefix vide chaîne de caractères

Ce paramètre est utilisé dans le cas où les répertoires contenant les fichiers METS sont susceptibles de contenir d'autres types de fichiers XML (ALTO, CSV-XML, etc.). Ce paramètre va contenir le préfixe commun aux fichiers METS.

Par exemple, si les fichiers METS sont nommés: mets-20889889.xml, mets-786857567.xml, mets-907979797, ... on définira le préfix pleade.mets-file-prefix=mets-

pleade.sdx-mets-repository

Paramètre Défaut Valeurs possible Description
pleade.sdx-mets-repository vide
  • MYSQL:dbName,
  • POSTGRESQL:dbName
  • ORACLE:dbName

Indique la méthode de stockage (HSQL ou base de données) des index. Il contient la même valeur que le paramètre pleade.sdx-ead-repository. S'il est vide, les données d'indexation des fichiers METS seront entièrement stockés en système de fichiers.

pleade.mets-active-basket

Paramètre Défaut Valeurs possible Description
pleade.mets-active-basket true
  • true,
  • false

Permet l'activation de la gestion du panier de notice pour le module METS.

pleade.mets-active-pdf

Paramètre Défaut Valeurs possible Description
pleade.mets-active-pdf true
  • true,
  • false

Permet l'activation de la génération au format PDF de notice pour le module mets.

pleade.viewer.mets-search-pan

Paramètre Défaut Valeurs possible Description
pleade.viewer.mets-search-pan true
  • true,
  • false

Dans la visionneuse METS-ALTO, active l'affichage du panneau latéral de recherche METS.

pleade.viewer.export-txt.enabled

Paramètre Défaut Valeurs possible Description
pleade.viewer.export-txt.enabled true
  • true,
  • false

Dans la visionneuse METS alto, active le bouton d'export au format « texte brute » de l'image actuelle.

pleade.viewer.mets.nav-folio.enabled

Paramètre Défaut Valeurs possible Description
pleade.viewer.mets.nav-folio.enabled true
  • true,
  • false

Dans la visionneuse METS-ALTO, active la navigation par folio.

pleade.viewer.mets.nav-tdm.enabled

Paramètre Défaut Valeurs possible Description
pleade.viewer.mets.nav-tdm.enabled true
  • true,
  • false

Dans la visionneuse METS-ALTO, active la navigation par table des matières

Important :
La fonctionnalité est encore expérimentale.

pleade.viewer.mets-search-pan.suggest.nb

Paramètre Défaut Valeurs possible Description
pleade.viewer.mets-search-pan.suggest.nb 3 n (entier positif ≥3)
To do :
Cette fonction n'est pas intuitive et le paramètre à besoin d'être mieux expliquer.

Dans la visionneuse mets alto, indique le nombre de caractères à partir duquel l'auto-complétion s'active lors de la saisie dans le panneau de recherche.


Remarques :

  1. L'auto-complétion de la saisie ne s'active ne s'active que lorsque l'utilisateur utilise le caractères étoile (*) à la fin des lettres saisies.
  2. Pour des soucis de performance, on conseille de ne jamais donner une valeur inférieur à 3 pour ce paramètre. Cela s'explique par le fait que l'auto-complétion se manifeste par un "highlight" des mots correspondants à la saisie partielle. Ainsi, si on indique par exemple la valeur 2, dés que l'utilise saisie deux lettres (et une étoile) tout les mots y compris les articles qui commencent par ces lettres sont surlignés. Ce phénomène risque de ralentir fortement la navigation de l'utilisateur, voire même faire planter son navigateur internet.

pleade.viewer.mets-search-pan.suggest.aim

Paramètre Défaut Valeurs possible Description
pleade.viewer.mets-search-pan.suggest.aim begin
  • begin,
  • contain,
  • end.
To do :
Cette fonction est en conflit avec l'utilisation d'un caractère joker tel que * (astérisque), c'est lui qui est censé indiqué la direction de la recherche.

Indique le sens de recherche pour l'auto-complétion de la saisie. Trois valeurs sont possibles :

  • begin : les mots trouvés sont ceux commencent par les caractères saisis. C'est le comportement par défaut.
  • contain : les mots trouvés sont ceux contenant les caractères saisis.
  • end : les mots trouvés sont ceux se terminant par les caractères saisies

Cette section décrit l'utilisation du METS dans Pleade, pour plus d'information sur la spécification, voir la section METS.


To do :
L'intégration de la documentation de Modou est partielle, il faut la complétée/terminée'. Cela concerne les sections :
  1. Paramètres d'administration
  2. Paramètres de publication
    1. Paramétrage des méta-données
  3. Formulaire de recherches
  4. Graphisme
.

Ce document est à utiliser en complément de la documentation Installation et exploitation de Pleade et du Module EADEAC.

Paramètres de publication

Les paramètres de publication permettent d'indiquer là façons dont les documents METS seront interprétés à la publication. Le paramétrage se fait dans le fichier <app>/module-eadeac/conf/mets-documents-property-sets.xconf. Les paramètres indiqués dans ce fichier sont communs à tout les documents METS.

Noter, que comme avec le module EADEAC, il est possible de spécifier un paramétrage particulier lors de la publication d'un documents ou d'un répertoire. Cela se fait en allant dans la page de publication des documents METS puis dans l'onglet « Paramètre de publication ».

De la même façon, lors d'une re-publication, si l'on passe par la page de « Gestion des documents METS publiés », les paramètres de publication seront conservés.


Paramétrage des méta-données : <property name="dc…">

Pour assurer l'inter-opérabilité, le module METS s'appuie sur le format Dublin Core. De ce fait, chaque méta-données d'un document METS correspond à un élément Dublin Core. Par conséquent, les index correspondants à des méta-donnés seront toujours des éléments Dublin Core. Les méta-donnés seront ainsi traitées de façons automatiques comme pour les éléments de l'EAD. Par exemple, l'index dctitle corresponds au champ Dublin Core dc:title.

La correspondance entre les méta-données d'un document METS et les méta-données du Dublin Core se fait dans le fichier <app>/module-mets/conf/mets-documents-property-sets.xconf, avec les propriétés de type name="dc…" (p. ex. dccontributor, dcidentifier, etc.).

Ces propriétés contiennent dans leur attribut default une expression XPath valide vers l'élément ou l'attribut du document METS auquel ils font référence. Par exemple, pour construire l'index pleade dcidentifier en récupérant la valeur de l'attribut OBJID de chaque document METS, on fera le paramétrage suivant : 

	<property name="dcidentifier" type="dc" default="/mets/@OBJID" />

On considérera que l'attribut /mets/@OBJID correspondant à l'élément Dublin Core indentifier.

Méta-données complexes

Lorsque qu'un élément du Dublin Core peut correspondre à plusieurs type de méta données, l'attribut default spécifiera une liste de XPath séparées par des « ; » (point-virgule). Par exemple, si l'on veut construire l'élément Dublin Core dc:format à partir de plusieurs informations (MIMETYPE, <page-count> et resolution), voici comment faire : 

	<property
		name="dcformat"
		type="dc"
		default="/mets/dmdSec/mdWrap/@MIMETYPE;/mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count;/mets/amdSec/techMD/mdWrap/xmlData/*:root/*:resolution"
	/>

On considère que l'élément dc:format correspond dans le METS aux éléments :

  1. /mets/dmdSec/mdWrap/@MIMETYPE,
  2. /mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count,
  3. /mets/amdSec/techMD/mdWrap/xmlData/*:root/*:resolution.

Champs de recherche par date : <property name="empl-date-dc">

Paramètre Défaut Valeurs possibles Description
<property name="empl-date-dc"> date liste d'éléments Dublin Core
Important :
Cette fonctionnalité est encore expérimentale.

Indique les éléments Dublin Core à considérer pour la gestion des recherches par date dans le module METS.

Par « recherche par date », on entend la possibilité de faire des recherches sur des dates exactes (1779, 1901, etc.) ou des écarts de dates (1779 à 1803, etc.).

Si l'on veut, par exemple, que la recherche par date se fasse sur les index dccoverage et dcdate, on fera le paramétrage suivant : 

	<property name="empl-date-dc" default="coverage;date"/>

Bloc référençant les images JPEG : <property name="filegrp-use-jpg">

Paramètre Défaut Valeurs possibles Description
<property name="filegrp-use-jpg"> JPEG chaîne de caractères

Indique le bloc d'éléments qui contient les références vers les fichiers JPEG. Cela doit correspondre à la valeur de l'attribut USE de l'éléments <fileGrp>, dans le document METS.

Par exemple, la configuration par défaut (defaut="JPEG") fait référence au bloc suivant dans le document METS : 

	<fileGrp USE="JPEG">
		<file ID="jpeg-100779-10000001" MIMETYPE="text/xml" AMDID="doc-100779">
			<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./jpeg-100779/10000001.xml" LOCTYPE="URL"/>
		</file>
		⋮
	</fileGrp>

Bloc référençant les images ALTO : <property name="filegrp-use-alto">

Paramètre Défaut Valeurs possibles Description
<property name="filegrp-use-alto"> ALTO chaîne de caractères

Fonctionnement identique à la propriété <property name="filegrp-use-jpg"> Indique le bloc d'éléments qui contient les références vers les fichiers ALTO.

Par exemple, la configuration par défaut (defaut="ALTO") fait référence au bloc suivant dans le document METS : 

	<fileGrp USE="ALTO">
		<file ID="alto-100779-10000001" MIMETYPE="text/xml" AMDID="doc-100779">
			<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./alto-100779/10000001.xml" LOCTYPE="URL"/>
		</file>
		⋮
	</fileGrp>

Bloc référençant les images TIFF : <property name="filegrp-use-tiff">

Paramètre Défaut Valeurs possibles Description
<property name="filegrp-use-tiff"> TIFF chaîne de caractères

Fonctionnement identique à la propriété <property name="filegrp-use-jpg"> Indique le bloc d'éléments qui contient les références vers les fichiers TIFF.

Par exemple, la configuration par défaut (defaut="TIFF") fait référence au bloc suivant dans le document METS : 

	<fileGrp USE="TIFF">
		<file ID="tiff-100779-10000001" MIMETYPE="text/xml" AMDID="doc-100779">
			<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./tiff-100779/10000001.xml" LOCTYPE="URL"/>
		</file>
		⋮
	</fileGrp>

Subset par défaut : <property name="subset-list">

Paramètre Défaut Valeurs possibles Description
<property name="subset-list"> vide chaîne de caractères

Indique le subset auquel appartient le document METS.

<property name="docUrl">

Paramètre Défaut Valeurs possibles Description
<property name="docUrl"> vide
To do :
?.
Important :
Propriété utilisée par le système. Il ne faut pas le modifier.

Visionneuse

Paramètre Défaut Valeurs possibles Description
<property name="mets-folio-type"> logical;physical chaîne de caractères

Indique les éléments <structMap> qui contiennent les informations de foliotage.

Ce sont ces informations qui seront utilisés dans la navigation par folio de la visionneuse METS-ALTO.

Les valeurs du paramètre doivent correspondre à la valeur d'un attribut TYPE d'un élément <strucMap>, dans le document METS.

Par exemple, la configuration par défaut (defaut="logical;physical"), considère que les <strucMap> de type pysical ou logical contiennent des informations de foliotage. Et fait référence au bloc suivant dans le document METS : 

	<structMap TYPE="logical">
		<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
		⋮
	</structMap>
	<structMap TYPE="physical">
		<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
		⋮
	</structMap>
Important :
le document METS doit contenir au moins un <strucMap> de type physical. Si cette contrainte n'est pas respecté, la publication échoue dès son lancement.
Paramètre Défaut Valeurs possibles Description
<property name="mets-tdm-type"> book;tdm chaîne de caractères

Indique les types de <structMap> qui contiennent des informations pour la table des matières.

Ce sont ces informations qui seront utilisées dans la navigation par tables des matières de la visionneuse METS-ALTO.

Les valeurs du paramètre doivent correspondre à la valeur d'un attribut TYPE d'un élément <strucMap>, dans le document METS.

Par exemple, la configuration par défaut (defaut="book;tdm"), considère que les <strucMap> de type book ou tdm contiennent des informations de la table des matières. Et fait référence au bloc suivant dans le document METS : 

	<structMap TYPE="book">
		<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
		⋮
	</structMap>
	<structMap TYPE="tdm">
		<div LABEL="Annonces, Affiches, nouvelles et avis divers de l'Orléanais"
		⋮
	</structMap>

Formulaire de recherches

Les formulaires de recherche pour le module METS marche de la même manière que le formulaire du module eadeac. Voir la documentation d'exploitation de Pleade pour plus de détails.

Graphisme

Le graphisme du module METS marche de la même manière que le graphisme de pleade et du module eadeac. Voir la documentation d'exploitation de Pleade pour plus de détails.


Spécification client

Notice :
Notice :
La spécification s'appuiera sur la [[:Media:2010-Use-of-METS-and-ALTO-in-the-Australian-Newspapers-Digitisation-Program-(ANDP)-at-the-National-Library-of-Australia-(NLA).okular|spécification utilisée par la Librairie Nationale d'Australie]]<ref>[of METS and ALTO in the Australian Newspapers Digitisation Program (ANDP) at the National Library of Australia (NLA)]</ref>.

Arborescence de production

De part leur nature, les fichiers METS impliquent d'adopter une arborescence de fichiers particulière. En effet, les fichiers METS non que peu de sens par eux mêmes et sont toujours liés à d'autres fichiers (PDF, ALTO, etc.).

Important :
Pour le moment Pleade ne gère que les fichiers liés qui le sont par des URLs relatives.
Important :
le fichier METS doit :
  1. être préfixés par la chaîne mets-, de façon à pouvoir le distinguer des autres fichiers XML éventuellement présent ;
  2. se terminer par l'extension .xml.
  3. se conformer à l'expression régulière : ^(([^\.]+)|mets\-(.+)\.(xml|XML))$
Si ce n'est pas le cas, le fichier ne sera pas lister.

Il est donc nécessaire d'adopter l'arborescence suivante pour vos fichier : 

mets/
├── alto-{doc-id}/
│   ├── file-######.tif
│   ├── ...
│   └── file-######.tif
├── jpeg-{doc-id}/
│   ├── file-######.tif
│   ├── ...
│   └── file-######.jpg
├── tiff-{doc-id}/
│   ├── file-######.tif
│   ├── ...
│   └── file-######.tif
└── mets-{doc-id}.xml

Externalisation des Fichiers ALTO

On externalise les fichiers ALTO à l'aide de l'élément <fileGrp>. On précise le type du groupe à l'aide de l'attribut USE auquel on assigne la valeur ALTO.

Notice :
On préfère la valeur ALTO car la valeur OCR est trop générique et peut désigner des fichiers plein texte au format *.txt..
<fileGrp USE="ALTO">
	<file ID="alto-107516-10000001" MIMETYPE="text/xml" AMDID="doc-107516">
		<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./alto-107516/10000001.xml" LOCTYPE="URL"/>
	</file>
</fileGrp>

Lier l'oeuvre complète dans un <structMap>

La conversation representing page images and entire works in METS sur la liste de diffusion METS de la librairie du congrès propose la solution suivante : 

Note that the root <div> has an immediate child <fptr> that point to the pdf for the issue of New Age as a whole.
This is appropriate, because the root <div> represents the entire issue. But the root <div> has child <div> elements
that are siblings of the <fptr> pointing to the comprehensive pdf.  Each of these <div> elements represent individual pages.
Each of these <div> elements has child <fptr> elements that point to the content files that manifest the individual pages.

C'est à dire, placer le lien vers le document représentant l'oeuvre complète à la racine du 1er <div> du <structMap>. 

<METS:structMap TYPE="physical">

    <METS:div LABEL="New Age (Vol. 11, No. 3)" DMDID="DM1" TYPE="object">
        <METS:fptr FILEID="FID97"/>     <!--fptr to PDF file-->

        <METS:div ORDER="1" LABEL="1" ADMID="RMD1" TYPE="page_image">
            <METS:fptr FILEID="FID1"/>
            <METS:fptr FILEID="FID25"/>
            <METS:fptr FILEID="FID49"/>
            <METS:fptr FILEID="FID73"/>
        </METS:div>

        <METS:div ORDER="2" LABEL="2" ADMID="RMD1" TYPE="page_image">
            <METS:fptr FILEID="FID2"/>
            <METS:fptr FILEID="FID26"/>
            <METS:fptr FILEID="FID50"/>
            <METS:fptr FILEID="FID74"/>
        </METS:div>

        <METS:div ORDER="3" LABEL="3" ADMID="RMD1" TYPE="page_image">
            <METS:fptr FILEID="FID3"/>
            <METS:fptr FILEID="FID27"/>
            <METS:fptr FILEID="FID51"/>
            <METS:fptr FILEID="FID75"/>
        </METS:div>
        ...
    </METS:div>
</METS:structMap>

Attribut USE et ses valeurs

Dans les éléments <fileGrp> l'attribut USE nous permet de faire des utilisations différentes des groupes de fichiers selon la valeur de l'attribut<ref>METS documentation: <fileGrp></ref>. Cela autorise la présence de plusieurs groupes ayant le même attribut USE et donc le même type d'utilisation, ce qui n'est pas possible avec l'attribut ID, qui doit être unique dans le document. L'attribut USE est donc nécessaire pour être compatible avec Pleade. Nous avons définit 3 valeurs possibles pour l'attribut USE :

  • TIFF (originale, conservation),
  • JPEG (image transformée ou non, en consultation),
  • ALTO (OCR étant trop générique et pouvant faire référence à des fichiers textes non structurés).

Si vous le souhaitez vous pouvez renseigner un attribut ID (unique) pour vos éléments <fileGrp>, il ne sera pas utiliser pour le moment.

StructMap/TYPE

Nous utilisons l'attribut TYPE de façon à distinguer les différents type d'organisation<ref>METS documentation: TYPE</ref> (intellectuelle vs. physique) des documents. À l'heure actuelle les valeurs on les sens suivants pour notre application :

  • logical : organisation intellectuelle ;
  • physical : organisation des fichiers numérisés (tels que sur le système de fichier Linux/Windows).

Si l'attribut TYPE n'est pas fourni nous considérons le <structMap> comme étant de type physical.

Références

<references/>

[[category:METS]]

Formulaire de recherches

Les formulaires de recherche pour le module METS marche de la même manière que le formulaire du module eadeac. Voir la documentation d'exploitation de Pleade pour plus de détails.

Graphisme

Le graphisme du module METS marche de la même manière que le graphisme de pleade et du module eadeac. Voir la documentation d'exploitation de Pleade pour plus de détails.


Spécification client

Notice :
Notice :

Arborescence de production

De part leur nature, les fichiers METS impliquent d'adopter une arborescence de fichiers particulière. En effet, les fichiers METS non que peu de sens par eux mêmes et sont toujours liés à d'autres fichiers (PDF, ALTO, etc.).

Important :
Pour le moment Pleade ne gère que les fichiers liés qui le sont par des URLs relatives.
Important :
le fichier METS doit :
  1. être préfixés par la chaîne mets-, de façon à pouvoir le distinguer des autres fichiers XML éventuellement présent ;
  2. se terminer par l'extension .xml.
  3. se conformer à l'expression régulière : ^(([^\.]+)|mets\-(.+)\.(xml|XML))$
Si ce n'est pas le cas, le fichier ne sera pas lister.

Il est donc nécessaire d'adopter l'arborescence suivante pour vos fichier : 

mets/
├── alto-{doc-id}/
│   ├── file-######.tif
│   ├── ...
│   └── file-######.tif
├── jpeg-{doc-id}/
│   ├── file-######.tif
│   ├── ...
│   └── file-######.jpg
├── tiff-{doc-id}/
│   ├── file-######.tif
│   ├── ...
│   └── file-######.tif
└── mets-{doc-id}.xml

Externalisation des Fichiers ALTO

On externalise les fichiers ALTO à l'aide de l'élément <fileGrp>. On précise le type du groupe à l'aide de l'attribut USE auquel on assigne la valeur ALTO.

Notice :
On préfère la valeur ALTO car la valeur OCR est trop générique et peut désigner des fichiers plein texte au format *.txt..
<fileGrp USE="ALTO">
	<file ID="alto-107516-10000001" MIMETYPE="text/xml" AMDID="doc-107516">
		<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./alto-107516/10000001.xml" LOCTYPE="URL"/>
	</file>
</fileGrp>

Lier l'oeuvre complète dans un <structMap>

La conversation representing page images and entire works in METS sur la liste de diffusion METS de la librairie du congrès propose la solution suivante : 

Note that the root <div> has an immediate child <fptr> that point to the pdf for the issue of New Age as a whole.
This is appropriate, because the root <div> represents the entire issue. But the root <div> has child <div> elements
that are siblings of the <fptr> pointing to the comprehensive pdf.  Each of these <div> elements represent individual pages.
Each of these <div> elements has child <fptr> elements that point to the content files that manifest the individual pages.

C'est à dire, placer le lien vers le document représentant l'oeuvre complète à la racine du 1er <div> du <structMap>. 

<METS:structMap TYPE="physical">

    <METS:div LABEL="New Age (Vol. 11, No. 3)" DMDID="DM1" TYPE="object">
        <METS:fptr FILEID="FID97"/>     <!--fptr to PDF file-->

        <METS:div ORDER="1" LABEL="1" ADMID="RMD1" TYPE="page_image">
            <METS:fptr FILEID="FID1"/>
            <METS:fptr FILEID="FID25"/>
            <METS:fptr FILEID="FID49"/>
            <METS:fptr FILEID="FID73"/>
        </METS:div>

        <METS:div ORDER="2" LABEL="2" ADMID="RMD1" TYPE="page_image">
            <METS:fptr FILEID="FID2"/>
            <METS:fptr FILEID="FID26"/>
            <METS:fptr FILEID="FID50"/>
            <METS:fptr FILEID="FID74"/>
        </METS:div>

        <METS:div ORDER="3" LABEL="3" ADMID="RMD1" TYPE="page_image">
            <METS:fptr FILEID="FID3"/>
            <METS:fptr FILEID="FID27"/>
            <METS:fptr FILEID="FID51"/>
            <METS:fptr FILEID="FID75"/>
        </METS:div>
        ...
    </METS:div>
</METS:structMap>

Attribut USE et ses valeurs

Dans les éléments <fileGrp> l'attribut USE nous permet de faire des utilisations différentes des groupes de fichiers selon la valeur de l'attribut<ref>METS documentation: <fileGrp></ref>. Cela autorise la présence de plusieurs groupes ayant le même attribut USE et donc le même type d'utilisation, ce qui n'est pas possible avec l'attribut ID, qui doit être unique dans le document. L'attribut USE est donc nécessaire pour être compatible avec Pleade. Nous avons définit 3 valeurs possibles pour l'attribut USE :

  • TIFF (originale, conservation),
  • JPEG (image transformée ou non, en consultation),
  • ALTO (OCR étant trop générique et pouvant faire référence à des fichiers textes non structurés).

Si vous le souhaitez vous pouvez renseigner un attribut ID (unique) pour vos éléments <fileGrp>, il ne sera pas utiliser pour le moment.

StructMap/TYPE

Nous utilisons l'attribut TYPE de façon à distinguer les différents type d'organisation<ref>METS documentation: TYPE</ref> (intellectuelle vs. physique) des documents. À l'heure actuelle les valeurs on les sens suivants pour notre application :

  • logical : organisation intellectuelle ;
  • physical : organisation des fichiers numérisés (tels que sur le système de fichier Linux/Windows).

Si l'attribut TYPE n'est pas fourni nous considérons le <structMap> comme étant de type physical.

Références

<references/>

Récupérée de "https://mediawiki.ajlsm.com/index.php?title=Pleade_module_METS&oldid=1412"