nakala-presenter-les donnees.md 10.8 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
47
https://api.nakala.fr/embed/[identifiant]/[identifiant_fichier]  
- 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
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

66
Le langage HTML5 propose des balises adaptées à différents types de fichiers (e.g. images, vidéos, audio etc.)
67
Voici quelques exemples d'intégration de données déposées dans NAKALA dans une page HTML. 
68

69
Image 
70

71
```
72
    <img src="https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]" alt="image de Nakala par exemple"/>
73
```
74
75

Vidéo 
76

77
```
78
    <video src="https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]" autoplay="true" preload="auto" controls></video>
79
```
80
81

Audio 
82

83
```
84
    <audio src="https://api.nakala.fr/data/[identifiant]/[identifiant_fichier]" autoplay="true" controls></audio>
85
```
86

87
88
89

### La visionneuse intégrée 

90
91
92
93
94
95
96
97
98
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…)

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

102
L'intégration de la visionneuse se fait en utilisant la balise "<iframe\>"  
103

104
```
105
    <iframe src="https://api.nakala.fr/embed/[identifiant]/[identifiant_fichier]" width="hauteur" height="largeur"></iframe>
106
```
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

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

123
124
Voici quelques exemples avec l’image  

125
[https://nakala.fr/11280/111643de](https://nakala.fr/11280/111643de)
126

127
128
Modification de la taille de l’image  (paramètre {taille}) 

129
[https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/200,200/0/default.jpg](https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/200,200/0/default.jpg)
130

131
132
Extraction d’une partie de l’image  (paramètre {région})  

133
[https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,450,300,300/max/0/default.jpg](https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,450,300,300/max/0/default.jpg)
134

135
136
Rotation de l’image (paramètre {rotation})  

137
[https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/max/45/default.jpg](https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,450,300,300/max/0/default.jpg)
138

139
Combinaison d’extraction, de rotation et de redimensionnement de l’image (paramètres [région], {taille} et {rotation})  
140
141
[https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,650,400,300/300,300/45/default.jpg]
(https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,650,400,300/300,300/45/default.jpg)
142
143
144
145
146



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

147
148
149

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

150
151
152
153
A partir de la page d’accueil d'une donnée :  
- Citation  
- Partage « visuel »  
- Métadonnées embarquées  dans la page d'accueil 
154

155
156
157
158
A partir de points d’accès utilisant des protocoles standardisés :  
- l'API de NAKALA 
- Le protocole OAI-PMH  
- Le Triple Store  
159
160
161
162
163
164

Organisation d’une donnée (objet numérique) dans NAKALA
[Objet Numérique](../../media/meta/nakala_objet_numerique_s.png)



165
### A partir de la page d’accueil
166

167
#### Citation
168

169
170
A partir de l'interface, il est possible de récupérer une citation sous forme normalisée  

171
[Citation depuis l'interface](../../media/meta/nakala_citation_interface.png)
172

173
#### Partage « visuel »
174

175
176
Les métadonnées complètes sont accessibles visuellement via l'interface

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

179
#### Métadonnées "embarquées" dans la page d'accueil  
180

181
Des métadonnées standardisées, destinées à être consommées par des machines, sont accessibles depuis la page d'accueil d'une donnée. 
182

183
184
[Métadonnées embarquées](../../media/meta/nakala_metadonnees_embarquees.png)

185
186
187
188
Ces métadonnées peuvent par exemple être importées par le logiciel [Zotero](https://www.zotero.org/) 

[Métadonnées embarquées vues dans Zotero](../../media/meta/nakala_metadonnees_embarquees_zotero.png)

189

190
### A partir de points d’accès standardisés  
191

192
#### API de NAKALA
193
194
195

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

197
Par exemple  
198
199

[https://api.nakala.fr/datas/11280/111643de](https://api.nakala.fr/datas/11280/111643de  )   
200

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

203
204
[Métadonnées récupérées via l'API](../../media/meta/nakala_metadonnees_api.png)

205
Plus d'informations sur l'utilisation de l'API sont disponibles [ici](https://api.nakala.fr/doc) 
206

207
208
#### Protocole OAI-PMH

209
NAKALA propose un point d'accès utilisant le protocole [OAI-PMH](https://fr.wikipedia.org/wiki/Open_Archives_Initiative_Protocol_for_Metadata_Harvesting) 
210

211
Trois format de métadonnées sont disponibles :
212
213
214
- Dublin Core  
- DCTerms  
- DataCite    
215

216
Les « SETs » (ensembles) OAI sont associés aux collections de NAKALA
217

218
219
220
221
222
223
224
225
226
227
228
229
230
231
232

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](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](../../media/meta/nakala_metadonnees_oai.png)

#### Triple Store

!!! Note  
    Le Triple Store est en cours de mise à jour

233

234

235
236
237
### Les consommateurs de métadonnées 


238
239
#### ISIDORE 

240
241
242
243
244
245
246
247
248
249
250
Les collections de NAKALA peuvent être "moissonnées" par [ISIDORE](https://isidore.science/) 

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


[Métadonnées vues par ISIDORE](../../media/meta/nakala_metadonnees_isidore.png)

Voici un exemple :  
[https://isidore.science/document/11280/111643de](https://isidore.science/document/11280/111643de
)

251
252
253

#### Gallica

254
255
256
Les collections de NAKALA peuvent être "moissonnées" par [GALLICA](https://gallica.bnf.fr) 

Le moissonnage n'est pas automatique, il est nécessaire d'en faire la demande 
257
258


259
260
[Métadonnées vues par GALLICA](../../media/meta/nakala_metadonnees_gallica.png)

261
262
#### Data Cite 

263
264
265
266
267
268
269
Les collections de NAKALA peuvent être "moissonnées" par [DataCite](https://datacite.org/) 

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](../../media/meta/nakala_metadonnees_datacite.png)

270
271
272

#### OpenAire 

273
274
275
276
277
278
279
280
281
Les collections de NAKALA peuvent être "moissonnées" par [OpenAire](https://www.openaire.eu/) 

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


282
283
284

#### Google Data Search 

285
286
287
288
289
290
291
292
Les collections de NAKALA peuvent être "moissonnées" par [Google Data Search](https://datasetsearch.research.google.com/)

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

Google Data Search cherche à relier les données à des articles dans [Google Scholar](https://scholar.google.com/)


[Métadonnées vues par Google Data Search](../../media/meta/nakala_metadonnees_googledatasearch.png)
293
294


295
296
297



298

Nicolas Larrousse's avatar
Nicolas Larrousse committed
299