nakala-presenter-les donnees.md 8.1 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
140
Combinaison d’extraction, de rotation et de redimensionnement de l’image (paramètres [région], {taille} et {rotation})  

141
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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164

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

A partir de la page d’accueil d'une donnée
- Citation
- Partage « visuel »
- Métadonnées embarquées

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

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
172
[Citation de l'interface](../../media/meta/nakala_citation_interface.png)

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
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
185
[Métadonnées embarquées](../../media/meta/nakala_metadonnees_embarquees.png)


186
### A partir de points d’accès standardisés  
187

188
#### API de NAKALA
189
Il est possible d'accéder aux métadonnées descriptive d'une donnée par l’API de NAKALA  
190
191
https://api.nakala.fr/datas//[identifiant]

192
Par exemple  
193
194
https://api.nakala.fr/datas/11280/111643de  

195
Le format de sortie est en XML ou en Json récupérable de manière automatisée 
196
197
198
199
200
201
202
203
204

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

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

207
208
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  
209

210

211
212
213
### Les consommateurs de métadonnées 


214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
#### ISIDORE 


#### Gallica



#### Data Cite 


#### OpenAire 


#### Google Data Search 



231
232
233



234

Nicolas Larrousse's avatar
Nicolas Larrousse committed
235