nakala-presenter-les donnees.md 11 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
Voici comment ces éléments sont présentés dans l'interface de NAKALA
20

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
![URLs d'accès aux composants de l'objet numérique](../media/meta/nakala_url_composants.png)
52

53

54
55
Les URLs associées à un objet numériques sont accessibles depuis l'interface de NAKALA

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

Nicolas Larrousse's avatar
Nicolas Larrousse committed
58

59
60


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

63

64
65
### Utilisation de code HTML

66
67
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

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

71
Image 
72

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

Vidéo 
78

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

Audio 
84

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

89
90
91

### La visionneuse intégrée 

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

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

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

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

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

125
126
Voici quelques exemples avec l’image  

127
[https://nakala.fr/11280/111643de](https://nakala.fr/11280/111643de)
128

129
130
Modification de la taille de l’image  (paramètre {taille}) 

131
[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)
132

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

135
[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)
136

137
138
Rotation de l’image (paramètre {rotation})  

139
[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)
140

141
Combinaison d’extraction, de rotation et de redimensionnement de l’image (paramètres [région], {taille} et {rotation})  
142
143
[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)
144

145
![Combinaison de plusieurs paramètres IIIF](../media/meta/nakala_iiif_multiple.png)
146
147
148

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

149
150
151

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

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

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

162
Organisation d’une donnée (objet numérique) dans NAKALA  
163
![Objet Numérique](../media/meta/nakala_objet_numerique.png)
164
165
166



167
### A partir de la page d’accueil
168

169
#### Citation
170

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

173
![Citation depuis l'interface](../media/meta/nakala_citation_interface.png)
174

175
#### Partage « visuel »
176

177
178
Les métadonnées complètes sont accessibles visuellement via l'interface

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

181
#### Métadonnées "embarquées" dans la page d'accueil  
182

183
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. 
184

185
![Métadonnées embarquées](../media/meta/nakala_metadonnees_embarquees.png)
186

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

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

191

192
### A partir de points d’accès standardisés  
193

194
#### API de NAKALA
195
196
197

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]
198

199
Par exemple  
200
201

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

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

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

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

209
210
#### Protocole OAI-PMH

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

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

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

220
221
222
223
224
225
226
227

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)  

228
![Métadonnées récupérées via le protocole OAI-PMH](../media/meta/nakala_metadonnees_oai.png)
229
230
231
232
233
234

#### Triple Store

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

235

236

237
238
239
### Les consommateurs de métadonnées 


240
241
#### ISIDORE 

242
243
244
245
246
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 


247
![Métadonnées vues par ISIDORE](../media/meta/nakala_metadonnees_isidore.png)
248
249
250
251
252

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

253
254
255

#### Gallica

256
257
258
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 
259
260


261
![Métadonnées vues par GALLICA](../media/meta/nakala_metadonnees_gallica.png)
262

263
264
#### Data Cite 

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)


270
![Métadonnées vues par DataCite](../media/meta/nakala_metadonnees_datacite.png)
271

272
273
274

#### OpenAire 

275
276
277
278
279
280
281
282
283
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


284
285
286

#### Google Data Search 

287
288
289
290
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 

291
Google Data Search effectue un lien lorsque cela est possible entre  les données à les articles présents dans [Google Scholar](https://scholar.google.com/)
292
293


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


297
298
299



300

Nicolas Larrousse's avatar
Nicolas Larrousse committed
301