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
intégration *partielle* de la doc à Modou
paramètre d'administration
Ligne 8 : Ligne 8 :
# Graphisme
# Graphisme
}}
}}
Ce document est à utiliser en complément de la documentation d'installation/exploitation de Pleade et du module eadeac.
Ce document est à utiliser en complément de la documentation ''Installation et exploitation de Pleade'' et du ''Module {{value|EADEAC}}''.
== Paramètres d'administration ==
=== Paramètres d'administration ===


Les paramètres d'administration du module mets se situe dans le fichier {{path|{{app}}/WEB-INF/properties/pleade-mets.properties}}
Les paramètres d'administration du module METS se situe dans le fichier {{path|{{app}}/WEB-INF/properties/pleade-mets.properties}}
Le détail sur les différentes propriétés est donnés ci-dessous.
{{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}}


{{var|pleade.mets-docs-dir}}
==== {{var|pleade.mets-docs-dir}} ====
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. Soit, en utilisant la propriété "context://" pour indiquer un répertoire qui se trouve à l'intérieur de l'application.
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.mets-docs-dir}} || {{path|context://module-mets/exemples/mets}} ||
* {{path|/chemin/absolu/vers/les/documents}}
* {{path|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 {{value|context://}} pour indiquer un répertoire qui se trouve à l'intérieur de l'application.
|}


==== {{var|pleade.mets-jpeg-dir}} ====
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.mets-jpeg-dir}} || {{value|vide}} || {{path|/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.
|}


{{var|pleade.mets-jpeg-dir}}
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.


{{var|pleade.mets-alto-dir}}
==== {{var|pleade.mets-alto-dir}} ====
Ce paramètre donne le chemin d'accès du répertoire contenant les documents alto liés aux mets.
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|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.


{{remarque|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}}
{{remarque|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}}
|}


{{var|pleade.mets-file-prefix}}
==== {{var|pleade.mets-file-prefix}} ====
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. Ce paramètre va contenir le prefix commun aux fichierx mets.
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.mets-file-prefix}} || {{value|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.


Exemple, si les fichiers mets sont nommés: mets-20889889.xml, mets-786857567.xml, mets-907979797, ... on aura
Par exemple, si les fichiers METS sont nommés: ''mets-''20889889.xml, ''mets-''786857567.xml, ''mets-''907979797, ... on définira le préfix {{var|pleade.mets-file-prefix}}={{value|mets-}}
pleade.mets-file-prefix=mets-
|}


{{var|pleade.sdx-mets-repository}}
==== {{var|pleade.sdx-mets-repository}} ====
Indique le nom du datasource correspondant à la 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.
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.sdx-mets-repository}} || {{value|vide}} ||
* {{value|MYSQL:{{var|dbName}}}},
* {{value|POSTGRESQL:{{var|dbName}}}}
* {{value|ORACLE:{{var|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 {{var|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.
|}


==== {{var|pleade.mets-active-basket}} ====
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.mets-active-basket}} || {{value|true}} ||
* {{value|true}},
* {{value|false}}
||
Permet l'activation de la '''gestion du panier''' de notice pour le module METS.
|}


{{var|pleade.mets-active-basket}}
==== {{var|pleade.mets-active-pdf}} ====
Permet l'activation de la gestion du panier de notice pour le module mets.
{|class="wikitable centre"
Valeurs possibles: true ou false
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.mets-active-pdf}} || {{value|true}} ||
* {{value|true}},
* {{value|false}}
||
Permet l'activation de la '''génération au format PDF''' de notice pour le module mets.
|}


{{var|pleade.mets-active-pdf}}
==== {{var|pleade.viewer.mets-search-pan}} ====
Permet l'activation de la génération de notice au format PDF pour le module mets. Valeurs possibles: true ou false
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.viewer.mets-search-pan}} || {{value|true}} ||
* {{value|true}},
* {{value|false}}
||
Dans la visionneuse METS-ALTO, active l'affichage du panneau latéral de recherche METS.
|}


{{var|pleade.viewer.mets-search-pan}}
==== {{var|pleade.viewer.export-txt.enabled}} ====
Dans la visionneuse mets-alto, active l'affichage du panneau de recherche mets.
{|class="wikitable centre"
Valeurs possibles: true ou false.
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.viewer.export-txt.enabled}} || {{value|true}} ||
* {{value|true}},
* {{value|false}}
||
Dans la visionneuse METS alto, active le bouton d''''export au format « texte brute »''' de l'image actuelle.
|}


{{var|pleade.viewer.export-txt.enabled}}
==== {{var|pleade.viewer.mets.nav-folio.enabled}} ====
Dans la visionneuse mets alto, active le bouton d'export txt de l'image actuelle.
{|class="wikitable centre"
Valeurs possibles true ou false.
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.viewer.mets.nav-folio.enabled}} || {{value|true}} ||
* {{value|true}},
* {{value|false}}
||
Dans la visionneuse METS-ALTO, active la '''navigation par folio'''.
|}


{{var|pleade.viewer.mets.nav-folio.enabled}}
==== {{var|pleade.viewer.mets.nav-tdm.enabled}} ====
Dans la visionneuse mets-alto, active la navigation par foliotage.
{|class="wikitable centre"
Valeurs possibles true ou false.
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.viewer.mets.nav-tdm.enabled}} || {{value|true}} ||
* {{value|true}},
* {{value|false}}
||
Dans la visionneuse METS-ALTO, active la '''navigation par table des matières'''
{{important|La fonctionnalité est encore '''expérimentale'''}}


{{var|pleade.viewer.mets.nav-tdm.enabled}}
|}
Dans la visionneuse mets-alto, active la navigation par table des matières
Remarque: La fonctionnalité est encore expérimentale.


{{var|pleade.viewer.mets-search-pan.suggest.nb}}
==== {{var|pleade.viewer.mets-search-pan.suggest.nb}} ====
{|class="wikitable centre"
!  Paramètre !! Défaut !! Valeurs possible !! Description
|-
| {{var|pleade.viewer.mets-search-pan.suggest.nb}} || {{value|3}} || {{value|n}} (entier positif {{value|≥3}})  ||
{{todo|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.
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.


{{remarque|# 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.
{{remarque|
# 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.
# 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}}
# 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}}
|}


{{var|pleade.viewer.mets-search-pan.suggest.aim}}
==== {{var|pleade.viewer.mets-search-pan.suggest.aim}} ====
Indique le sens de recherche pour l'auto-complétion de la saisie. Trois valeurs sont possibles:
{|class="wikitable centre"
* begin : les mots trouvés sont ceux commencent par les caractères saisis. C'est le comportement par défaut.
!  Paramètre !! Défaut !! Valeurs possible !! Description
* 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
| {{var|pleade.viewer.mets-search-pan.suggest.aim}} || {{value|begin}} ||
* {{value|begin}},
* {{value|contain}},
* {{value|end}}.
||
{{todo|Cette fonction est en conflit avec l'utilisation d'un caractère joker tel que {{value|*}} (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 :
* {{value|begin}} : les mots trouvés sont ceux commencent par les caractères saisis. C'est le comportement par défaut.
* {{value|contain}} : les mots trouvés sont ceux contenant les caractères saisis.
* {{value|end}} : les mots trouvés sont ceux se terminant par les caractères saisies
|}


{{remarque|Lors du paramétrage du fichier pleade-mets.properties. Il faut faire particulièrement attention à ne pas inclure des caractères "invisble ". Les seuls caractères invisibles tolérés sont (<espace>, <tab>, <eol>) dans les commentaire. Cette remarque concerne notamment la saisie des valeurs des différents paramètres}}
=== 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 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.


== Paramètres de publication ==
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.
Les paramètres de publication permettent d'indiquer là façons dont les documents mets seront interprétés à la publication.
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.
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.


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.


 
==== Paramétrage des méta-données ====
=== Paramétrage des méta-données ===
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’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.
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.
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.


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.
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.


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.
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 champs "default" une expression XPATH correct vers la méta données auquel il font référence.
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.


Ligne 108 : Ligne 200 :
</syntaxhighlight>
</syntaxhighlight>


Ici, on considère que l'élément dc:format correspond dans le mets aux éléments suivant:
Ici, on considère que l'élément dc:format correspond dans le METS aux éléments suivant:
# {{path|/mets/dmdSec/mdWrap/@MIMETYPE}}
# {{path|/mets/dmdSec/mdWrap/@MIMETYPE}}
# {{path|/mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count}}
# {{path|/mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count}}
# {{path|/mets/amdSec/techMD/mdWrap/xmlData/*:root/*:resolution}}
# {{path|/mets/amdSec/techMD/mdWrap/xmlData/*:root/*:resolution}}


- 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.
- 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.
Exemple:
Exemple:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
Ligne 171 : Ligne 263 :
- La propriété "{{var|docUrl}}" est utilisé par le système. Il ne faut pas le modifier.
- La propriété "{{var|docUrl}}" est utilisé par le système. Il ne faut pas le modifier.


-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.
-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.


Exemple: <property name="mets-folio-type" default="logical;physical" />
Exemple: <property name="mets-folio-type" default="logical;physical" />
Dans cette exemple, on considére que les strucMpa de type "pysical" ou "logical" contiennent des informations de foliotage.
Dans cette exemple, on considére que les strucMpa de type "pysical" ou "logical" contiennent des informations de foliotage.


{{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}}
{{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}}




- 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.
- 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.
Exemple: <property name="mets-tdm-type" default="book;tdm" />
Exemple: <property name="mets-tdm-type" default="book;tdm" />




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


Les formulaires de recherche pour le module mets marche de la même manière que le formulaire du module eadeac.
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.
Voir la documentation d'exploitation de Pleade pour plus de détails.


== Graphisme ==
=== Graphisme ===


Le graphisme du module mets marche de la même manière que le graphisme de pleade et du module eadeac.
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.
Voir la documentation d'exploitation de Pleade pour plus de détails.




== Spécification client ==
=== Spécification client ===
{{notice|La '''[[Doc/Mets/Spécifications pour Pleade|spécification est à rédiger dans Doc/Mets/Spécifications pour Pleade]]''', pour le moment on suit le [[Media:Mets-bm-orleans.xml|modèle de document METS]] utilisé dans le projets [[:category:BM-Orléans|BM-Orléans]]}}
{{notice|La '''[[Doc/Mets/Spécifications pour Pleade|spécification est à rédiger dans Doc/Mets/Spécifications pour Pleade]]''', pour le moment on suit le [[Media:Mets-bm-orleans.xml|modèle de document METS]] utilisé dans le projets [[:category:BM-Orléans|BM-Orléans]]}}
{{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>[[http://www.nla.gov.au/content/workflow-process-overview|Use of METS and ALTO in the Australian Newspapers Digitisation Program (ANDP) at the National Library of Australia (NLA)]]</ref>}}
{{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>[[http://www.nla.gov.au/content/workflow-process-overview|Use of METS and ALTO in the Australian Newspapers Digitisation Program (ANDP) at the National Library of Australia (NLA)]]</ref>}}


=== Arborescence de production ===
==== 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.).
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|Pour le moment {{pleade}} ne gère que les fichiers liés qui le sont par des URLs relatives}}
Ligne 224 : Ligne 316 :
</syntaxhighlight>
</syntaxhighlight>


== Externalisation des Fichiers ALTO ==
=== Externalisation des Fichiers ALTO ===
On externalise les fichiers [[ALTO]] à l'aide de l'élément {{tag|fileGrp}}. On précise le type du groupe à l'aide de l'attribut {{attr|USE}} auquel on assigne la valeur {{value|ALTO}}.
On externalise les fichiers [[ALTO]] à l'aide de l'élément {{tag|fileGrp}}. On précise le type du groupe à l'aide de l'attribut {{attr|USE}} auquel on assigne la valeur {{value|ALTO}}.
{{notice|On préfère la valeur {{value|ALTO}} car la valeur {{value|OCR}} est trop générique et peut désigner des fichiers plein texte au format {{path|*.txt}}.}}
{{notice|On préfère la valeur {{value|ALTO}} car la valeur {{value|OCR}} est trop générique et peut désigner des fichiers plein texte au format {{path|*.txt}}.}}
Ligne 234 : Ligne 326 :
</syntaxhighlight>
</syntaxhighlight>


== Lier l'oeuvre complète dans un {{tag|structMap}} ==
=== Lier l'oeuvre complète dans un {{tag|structMap}} ===
La conversation [http://listserv.loc.gov/cgi-bin/wa?A2=ind1007&L=METS&P=R2030&1=METS&9=A&I=-3&K=1&X=1627754FA4340F6E31&Y=elopez%40ajlsm.com&d=no+match%3Bmatch%3Bmatches&n=METS&z=4 representing page images and entire works in METS] sur la liste de diffusion METS de la librairie du congrès propose la solution suivante :
La conversation [http://listserv.loc.gov/cgi-bin/wa?A2=ind1007&L=METS&P=R2030&1=METS&9=A&I=-3&K=1&X=1627754FA4340F6E31&Y=elopez%40ajlsm.com&d=no+match%3Bmatch%3Bmatches&n=METS&z=4 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 {{tag|div}} has an immediate child {{tag|fptr}} that point to the pdf for the issue of New Age as a whole.
  Note that the root {{tag|div}} has an immediate child {{tag|fptr}} that point to the pdf for the issue of New Age as a whole.
Ligne 272 : Ligne 364 :
</METS:structMap></syntaxhighlight>
</METS:structMap></syntaxhighlight>


== Attribut {{attr|USE}} et ses valeurs ==
=== Attribut {{attr|USE}} et ses valeurs ===
Dans les éléments {{tag|fileGrp}} l'attribut {{attr|USE}} nous permet de faire des utilisations différentes des groupes de fichiers selon la valeur de l'attribut<ref>[http://www.loc.gov/standards/mets/docs/mets.v1-9.html#fileGrp METS documentation: {{tag|fileGrp}}]</ref>. Cela autorise la présence de plusieurs groupes ayant le même attribut {{attr|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.
Dans les éléments {{tag|fileGrp}} l'attribut {{attr|USE}} nous permet de faire des utilisations différentes des groupes de fichiers selon la valeur de l'attribut<ref>[http://www.loc.gov/standards/mets/docs/mets.v1-9.html#fileGrp METS documentation: {{tag|fileGrp}}]</ref>. Cela autorise la présence de plusieurs groupes ayant le même attribut {{attr|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 {{attr|USE}} est donc nécessaire pour être compatible avec Pleade. Nous avons définit 3 valeurs possibles pour l'attribut {{attr|USE}} :
L'attribut {{attr|USE}} est donc nécessaire pour être compatible avec Pleade. Nous avons définit 3 valeurs possibles pour l'attribut {{attr|USE}} :
Ligne 280 : Ligne 372 :
Si vous le souhaitez vous pouvez renseigner un attribut {{attr|ID}} (unique) pour vos éléments {{tag|fileGrp}}, il ne sera pas utiliser pour le moment.
Si vous le souhaitez vous pouvez renseigner un attribut {{attr|ID}} (unique) pour vos éléments {{tag|fileGrp}}, il ne sera pas utiliser pour le moment.


== StructMap/{{attr|TYPE}} ==
=== StructMap/{{attr|TYPE}} ===
Nous utilisons l'attribut {{attr|TYPE}} de façon à distinguer les différents type d'organisation<ref>[http://www.loc.gov/standards/mets/docs/mets.v1-9.html#structMap  METS documentation: {{attr|TYPE}}]</ref> (intellectuelle vs. physique) des documents. À l'heure actuelle les valeurs on les sens suivants pour notre application :
Nous utilisons l'attribut {{attr|TYPE}} de façon à distinguer les différents type d'organisation<ref>[http://www.loc.gov/standards/mets/docs/mets.v1-9.html#structMap  METS documentation: {{attr|TYPE}}]</ref> (intellectuelle vs. physique) des documents. À l'heure actuelle les valeurs on les sens suivants pour notre application :
* {{value|logical}} : organisation intellectuelle ;
* {{value|logical}} : organisation intellectuelle ;
Ligne 287 : Ligne 379 :
Si l'attribut {{attr|TYPE}} n'est pas fourni nous considérons le {{tag|structMap}} comme étant de type {{value|physical}}.
Si l'attribut {{attr|TYPE}} n'est pas fourni nous considérons le {{tag|structMap}} comme étant de type {{value|physical}}.


== Références ==
=== Références ===
<references/>
<references/>


Version du 2 janvier 2013 à 11:15

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

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 correspondant 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.

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.

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.


Paramétrage des méta-données

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. 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.

Exemple, l'index correspondant à dc:title est dctitle, sans les « : » (deux points). On ajoute le préfix « dc » suivi du nom de l'élement sans le namespace.

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 champs "default" une expression XPATH correct vers la méta données auquel il font référence.

Exemple pour l'élément <dc:identifier>, le paramétrage correspondant est : 

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

Ici, dans les documents mets, on considère que l'élément /mets/@OBJID correspondant à l'élément Dublin Core <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 « ; » (point-virgule).

Exemple: 

	<property
		name="dcformat"
		type="dc"
		default="/mets/dmdSec/mdWrap/@MIMETYPE;/mets/dmdSec/mdWrap/xmlData/*:root/*:pages-count;/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:

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

- La propriété "empl-date-dc" indique les éléments Dublin core à considérer pour la gestion des recherches par date dans le module METS. Exemple: 

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

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.


- la propriété "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: 

	<fileGrp USE="JPEG">
		<file ID="jpeg-100779-10000001" MIMETYPE="image/jpeg" AMDID="doc-100779" DMDID="f-1007791">
			<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./jpeg-100779/10000001.jpg" LOCTYPE="URL"/>
		</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>


- la propriéte "filegrp-use-alto" fonctionne comme "filegrp-use-jpg". Il permet d'indiquer les élément de type ALTO.

Exemple: <property name="filegrp-use-alto" default="ALTO"/> indique ce type d'élément: 

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

- la propriéte "filegrp-use-tiff" fonctionne comme "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: 

	<fileGrp USE="TIFF">
		<file ID="tiff-100779-10000001" MIMETYPE="image/tiff" AMDID="doc-100779" DMDID="f-1007791">
			<FLocat xmlns:xlink="http://www.w3.org/TR/xlink" xlink:href="./tiff-100779/10000001.tif" 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>
	</fileGrp>

- La propriété "subset-list" indique le subset auquel appartient le document mets

- La propriété "docUrl" est utilisé par le système. Il ne faut pas le modifier.

-La propriété "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.

Exemple: <property name="mets-folio-type" default="logical;physical" /> Dans cette exemple, on considére que les strucMpa de type "pysical" ou "logical" contiennent des informations de foliotage.


Remarques : 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.


- La propriété "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. Exemple: <property name="mets-tdm-type" default="book;tdm" />


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=1387"