Skip to content

Commit

Permalink
Revise use case.
Browse files Browse the repository at this point in the history
  • Loading branch information
mathewjordan committed Sep 25, 2023
1 parent c265e8e commit e12baac
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions recipe/0032-collection/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,18 +14,23 @@ topic:

## Use Case

The simplest possible collection to reference multiple Manifests that are organized into a single IIIF resource. Collections may also reference other Collections as sub-collections. IIIF Collections have no restrictions on the organizational purpose of their referenced resources, though the resources may be related as a named digital collection, a common metadata value, or be organized as search results.
Your organization has a named digital collection of artworks by a specific person. These unique items are already digital objects represented by Manifests and you would like to organize and present them as an ordered IIIF Presentation resource.

## Implementation notes

This illustrates the mandatory structure and properties of a Collection, with the simplest possible content.
This recipe illustrates the mandatory structure and properties of a Collection, with the simplest possible content.

Like with a Manifest, The JSON-LD opens with the`@context` declaration, which identifies the terms used in the document as belonging to the IIIF specification. The `id` property identifies this collection with the URL at which it is available online. The `type` property must be `Collection`.

As with a Manifest, the `label` property is mandatory, and the language of its value must be given (or the special value `none`), using a [language map](https://iiif.io/api/presentation/3.0/#language-of-property-values). Here the language of the `label` is English and its value is “Simple Collection Example”.

The Collection `items` property is an array of referenced Manifests. In this example there are two Manifests. Each `items` entry must have an `id`, `type`, and a `label`. The `id` must be the URI where the Manifest can be available online. The `type` must be `Manifest` or a `Collection`. Each `items` entry referenced should not be full embedded into the Collection, and should contain only necessary properties for presentation of the collection such as thumbnail. Various other [descriptive](https://iiif.io/api/presentation/3.0/#31-descriptive-properties) and [linking](https://iiif.io/api/presentation/3.0/#33-linking-properties) properties such as `summary`, minimal `metadata`, and `homepage` may be useful as well for presentation. See the [Summary of property requirements](https://iiif.io/api/presentation/3.0/#a-summary-of-property-requirements) for a complete list.

Though this simple recipe references on Manifests, Collections may also reference other Collections as sub-collections. IIIF Collections have no restrictions on the organizational purpose of their referenced resources, though the resources may be related as a named digital collection, a common metadata value, or be organized as search results.

## Restrictions


## Example

{% include manifest_links.html viewers="UV, Mirador, Clover" manifest="collection.json" %}
Expand Down

0 comments on commit e12baac

Please sign in to comment.