-
Notifications
You must be signed in to change notification settings - Fork 32
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #521 from IIIF/309-annotation-collections
Recipe #309 annotation collections
- Loading branch information
Showing
9 changed files
with
450 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| { | ||
| "@context": "http://iiif.io/api/presentation/3/context.json", | ||
| "id": "{{ id.url }}", | ||
| "type": "AnnotationCollection", | ||
| "label": { | ||
| "en": [ | ||
| "Newspaper layout markup" | ||
| ] | ||
| }, | ||
| "total": 8, | ||
| "first": "{{ id.path }}/anno_p1.json", | ||
| "last": "{{ id.path }}/anno_p2.json" | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,116 @@ | ||
| { | ||
| "@context": "http://iiif.io/api/presentation/3/context.json", | ||
| "id": "{{ id.url }}", | ||
| "type": "AnnotationPage", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/anno_coll.json", | ||
| "type": "AnnotationCollection" | ||
| }], | ||
| "next": "{{ id.path }}/anno_p2.json", | ||
| "items": [ | ||
| { | ||
| "id": "{{ id.url }}-1", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-1-1" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p1", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=88,957,2768,248" | ||
| } | ||
| } | ||
| }, | ||
| { | ||
| "id": "{{ id.url }}-2", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-1-2" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p1", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=80,1181,928,3384" | ||
| } | ||
| } | ||
| }, | ||
| { | ||
| "id": "{{ id.url }}-3", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-1-3" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p1", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=1000,2693,1880,1824" | ||
| } | ||
| } | ||
| }, | ||
| { | ||
| "id": "{{ id.url }}-4", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-2" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p1", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=992,1213,1904,1472" | ||
| } | ||
| } | ||
| } | ||
| ] | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,116 @@ | ||
| { | ||
| "@context": "http://iiif.io/api/presentation/3/context.json", | ||
| "id": "{{ id.url }}", | ||
| "type": "AnnotationPage", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/anno_coll.json", | ||
| "type": "AnnotationCollection" | ||
| }], | ||
| "prev": "{{ id.path }}/anno_p1.json", | ||
| "items": [ | ||
| { | ||
| "id": "{{ id.url }}-1", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-3-1" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p2", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=856,381,928,4200" | ||
| } | ||
| } | ||
| }, | ||
| { | ||
| "id": "{{ id.url }}-2", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-3-2" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p2", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=1784,2461,952,2064" | ||
| } | ||
| } | ||
| }, | ||
| { | ||
| "id": "{{ id.url }}-3", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-3-3" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p2", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=2736,2485,816,2064" | ||
| } | ||
| } | ||
| }, | ||
| { | ||
| "id": "{{ id.url }}-4", | ||
| "type": "Annotation", | ||
| "motivation": "tagging", | ||
| "body": { | ||
| "type": "TextualBody", | ||
| "format": "text/plain", | ||
| "value": "text-4" | ||
| }, | ||
| "target": { | ||
| "type": "SpecificResource", | ||
| "source": { | ||
| "id": "{{ id.path }}/canvas/p2", | ||
| "type": "Canvas", | ||
| "partOf": [{ | ||
| "id": "{{ id.path }}/manifest.json", | ||
| "type": "Manifest" | ||
| }] | ||
| }, | ||
| "selector": { | ||
| "type": "FragmentSelector", | ||
| "conformsTo": "http://www.w3.org/TR/media-frags/", | ||
| "value": "xywh=1792,373,1744,2064" | ||
| } | ||
| } | ||
| } | ||
| ] | ||
| } |
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,64 @@ | ||
| --- | ||
| title: Grouping Annotations into Collections | ||
| id: 309 | ||
| layout: recipe | ||
| tags: [tbc] | ||
| summary: "tbc" | ||
| viewers: | ||
| topic: | ||
| - basic | ||
| --- | ||
|
|
||
| ## Use Case | ||
|
|
||
| You have a large number of Annotations covering multiple Canvases in a Manifest, for example crowd-sourced transcriptions or the output from a layout analysis algorithm, and you want the Annotations to be displayed in a viewer as a recognizable group over the document with a label and possibly a common color. | ||
|
|
||
| ## Implementation Notes | ||
|
|
||
| The [IIIF Presentation API 3](https://iiif.io/api/presentation/3.0/#58-annotation-collection) defines Annotation Collections as a mechanism to represent groupings of Annotation Pages that should be managed as a single whole, regardless of which Canvas or resource they target. A viewer could, for example present all Annotations belonging to a Collection with a common color but the choice of presentation is left to the viewer. | ||
|
|
||
| The Annotation Collection is a separate document that references a chain of one or more separate Annotation Pages which contain the Annotations. The Annotation Pages contain a reference to the parent Annotation Collection and a reference to the next page in the chain. | ||
|
|
||
| The Annotation Collection must have a `type` of "AnnotationCollection" and should have a `label` property that can be shown to the user and it can optionally contain additional properties as specified in the [IIIF Presentation API 3](https://iiif.io/api/presentation/3.0/#a-summary-of-property-requirements). | ||
|
|
||
| The Annotation Collection has a `first` property that contains the URI of the first Annotation Page in the sequence, a `last` property that contains the URI of the last Annotation Page and it should have a `total` property that contains the total number of Annotations in the collection. | ||
|
|
||
| The IIIF Manifest requires that Annotations that are intended to be shown on a Canvas are contained in Annotation Pages referenced in the `annotations` property of that Canvas. This means that all Annotations need to be grouped by Canvas and put into one or more Annotation Pages per Canvas. An Annotation Page can not contain Annotations for more than one Canvas. | ||
|
|
||
| <p style="float: right"> | ||
| <img src="diagram-309.png" alt="Annotation Collection Data Model" width="359"><br/> | ||
| </p> | ||
|
|
||
| The Annotation Pages must have a `type` of "AnnotationPage" and have an `items` property containing the list of Annotations, a `partOf` property that contains the URI of the parent Annotation Collection, and `next` and `prev` properties that contain the URIs of the next and previous Annotation Pages in the sequence. Annotation Pages are often separate documents that are [referenced][0269] in the Manifest using a reference object with an `id` property containing the URI of the external document and `type` containing its type. The reference object can also provide copies of other properties from the external document for access inside the Manifest. | ||
|
|
||
| For an Annotation Page you can provide the `partOf`, `next`, `prev` property in the reference object in the `annotations` property of the Canvas. In the `partOf` property of the Annotation Page you can provide a reference object for the Annotation Collection and its `label`, `total`, `first`, and `last` properties as in the example below. In the case of the Annotation Collection it is strongly suggested that you provide these properties in the Manifest to make it possible for the IIIF viewer to know that the Annotations are part of a Collection and display its label without having to load any of the external documents. If the information is not in the Manifest the viewer has to load all Annotation Pages referenced in the Canvases to find and load the Annotation Collections. | ||
|
|
||
| ## Example | ||
|
|
||
| We use a Manifest containing two pages from a newspaper (_Berliner Tageblatt_, February 16, 1925, from Staatsbibliothek Berlin via Europeana) and a set of Annotations concerning layout and reading order. | ||
|
|
||
| The Annotations select rectangular regions on the Canvases in the Manifest and add textual tags describing layout elements. They are contained in two AnnotationPages "anno_p1.json" for Annotations on the first Canvas and "anno_p2.json" for Annotations on the second Canvas. "anno_p1.json" contains a `next` reference to "anno_p2.json", "anno_p2.json" contains a `prev` reference to "anno_p1.json", and both pages contain a `partOf` reference to the AnnotationCollection. | ||
|
|
||
| The Annotation Collection is in the file "anno_coll.json". It has a `label` and references "anno_p1.json" as the `first` and "anno_p2.json" as the `last` page and contains the `total` number of Annotations. | ||
|
|
||
| The Annotation Collection referencing the Annotation Pages: | ||
|
|
||
| {% include jsonviewer.html src="anno_coll.json" %} | ||
|
|
||
| The first AnnotationPage with Annotations on the first Canvas: [anno_p1.json](anno_p1.json) | ||
|
|
||
| The second AnnotationPage with Annotations on the second Canvas: [anno_p2.json](anno_p2.json) | ||
|
|
||
| The Manifest containing the two Canvases and referencing the Annotation Pages: | ||
|
|
||
| {% include manifest_links.html viewers="" manifest="manifest.json" %} | ||
|
|
||
| {% include jsonviewer.html src="manifest.json" config='data-line="66-80,124-138"' %} | ||
|
|
||
| ## Related Recipes | ||
|
|
||
| * [Embedded or Referenced Annotations][0269] for referencing Annotations in external Annotation Pages | ||
| * [Simple Annotation - Tagging][0021] annotating a rectangular Canvas region | ||
|
|
||
| {% include acronyms.md %} | ||
| {% include links.md %} |
Oops, something went wrong.