Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dasch-swiss/iiif-templates
IIIF Resource Templates
https://github.com/dasch-swiss/iiif-templates
iiif json-ld
Last synced: 2 months ago
JSON representation
IIIF Resource Templates
- Host: GitHub
- URL: https://github.com/dasch-swiss/iiif-templates
- Owner: dasch-swiss
- License: apache-2.0
- Created: 2022-04-11T12:37:13.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-06T09:28:28.000Z (almost 2 years ago)
- Last Synced: 2023-05-14T09:20:46.143Z (over 1 year ago)
- Topics: iiif, json-ld
- Homepage:
- Size: 53.7 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# iiif-templates
The repository is comprised of:
1. Various templates designed to be used to serialise resources compatible with the [International Image Interoperability Framework (IIIF) Presentation API 3.0](https://iiif.io/api/presentation/3.0/) based on use cases hosted by DaSCH
2. Activity Streams Templates compatible with the [IIIF Change Discovery API 1.0](https://iiif.io/api/discovery/1.0/)
## IIIF Presentation API 3.0 Resources
On the table below are the main types of resources that could be compliant with the IIIF Presentation API 3.0, which [`kb:Representation` subclass](https://docs.dasch.swiss/2022.09.01/DSP-API/02-knora-ontologies/knora-base/#representations) the content has, which type of IIIF Resource they belong to (either `Manifest` or `Collection`) as well as the boilerplate in JSON-LD.
| **Type** | **`kb:Representation` subclass of the content** | **IIIF Resource** | **Boilerplate** |
|---------------------------|----------------------------------|-------------------|--------------------------------------------------|
| Single image | `StillImageRepresentation` | Manifest | [boilerplate 1](boilerplates/boilerplate01.json) |
| Series of images | `StillImageRepresentation` | Manifest| [boilerplate 2](boilerplates/boilerplate02.json) | |
| Audio | `AudioRepresentation` | Manifest | [boilerplate 3](boilerplates/boilerplate03.json) | |
| Video | `MovingImageRepresentation` | Manifest | |
| 3D representation | `DDDrepresentation` | Manifest | |
| *Versatile* Object | `ObjectWithDifferentRepresentations` | Manifest | |
| Collection of Manifests | - | Collection | [boilerplate 6](boilerplates/boilerplate06.json) | |
| Collection of Collections | - | Collection | |
### Boilerplate elements
#### IIIF Manifest
1. Metadata about the IIIF resource (`context`, `id`, `type`)
2. Summary (`summary`)
3. Descriptive Metadata about the object
4. Rights Information (`rights`, `requiredStatement`)
5. Related links (`logo`,`homepage`, `seeAlso`, `provider`, `rendering`, `start`)
6. Presentation information (`viewing Direction`, `navDate`, `thumbnail`)
7. List of Canvases (`items` + `id`, `type`, `label` for each resource - see below)
_The `Canvas` represents an individual page or view and acts as a central point for assembling the different content resources that make up the display._
Here is a detailed view of the [first boilerplate](boilerplates/boilerplate01.json#L170):
```
{
"id": "https://raw.githubusercontent.com/dasch-swiss/iiif-templates/main/boilerplates/boilerplate01/canvas/p1",
"type": "Canvas",
"label": {
"none": [
"1383232"
]
},
"height": 3276,
"width": 2440,
"items": [
{
"id": "https://raw.githubusercontent.com/dasch-swiss/iiif-templates/main/boilerplates/boilerplate01/canvas/p1/1",
"type": "AnnotationPage",
"items": [
{
"id": "https://raw.githubusercontent.com/dasch-swiss/iiif-templates/main/boilerplates/boilerplate01/p0001-image",
"type": "Annotation",
"motivation": "painting",
"body": {
"id": "https://iiif.dasch.swiss/0801/4VjgCwiTn8p-CTaooIqSZBO.jpx/full/max/0/default.jpg",
"type": "Image",
"format": "image/jpeg",
"height": 3276,
"width": 2440,
"service": [
{
"id": "https://iiif.dasch.swiss/0801/4VjgCwiTn8p-CTaooIqSZBO.jpx/",
"type": "ImageService3",
"profile": "level2"
}
]
},
"target": "https://raw.githubusercontent.com/dasch-swiss/iiif-templates/main/boilerplates/boilerplate01/canvas/p1/1"
}
]
}
]
}
```
#### IIIF Collection
The form for use cases 3 and 4 will have the following components:
1. Metadata about the IIIF resource (`context`, `id`, `type`)
2. Summary (`summary`)
3. Related links (`logo`, `provider`)
4. List of Manifests/Collections (`items` + `id`, `type`, `label` for each resource)
## Activity Streams Templates
Based on the [IIIF Change Discovery API endpoint from the Bodleian Libraries](https://iiif.bodleian.ox.ac.uk/iiif/activity/all-changes), the following templates were created:
- an `OrderedCollection` ([all-changes](activity/all-changes.json))
- a first `OrderedCollectionPage` ([page-0](activity/page-0.json))
- the subsequent pages pointing to each of the IIIF resource boilerplates (either `Manifest` or `Collection`) which are all `Create` activities and can be found in this [directory](activity/create/).
## Python script
See the [daschiiify repository](https://github.com/dasch-swiss/daschiiify) that leverages the [iiif-prezi3 library](https://iiif-prezi.github.io/iiif-prezi3/).