Liens vers des documents numériques⚓

Bonnes pratiques pour Objet archivistique numérique : <dao> et <daogrp><daoloc>
Spécificité Calames

Bonnes pratiques pour Objet archivistique numérique : <dao> et <daogrp><daoloc>⚓

Bonnes pratiques pour Objet archivistique numérique <dao>, Groupe d'objets archivistiques numériques <daogrp>Emplacement d'objet archivistique numérique <daoloc> et Description d'objet archivistique numérique <daodesc>,

Conseil : Selon les Bonnes pratiques⚓

<dao> doit être utilisé en cas de lien unique et <daogpr> avec autant de <daoloc> que de liens en cas de liens multiples pour une même unité documentaire.
Ces liens vers des versions numériques concernent autant les documents manuscrits ou archivistiques numérisés que les documents nativement numériques.
Dans le cas d'une reproduction numérique intégrale, <dao> ou <daogrp> doit être complété par un <altformavail>

Spécificité Calames⚓

Position⚓

Ces éléments doivent être positionnés comme derniers enfants du composant <c> ou du <archdesc> auquel ils sont associés : conformément aux Bonnes pratiques, ils ne doivent PAS être des sous-éléments de <did>

Attention : Affichage dans l'interface professionnelle⚓

<dao> et <daogrp> n'ont pas de contenu textuel et le plus souvent pas de <daodesc> : les informations sont exclusivement dans les attributs, visibles dans la colonne de droite ou dans l'infobulle :

Dans l'interface publique :⚓

Les consignes de saisie dépendent du choix d'affichage voulu dans l'interface publique

Affichage du(es) lien(s) dans le corps de la description (partie centrale)⚓

Possible pour un seul lien (<dao>) ou plusieurs liens (<daogrp><daoloc>).
Le rebond se fait soit sur le texte saisi dans l'attribut TITLE du <dao> ou <daoloc>, soit, si TITLE est laissé vide, sur le texte par défaut Disponible en ligne.

Permet de compléter le(s) rebond(s) par un texte descriptif ou de contextualisation en <daodesc><p> (si TITLE ne suffit pas à exprimer ces informations).

*Dans ces exemples*
Un `<dao>` avec une valeur de `TITLE` «Numérisation disponible en ligne dans l'Argonnaute»	Trois `<daoloc>` avec chacun un attribut `TITLE` « Lavoisier » pour le premier, etc.
Un `<dao>` avec - une valeur de `TITLE` « Accessible en ligne sur Minerv@ » - un `<daodesc><p>` (« document numérisé dans le cadre... » qui lui-même contient un `<extref>` (rebond vers la page du projet « Inventaire Condorcet ))	Deux`<daoloc>` -un `TITLE`propre à chaque `<daoloc>` qui permet de les différentier : « Première partie », « Deuxième partie » - sans `daodesc>`

En cas de lien unique⚓

Donc en <dao>

Exemple : Exemple : <dao> avec seulement l'attribut HREF⚓

<c>   
   <did>     
      <unitid type="division">Dossier 1</unitid>     
      <unittitle>Lettres sur l'inoculation de la petite vérole</unittitle>   
   </did> 
   <dao href="http://www.biusante.parisdescartes.fr/histmed/medi ca/cote?ms02276x01"/> 
</c> 

<c>   
   <did>     
      <unitid type="division">Dossier 1</unitid>     
      <unittitle>Lettres sur l'inoculation de la petite vérole</unittitle>   
   </did> 
   <dao href="http://www.biusante.parisdescartes.fr/histmed/medi ca/cote?ms02276x01"/> 
</c>

Le texte cliquable dans l'interface publique est le texte par défaut :

Exemple : Exemple : <dao> avec les attributs HREF et TITLE⚓

<dao href="https://archive.org/details/ENS01_Ms0125" title="Manuscrit numérisé"></dao> 

<dao href="https://archive.org/details/ENS01_Ms0125" title="Manuscrit numérisé"></dao>

Le texte cliquable est le texte saisi dans l'attribut TITLE :

Plusieurs liens vers des versions numériques : ⚓

Impose un <daogrp> avec au moins deux <daoloc>, chacun avec ROLE="rebond".
Privilégier l'attribut TITLE pour expliciter la spécificité de chaque lien à <daodesc> et ainsi éviter la répétition de l'affichage par défaut « Disponible en ligne ».

Exemple :

<daogrp> 
   <daoloc href="http://www.cataloguemazarine.fr/images/Ms0968-0975/001-vue2.jpg" title="Vue d'ensemble du fol. 1" role="rebond"/> 
   <daoloc href="http://www.cataloguemazarine.fr/images/Ms0968-0975/001-vue4.jpg" title="Miniature représentant la fin du monde" role="rebond"/>
</daogrp>

<daogrp> 
   <daoloc href="http://www.cataloguemazarine.fr/images/Ms0968-0975/001-vue2.jpg" title="Vue d'ensemble du fol. 1" role="rebond"/> 
   <daoloc href="http://www.cataloguemazarine.fr/images/Ms0968-0975/001-vue4.jpg" title="Miniature représentant la fin du monde" role="rebond"/>
</daogrp>

L'usage de Description d'objet archivistique numérique <daodesc><p>⚓

<daodesc> est autorisé dans <dao>, <daogrp> ou <daoloc> ; dans tous les cas, son contenu textuel s'affiche dans l'interrface publique de Calames avant le texte cliquable
Dans <daogrp>,<daodesc><p> doit être inséré avant les <daoloc> ;
Privilégier systématiquement l'attribut TITLE à <daodesc>

Remarque : Cas particulier des identifiants des versions numériques dans les bibliothèques numériques⚓

Afin de faciliter les mises à jour des url par lot, notamment quand la bibliothèque numérique ne peut enregistrer l'identifiant Calames, l'Abes utilise un <daodesc audience="internal"> qui, exceptionnellement, ne s'affiche pas dans l'interface publique, pour enregistrer l'identifiant de la description de la version numérique dans la bibliothèque numérique.

<daodesc audience="internal"><p>Identifiant [Nom bibliothèque numérique] <num type="bibliothèque numérique">xxxx</num></p></daodesc>

<daodesc audience="internal"><p>Identifiant [Nom bibliothèque numérique] <num type="bibliothèque numérique">xxxx</num></p></daodesc>

Affichage du lien sous forme de vignette cliquable dans la boîte à outils (colonne de droite)⚓

Impose de disposer d'autant d'images vignettes que de cibles de liens vers les documents numériques liés ;
Cette(ces) image(s) doi(ven)t être durablement accessible(s) librement en ligne via un URL.
Doit se faire obligatoirement dans un <daogrp> même pour une seule version numérique car il faut au moins un <daoloc> pour la cible et un <daoloc> pour la vignette.
Incompatible avec l'affichage d'un complément textuel descriptif ou de contextualisation.

Dans ces 2 exemples, il y a un <daogrp><daoloc type="vignette" href="[URL image]"><daoloc type="rebond" href="[URL version numérique du document]"></daogrp>: la vignette s'affiche à droite et rien n'apparait dans la partie centrale

L'attribut ROLE obligatoire⚓

Impose un <daogrp> avec au moins deux <daoloc> dans cet ordre :

un <daoloc role="vignette"> qui contient l'url de la vignette affiché dans l'interface publique de Calames, support du clic dans son attribut HREF,
un <daoloc role="rebond"> qui contient l'url de la version numérique cible dans son attribut HREF.

Attention :

Au sein de <daogrp>, les <daoloc> doivent être dans le bon ordre : vignette(s), puis la page-cible. Le <daogrp> doit donc se terminer par un <daoloc role="rebond">.

Remarque :

Le seul usage pertinent de <daodesc><p> est le <daodesc audience="internal"> pour les identifiants de bibliothèque numérique dans le cadre de traitement par lot. (cf. Remarque ci-dessus)

La fonction de l''attribut TITLE⚓

L'attribut TITLE du <daoloc role="vignette"> s'affiche comme légende sous l'imagette.
L'attribut TITLE du <daoloc role="rebond"> s'affiche dans l'infobulle quand la souris reste sur la vignette.

Exemple :

<daogrp> 
   <daoloc role="vignette" href="http://www.biusante.parisde scartes.fr/images/livres/ms02276x 01/0001.jpg" title="Document consultable sur Medic@"></daoloc> 
   <daoloc role="rebond" href="http://www.biusante.parisde scartes.fr/histmed/medica/cote?ms 02276x01" title="Accéder au document numérisé"></daoloc> 
</daogrp>

<daogrp> 
   <daoloc role="vignette" href="http://www.biusante.parisde scartes.fr/images/livres/ms02276x 01/0001.jpg" title="Document consultable sur Medic@"></daoloc> 
   <daoloc role="rebond" href="http://www.biusante.parisde scartes.fr/histmed/medica/cote?ms 02276x01" title="Accéder au document numérisé"></daoloc> 
</daogrp>

Cas particulier des liens vers le manifeste IIIF⚓

Afin de permettre aux établissements qui le souhaitent de donner accès à leurs manifestes IIIF, Calames introduit une 3e valeur possible à l'attribut ROLE de <daoloc>.

Attention : Limite du service⚓

les url vers des fichiers de manifestes IIIF ne sont pas compatibles avec le fonctionnement des vignettes.

Pour un affichage central (sans vignette)⚓

Faire un <daogrp> puisqu'il y a au moins 2 url : celui de la version numérique de l'unité documentaire décrite et celui du manifeste IIIF
le <daoloc> propre au manifeste doit avoir le ROLE "manifest_iiif" et un TITLE commencé par "Manifest IIIF" éventuellement complété du nom de la bibliothèque numérique s'il y a risque de confusion pour le lecteur

<daogrp>
   <daoloc role="manifest_iiif" title="Manifest IIIF" href="https://genovefa.bsg.univ-paris3.fr/iiif/2/41295/manifest?manifest"/>
   <daoloc role="rebond" title="Numérisation disponible en ligne dans Genova" href="https://genovefa.bsg.univ-paris3.fr/s/genovefa/item/41295"/>
</daogrp>

<daogrp>
   <daoloc role="manifest_iiif" title="Manifest IIIF" href="https://genovefa.bsg.univ-paris3.fr/iiif/2/41295/manifest?manifest"/>
   <daoloc role="rebond" title="Numérisation disponible en ligne dans Genova" href="https://genovefa.bsg.univ-paris3.fr/s/genovefa/item/41295"/>
</daogrp>

Remarque : Mise à jour en masse⚓

L'Abes dispose d'un service de créations ou mises à jour en masse pour les établissements dont le signalement des reproductions numériques implique des modifications sur une grande quantité de composants <c>.