5 juillet 2023, Strasbourg

Trucs & Astuces

Lors de l’atelier « Préparer et enrichir ses données avec TACT » que nous avons animé à l’école d’été DISTAM mercredi dernier, nous avons parlé IIIF. Alors voici une belle occasion de parler IIIF & TACT ! Si vous n’êtes pas intéressés par TACT, mais que IIIF est un mystère pour vous, n’hésitez pas à lire quand même ce billet : je crois que j’ai réussi à expliquer les choses simplement 🤞(sautez directement aux exemples signalés par 👋).

Depuis mars 2021, TACT permet d’interagir avec des serveurs IIIF. En réalité, nous avons fait simple : il s’agit simplement de bénéficier de l’API Image qui permet d’interroger un serveur d’images utilisant le protocole IIIF grâce à l’URL.👋 ^{Pour des exemples clairs et concrets, je vous propose le transparent proposé par Loïc Jeanson, Pierre Willaime et Christophe Eckes lors de la même école d’été DISTAM : Presentation Bourgoin, slide API-Images.}

Pourquoi TACT utilise IIIF ?

La fonctionnalité initiale est celle d’offrir la possibilité d’externaliser les médias :

• plutôt que de déposer les médias sur TACT, si ceux-ci sont déjà en ligne, il est possible de configurer une url externe. Ça se passe dans « Administrer > Gestion des serveurs d’images » puis « Administrer > Média > Ajout de médias externes »
• en bonus, si les images sont sur un serveur IIIF, deux options permettent de spécifier les options d’url pour l’affichage des vignettes et pour des images en haute qualité

Comment faire ?

1	Configurer une source “serveur IIIF” pour son projet à partir de l’administration de son projet, bloc « Gestion des serveurs d’images » en indiquant l’url de base et d’éventuels (conseillés) suffixes pour les versions haute et basse qualité Conseil pour renseigner facilement les champs : munissez-vous de l’URL IIIF d’une des images que vous souhaitez annoter. Par exemple, https://gallica.bnf.fr/ark:/12148/btv1b52508729m/f75/full/full/0/lowres	puis TACT > Administrer son projet > Gestion des serveurs d’images puis
2	Préparer la liste des sources des images : un ensemble de fichiers (1 par media) compressé en .zip contenant l’identifiant de la donnée
3	Ajouter des médias à partir de sources externes  à partir de l’administration de son projet, bloc « Médias » en déposant son fichiers zip et en l’associant au serveur d’image défini précédemment	puis TACT > Administrer son projet > Médias puis

Voici des détails et exemples pour ces 3 étapes (y compris la méthode pour faire référence à une zone d’image plutôt qu’à une image complète, à une taille d’image spécifique, etc.)

👋 Exemple 1 : Images (entières) issues de Gallica

• Description de l’API Image de Gallica : https://api.bnf.fr/fr/api-iiif-de-recuperation-des-images-de-gallica#scroll-nav__4__1
• URL IIIF d’une image, qui me sert de base pour compléter les informations sur TACT : https://gallica.bnf.fr/iiif/ark:/12148/btv1b105206468/f229/full/300,/0/default.jpg
• [étape 1] Sur TACT, définition du serveur d’image :

Ici, dans l’URL du serveur, on indique le chemin complet vers la collection, sans référence à une image spécifique. Puis on sélectionne les suffixes pour l’image large, qui s’affichera dans la vue de transcription, et pour la miniature, utilisée sur les pages montrant des galeries d’image. Pour la miniature, je choisi de réduire à 300px de largeur.

• [étape 2] Exemple d’un fichier XML :

Nom du fichier : feuillet_029.xml

Le nom de fichier sert à ordonner les médias dans les vues « galerie » : indiquez plutôt 001 que 1 si vous voulez un ordre cohérent car le tri est alphabétique, cela vous évitera d’avoir la désagréable suite : 1, 11, 12, 13… 2…

Contenu minimal : <identifier>f29</identifier>

Il peut y avoir plus, si par exemple vous disposez déjà de fichiers près, issus ou destinés à un autre usage, mais sachez que TACT ne fait que chercher la première balise <identifier/> et en récupère le contenu, tout le reste est simplement ignoré.

• [étape 3] déposer le .zip contenant tous les fichiers XML qui peuvent être selon votre choix rangés dans des dossiers et sous-dossiers, ou pas

➡ Les images affichées seront celles-ci :

• pour la miniature : https://gallica.bnf.fr/iiif/ark:/12148/btv1b105206468/f29/full/300,/0/native.jpg
• pour l’image en grande taille : https://gallica.bnf.fr/iiif/ark:/12148/btv1b105206468/f29/full/full/0/native.jpg

👋 Exemple 2 : Zones d’images issues de Nakala

• Description de l’API Image de Nakala : https://api.nakala.fr/doc
• URL IIIF d’une image, qui me sert de base pour compléter les informations sur TACT : https://gallica.bnf.fr/iiif/ark:/12148/btv1b105206468/f229/full/300,/0/native.jpg
• Sur TACT, définition du serveur d’image (étape 1) :

Ici, dans l’URL du serveur, on indique le chemin complet vers la collection, sans référence à une image spécifique. Puis on sélectionne les suffixes SANS la partie de l’URL dédiée à la zone de l’image ; dans mon exemple, pour la miniature, on indique donc /300,/0/native.jpg au lieu de /full/00,/0/native.jpg

• [étape 2] Exemple d’un fichier XML :

Nom du fichier : feuillet_029.xml

Le nom de fichier sert à ordonner les médias dans les vues « galerie » : indiquez plutôt 001 que 1 si vous voulez un ordre cohérent car le tri est alphabétique, cela vous évitera d’avoir la désagréable suite : 1, 11, 12, 13… 2…

Contenu minimal adapté pour ne récupérer qu’un zone de l’image : <identifier>f29/400,3000,2600,850</identifier>

L’expression de la zone suis bien sûr le standard IIIF (voir ici) : x,y,w,h avec x,Y les coordonnées (horizontale, verticale) du point en haut à gauche de la zone et w,h les dimensions largeur,hauteur de la zone.

• [étape 3] déposer le .zip contenant tous les fichiers XML qui peuvent être selon votre choix rangés dans des dossiers et sous-dossiers, ou pas

➡ Les images affichées seront celles-ci :

• pour la miniature : https://gallica.bnf.fr/iiif/ark:/12148/btv1b105206468/f29/400,3000,2600,850/300,/0/native.jpg
• pour l’image en grande taille : https://gallica.bnf.fr/iiif/ark:/12148/btv1b105206468/f29/400,3000,2600,850/full/0/native.jpg

Et voilà le tour est joué 🙂 À l’instar de IIIF, c’est simple et efficace ! ^{À condition de savoir comment l’URL d’interrogation IIIF fonctionne, je vous l’accorde 😉}