nakala-presenter-les donnees.md 6.19 KB
Newer Older
Nicolas Larrousse's avatar
Nicolas Larrousse committed
1
2
3
4
5
6
7
8
---
lang: fr
---

!!! Note  
    Document en cours de rédaction


9
10
11
12
# Présenter les données stockées dans NAKALA et partager les métadonnées

NAKALA a été créé dans le but de séparer les dispositifs pour le stockage des données de ceux utilisés pour leur éditorialisation. Les technologies utilisée pour la présentation ont des cycles d’obsolescence relativement rapide 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.

13
14
15
16
Un objet numérique déposé dans NAKALA est composé essentiellement de deux éléments : 
- les métadonnées descriptives  
- les fichiers associés 

17
[Objet Numérique](../../media/meta/nakala_objet_numerique.png)
18
19
20

Voici ce que cela donne vu de l'interface de NAKALA

21
[Objet Numérique dans l'interface](../../media/meta/nakala_objet_numerique_interface.png)
22

23
24
Tout objet numérique déposé dans NAKALA dispose d'un identifiant. Deux types d'identifiants sont employés, les DOI (Digital Object Identifiers) pour les nouvelles données et les Handles pour les données plus anciennes. 

25
Les DOIs dans NAKALA sont de la forme "10.34847/nkl.XXXXXXXXXXX"  
26
- Les URLs associées sont les suivantes :  
27
https://nakala.fr/[DOI] ou https://doi.org/[DOI]  
28
- Par exemple : 
29
[https://nakala.fr/10.34847/nkl.4b33r2h4 ](https://nakala.fr/10.34847/nkl.4b33r2h4) ou [https://doi.org/10.34847/nkl.4b33r2h4](https://doi.org/10.34847/nkl.4b33r2h4) 
30
31


32
Les Handles dans NAKALA sont de la forme  "11280/XXXXXXX" 
33
- Les URLs associées sont les suivantes :
34
https://nakala.fr/[handle] ou https://hdl.handle.net/[handle]  
35
- Par exemple : 
36
[https://nakala.fr/11280/111643de](https://nakala.fr/11280/111643de)  ou [https://hdl.handle.net/11280/111643de](https://hdl.handle.net/11280/111643de) 
37

Nicolas Larrousse's avatar
Nicolas Larrousse committed
38

39
A ces identifiants sont associés des URLs spécifiques qui permettent l'accès aux différentes composantes de l'objet numérique :
40

41
- URL pour les métadonnées descriptives associées 
42
https://api.nakala.fr/datas/[identifiant]
43
- URL pour l'accès à un des fichiers   
44
https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]
45
- URL pour accéder la visionneuse associée au fichier  
46
https://api.nakala.fr/embed/[identifiant]/[identifiant_fichier]
47
- URL d'accès à un fichier via le protocole IIIF 
48
49
https://api.nakala.fr/iiif/[identifiant]/[identifiant_fichier]

50

51
52
[URLs d'accès aux composants de l'objet numérique](../../media/meta/nakala_url_composants.png)

53

54
55
[URLs d'accès aux composants de l'objet numérique depuis l'interface](../../media/meta/nakala_url_composants_interface.png)

Nicolas Larrousse's avatar
Nicolas Larrousse committed
56

57
58


59
## Présenter les données stockées dans NAKALA
Nicolas Larrousse's avatar
Nicolas Larrousse committed
60

61

62
63
### Utilisation de code HTML

64
65
66
67
68
69
70
71
72
73
74
75
On utilise l’identifiant du fichier (URL de téléchargement sur la page d’accueil)https://api.nakala.fr/data/10.34847/nkl.4b33r2h4/e93c8f98abd8cf192e486408cfda3f6503cde84c

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>


76
77
78

### La visionneuse intégrée 

79
80
81
82
83
84
85
86
87
88
89
90
91
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
- Archive Zip
- Fichier de code (XML, HTML, JSON…)

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

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

92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

### Le protocole IIIF 

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)

Pour manipuler une image dans NAKALA, l’URL est constituée 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

Modification de la taille de l’image 
https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/200,200/0/default.jpg

Extraction d’une partie de l’image 
https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,450,300,300/max/0/default.jpg

Rotation de l’image 
https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/max/45/default.jpg 




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

### A partir de la page d’accueil
126
#### Citation
127
128
129

[Citation de l'interface](../../media/meta/nakala_citation_interface.png)

130
#### Partage « visuel »
131
132
133

[Partage visuel depuisl'interface](../../media/meta/nakala_partage_visuel_interface.png)

134
#### Métadonnées embarquées
135

136
137
138
[Métadonnées embarquées](../../media/meta/nakala_metadonnees_embarquees.png)


139
### A partir de points d’accès standardisés  
140

141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
#### API de NAKALA
Accéder aux métadonnées par l’API de NAKALA
https://api.nakala.fr/datas//[identifiant]

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

Format de sortie XML ou Json récupérable de manière automatisée 

#### Protocole OAI-PMH

Accéder aux métadonnées par le protocole OAI-PMH
https://api.nakala.fr/oai2?[paramètres du protocole OAI-PMH]

Accéder aux métadonnées par le protocole OAI-PMH
https://api.nakala.fr/oai2?[paramètres du protocole OAI-PMH]

Les « SETs » OAI sont associés aux collections de NAKALA

Exemple avec la donnée utilisée précédemment https://api.nakala.fr/oai2?verb=GetRecord&identifier=oai:nakala.fr:hdl_11280_111643de&metadataPrefix=oai_dc  
160

161

162
163
164
### Les consommateurs de métadonnées 


165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
#### ISIDORE 


#### Gallica



#### Data Cite 


#### OpenAire 


#### Google Data Search 



182
183
184



185

Nicolas Larrousse's avatar
Nicolas Larrousse committed
186