Note

Document en cours de rédaction

Présenter les données stockées dans NAKALA et partager les métadonnées

NAKALA permet de séparer les dispositifs de stockage des données de ceux utilisés pour leur éditorialisation. En effet, les technologies utilisées pour l’éditorialisation (ou la présentation) ont des cycles d’obsolescence relativement rapides et il existe un risque important « d’enterrer » les données dans un dispositif. Un autre but est d’éviter la duplication des données dans plusieurs dispositifs .

Composition d’une donnée dans NAKALA

Une donnée déposée dans NAKALA est composée essentiellement de deux éléments :

  • les métadonnées descriptives
  • un ou plusieurs fichiers associés

Donnée dans NAKALA

Composition d’une donnée dans NAKALA

Donnée dans NAKALA vue depuis l'interface

Présentation de ces éléments dans l’interface web de NAKALA

Identifiants appliqués aux données

Toute donnée déposée dans NAKALA dispose d’un identifiant : - Les données déposées dans Nakala avant 2021 sont associées à des Handles. Les Handles dans NAKALA sont de la forme “11280/XXXXXXX”. Les URLs associées sont les suivantes : https://nakala.fr/[handle] ou https://hdl.handle.net/[handle].

Par exemple :
https://nakala.fr/11280/111643de ou https://hdl.handle.net/11280/111643de

  • Les données déposées depuis 2021 sont associées à des DOI (Digital Object Identifiers). Les DOIs dans NAKALA sont de la forme “10.34847/nkl.XXXXXXXXXXX”. Les URLs associées sont les suivantes :
    https://nakala.fr/[DOI] ou https://doi.org/[DOI]

Par exemple :
https://nakala.fr/10.34847/nkl.4b33r2h4 ou https://doi.org/10.34847/nkl.4b33r2h4

A ces identifiants sont associées des URLs spécifiques qui permettent l’accès aux différentes composantes de la donnée :

  • URL pour les métadonnées descriptives associées
    https://api.nakala.fr/datas/[identifiant]
  • URL pour l’accès à un des fichiers de la donnée
    https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]
  • URL pour accéder à la visionneuse associée au fichier
    https://api.nakala.fr/embed/[identifiant]/[identifiant_fichier]
  • URL d’accès à un fichier via le protocole IIIF
    https://api.nakala.fr/iiif/[identifiant]/[identifiant_fichier]
  • URL courte pour l’accès au premier fichier de la donnée https://nakala.fr/data/[identifiant]

URLs d'accès aux composantes d'une donnée

URLs d’accès aux composantes d’une donnée

Ces URLs associées à une donnée sont accessibles depuis l’interface de NAKALA :

URLs d'accès aux composantes d'une donnée depuis l'interface

URLs d’accès aux composantes d’une donnée depuis l’interface web de NAKALA

Présenter les données stockées dans NAKALA

Insertion de contenu dans du code HTML

Il est possible d’insérer des contenus issus de NAKALA dans une page web de tout type en entrant dans le code l’appel du fichier souhaité. Le langage HTML5 propose des balises adaptées à différents types de fichiers (e.g. images, vidéos, audio, etc.).

On utilise alors l’identifiant du fichier (URL de téléchargement sur la page d’accueil) : https://api.nakala.fr/data/10.34847/nkl.4b33r2h4/e93c8f98abd8cf192e486408cfda3f6503cde84c

Voici quelques exemples d’intégration de données déposées dans NAKALA dans une page HTML.

  • Image
    <img src="https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]" alt="image de Nakala par exemple"/>
  • Vidéo
    <video src="https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]" autoplay="true" preload="auto" controls></video>
  • Audio
    <audio src="https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]" autoplay="true" controls></audio>

Affichage du contenu avec la visionneuse intégrée de Nakala

Il est possible d’insérer dans ce contenu la visionneuse de Nakala.

NAKALA propose des visionneuses pour différents types de fichiers :
- Fichier image : OpenSeadragon
- Fichier CSV : DataTables
- Fichier audio ou vidéo : Plyr
- Fichier PDF : PDF.js
- Fichier Markdown
- Archives : .zip, .rar, .phar, .tar, .tgz, .gz, .bz2 - Fichier de code : XML, HTML, JSON, etc.

On utilise également l’identifiant du fichier (l’URL d’intégration est présente sur la page d’accueil) : https://api.nakala.fr/embed/10.34847/nkl.4b33r2h4/e93c8f98abd8cf192e486408cfda3f6503cde84c

L’intégration de la visionneuse se fait en utilisant la balise “<iframe>”

    <iframe src="https://api.nakala.fr/embed/[identifiant]/[identifiant_fichier]" width="hauteur" height="largeur"></iframe>

API Image IIIF

Implémentation du protocole IIIF dans Nakala

NAKALA intègre le protocole IIIF ((International Image Interoperability Framework).

IIIF propose des standards d’interopérabilité, en particulier pour le traitement et la manipulation d’images. Il est possible par exemple de : - Sélectionner une partie de l’image (region) - Modifier la taille de l’image (taille) - Faire pivoter l’image (rotation) - Choisir la qualité de l’image (qualite) - Choisir le format (format)

Les extensions de fichiers images supportées par l’API Image IIIF de Nakala sont :

  • tif
  • tiff
  • jpg
  • jpeg
  • jp2
  • png
  • pdf
  • geojp2

Construction des URL pour utiliser IIIF Image

Ainsi pour manipuler une image dans NAKALA, l’URL se construit de la manière suivante : https://api.nakala.fr/iiif/[identifiant]/[identifiant_fichier]/{region}/{taille}/{rotation}/{qualité}.{format}.

Voici quelques exemples avec l’image https://nakala.fr/11280/111643de .

Combinaison de plusieurs paramètres IIIF

Combinaison de plusieurs paramètres IIIF dans un appel d’image déposée dans Nakala

Partager les métadonnées associées aux données

Les métadonnées associées à un dépôt dans NAKALA sont accesssibles de différentes manières :

A partir de la page de présentation d’une donnée :
- Citation
- Partage « visuel »
- Métadonnées embarquées dans la page de présentation

A partir de points d’accès utilisant des protocoles standardisés :
- l’API de NAKALA
- Le protocole OAI-PMH
- Le Triple Store

A partir de la page de présentation

Citation

A partir de l’interface, il est possible de récupérer une citation sous forme normalisée.

Citation depuis l'interface

Partage « visuel »

Les métadonnées complètes sont accessibles visuellement via l’interface.

Partage visuel depuisl'interface

Métadonnées “embarquées” dans la page de présentation

Des métadonnées standardisées, destinées à être consommées par des machines, sont accessibles depuis la page de présentation d’une donnée.

Métadonnées embarquées

Ces métadonnées peuvent, par exemple, être importées par le logiciel Zotero

Métadonnées embarquées vues dans Zotero

A partir de points d’accès standardisés

API de NAKALA

Il est possible d’accéder aux métadonnées descriptives d’une donnée par l’API de NAKALA
https://api.nakala.fr/datas/[identifiant]

Par exemple :

https://api.nakala.fr/datas/11280/111643de

Le format de sortie est en XML ou en Json récupérable de manière automatisée.

Métadonnées récupérées via l'API

Plus d’informations sur l’utilisation de l’API sont disponibles ici

Protocole OAI-PMH

NAKALA propose un point d’accès utilisant le protocole OAI-PMH

Trois format de métadonnées sont disponibles :
- Dublin Core
- DCTerms
- DataCite

Les « SETs » (ensembles) OAI sont associés aux collections publiques de NAKALA. Chaque collection publique consitue donc un SET dans l’entrepôt OAI de NAKALA.

Le point d’accès aux métadonnées par le protocole OAI-PMH est de cette forme : https://api.nakala.fr/oai2?[paramètres du protocole OAI-PMH]

Voici un exemple avec la donnée utilisée plus haut :
https://api.nakala.fr/oai2?verb=GetRecord&identifier=oai:nakala.fr:hdl_11280_111643de&metadataPrefix=oai_dc

Métadonnées récupérées via le protocole OAI-PMH

Métadonnées récupérées via le protocole OAI-PMH

Triple Store

Note

Le Triple Store est en cours de mise à jour

Les consommateurs de métadonnées

ISIDORE

Les collections publiques de NAKALA peuvent être “moissonnées” par ISIDORE. Ce moissonnage est facilité par la publication des collections dans l’entrepôt OAI. Pour signaler une collection de NAKALA dans ISIDORE, il faut en faire la demande au support à isidore-sources@huma-num.fr. La documentation fournit des informations plus précises.

Métadonnées vues par ISIDORE

Affichage de métadonnées issues de NAKALA dans ISIDORE : https://isidore.science/document/11280/111643de

Gallica

Les collections de NAKALA peuvent être “moissonnées” par GALLICA.

Le moissonnage n’est pas automatique, il est nécessaire d’en faire la demande.

Métadonnées vues par GALLICA

Affichage de métadonnées issues de NAKALA dans Gallica

Data Cite

Les données de NAKALA possédant un identifiant DOI sont référencées par DataCite.

Le moissonnage est automatique, au moment de la publication de la donnée (i.e de l’enregistrement de l’identifiant DOI).

Métadonnées vues par DataCite

OpenAire

Les collections de NAKALA peuvent être “moissonnées” par OpenAire.

Le moissonnage n’est pas automatique, il est nécessaire d’en faire la demande.

Note

Le lien avec OpenAire est en cours de mise à jour

Les collections de NAKALA peuvent être “moissonnées” par Google Data Search.

Le moissonnage n’est pas automatique, il est nécessaire d’en faire la demande.

Google Data Search effectue un lien lorsque cela est possible entre les données et les articles présents dans Google Scholar

Métadonnées vues par Google Data Search