Recipe #103 -- Annotating a Poetry Reading

recipe/0103-poetry-reading-annotations/annotations.json

@@ -0,0 +1,47 @@
+---
+layout: null
+---
+{
+  "@context": "http://iiif.io/api/presentation/3/context.json",
+  "id": "{{site.url}}{{site.baseurl}}{{page.dir}}annotations.json",
+  "type": "AnnotationPage",
+  "items": 
+  [
+   { 
+      "@context":"http://www.w3.org/ns/anno.jsonld",
+      "id":"{{site.url}}{{site.baseurl}}/{{page.path}}/canvas/annotation1",
+      "type":"Annotation",
+      "motivation":"commenting",
+      "body":{ 
+         "type":"TextualBody",
+         "value":"breath",
+         "format":"text/plain"
+      },
+      "target":{ 
+         "source":"{{site.url}}{{site.baseurl}}/{{page.path}}/canvas/segment1",
+         "selector":{ 
+            "type":"PointSelector",
+            "t":"27.660653"
+         }
+      }
+   },
+  {
+    "@context": "http://www.w3.org/ns/anno.jsonld",
+    "id": "{{site.url}}{{site.baseurl}}/{{page.path}}/canvas/segment1/annotation/4",
+    "type": "Annotation",
+    "motivation": "commenting",
+    "body": {
+      "type": "TextualBody",
+      "value": "her kind",
+      "format": "text/plain"
+    },
+    "target": {
+      "source": "{{site.url}}{{site.baseurl}}/{{page.path}}/canvas/segment1",
+      "selector": {
+        "type": "RangeSelector",
+        "t": "46.734653,47.875068"
+      }
+    }
+  }
+ ]
+}

recipe/0103-poetry-reading-annotations/index.md

@@ -0,0 +1,84 @@
+---
+title: Annotating a Poetry Reading
+id: 103
+layout: recipe
+tags: [audio, presentation, annotation]
+summary: "Use annotations to indicate aspects of the performance of a particular poem."
+---
+
+
+## Use Case
+
+While an audio file of a poetry performance may be divided into a track for each poem, scholars may wish to use annotations to indicate aspects of the performance of a particular poem.  
+
+A researcher might want to annotate the following types of information:
+* structural information (introduction, title, stanzas)
+* points where the performer takes a breath
+* repeated phrases
+
+Since annotations could be available at the same time the manifest is generated, or might be a separate process that references the item manifest, both scenarios are shown.
+
+There is a third use case where manifests are unaware of annotations on them, but the systems that display the item are aware of the annotations and pull them in, using the target block in the annotation.
+
+## Implementation notes
+
+1. This implementation builds off of the [audio example][0002], but adds Web Annotations.
+
+2. This recipe shows two variations of referencing annotations from within a manifest.  The first has the annotations embedded within the manifest file.  The second has a reference to annotations in a separate file.
+
+3. Where we use "RangeSelector" for the annotation target, we could instead use a Media Fragment like "#t=1.23,2.23" appended to the canvas URL. Instead of "source" you'd condense it into the "target" field.  For example:
+
+```
+                "target": {
+                  "source": "http://localhost:4000/recipe/0103-poetry-reading-annotations/manifest1.json/canvas/segment1/canvas/segment1",
+                  "selector": {
+                    "type": "RangeSelector",
+                    "t": "46.734653,47.875068"
+                  }
+```
+
+Could become
+
+```
+                "target": "http://localhost:4000/recipe/0103-poetry-reading-annotations/manifest1.json/canvas/segment1/canvas/segment1#t=46.734653,47.875068"
+```
+
+Both are correct.
+
+4. While the IIIF Specification requires arrays for most values, the W3C Web Annotation Specification does not require arrays, so the following line: 
+
+`"motivation": "commenting",`
+
+is correct, but unusual for a IIIF resource.  It could also be expressed (and must be if there is more than one motivation) as follows:
+
+`"motivation": ["commenting"],`
+
+## Example
+
+A manifest for the poem "Her Kind" read by Anne Sexton in 1974.  The recording is 107 seconds long.  Annotations are included in the manifest and show both a point annotation (at a particular time) and a range annotation (covering a time range).  (For more on these annotations, see the [annotation.json file description.](#annotations))
+
+{: .line-numbers data-src="manifest1.json" }
+```json
+```
+
+The same manifest, but with a reference to annotations in a separate file.  The annotation file is included below the manifest. 
+
+{: .line-numbers data-src="manifest2.json" }
+```json
+```
+
+<a name="annotations"></a>Annotation examples, both a point annotation (at a particular time) and a range annotation (covering a time range).  We use the "supplementing" motivation because these annotations are derived from the audio file on the canvas and the "commenting" motivation because the annotations are a comment about the canvas.  Annotations must have "supplementing" as a motivation for any annotations derived from the items on the canvas.
+
+{: .line-numbers data-src="annotations.json" }
+```json
+```
+
+# Related recipes
+
+* [Simple Manifest - Audio][0002]
+* [Transformation - WebVTT or OHMS XML to Annotations][0079]
+
+
+{% include acronyms.md %}
+{% include links.md %}
+

recipe/0103-poetry-reading-annotations/manifest1.json

@@ -0,0 +1,99 @@
+---
+layout: null
+---
+{
+  "@context":"http://iiif.io/api/presentation/3/context.json",
+  "id":"{{site.url}}{{site.basurl}}/{{page.path}}",
+  "type":"Manifest",
+  "label":{
+    "en":[
+      "Anne Sexton, Poetry Reading, 1974 -- Her Kind"
+    ]
+  },
+  "items":[
+    {
+      "id":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1",
+      "type":"Canvas",
+      "duration":107,
+      "items":[
+        {
+          "id":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1/paintings",
+          "type":"AnnotationPage",
+          "items":[
+            {
+              "id":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1/painting/1",
+              "type":"Annotation",
+              "motivation":"painting",
+              "body":{
+                "id":"https://library.harvard.edu/poetry/audio/listeningbooth//PS3537E915A6x1974/Her_Kind.mp3",
+                "type":"Sound",
+                "format":"audio/mp3",
+                "duration":107
+              },
+              "target":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1"
+            }
+          ],
+          "annotations":[
+            {
+              "id":"{{site.url}}{{site.baseurl}}{{page.dir}}annotations.json",
+              "type":"AnnotationPage",
+              "items":[
+                {
+                  "@context":"http://www.w3.org/ns/anno.jsonld",
+                  "id":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1/annotation/1",
+                  "type":"Annotation",
+                  "motivation":"commenting",
+                  "body":{
+                    "type":"TextualBody",
+                    "value":"breath",
+                    "format":"text/plain"
+                  },
+                  "target":{
+                    "source":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1",
+                    "selector":{
+                      "type":"PointSelector",
+                      "t":"27.660653"
+                    }
+                  }
+                },
+                {
+                  "@context":"http://www.w3.org/ns/anno.jsonld",
+                  "id":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1/annotation/2",
+                  "type":"Annotation",
+                  "motivation":"commenting",
+                  "body":{
+                    "type":"TextualBody",
+                    "value":"her kind",
+                    "format":"text/plain"
+                  },
+                  "target":{
+                    "source":"{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1",
+                    "selector":{
+                      "type":"RangeSelector",
+                      "t":"46.734653,47.875068"
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "homepage":[
+    {
+      "id":"https://library.harvard.edu/poetry/listeningbooth/poets/sexton.html",
+      "type":"Text",
+      "label":{
+        "en":[
+          "Anne Sexton at the Woodberry Poetry Room"
+        ]
+      },
+      "format":"text/html",
+      "language":[
+        "en"
+      ]
+    }
+  ]
+}

recipe/0103-poetry-reading-annotations/manifest2.json

@@ -0,0 +1,51 @@
+---
+layout: null
+---
+{
+    "@context": "http://iiif.io/api/presentation/3/context.json",
+    "id": "{{site.url}}{{site.basurl}}/{{page.path}}",
+    "type": "Manifest",
+    "label": { "en": [ "Anne Sexton, Poetry Reading, 1974 -- Her Kind" ] },
+    "items": [
+      {
+        "id": "{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1",
+        "type": "Canvas",
+        "duration": 107,
+        "items": [
+          {
+            "id": "{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1/paintings",
+            "type": "AnnotationPage",
+            "items": [
+              {
+                "id": "{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1/painting/1",
+                "type": "Annotation",
+                "motivation": "painting",
+                "body": {
+                  "id": "https://library.harvard.edu/poetry/audio/listeningbooth//PS3537E915A6x1974/Her_Kind.mp3",
+                  "type": "Sound",
+                  "format": "audio/mp3",
+                  "duration": 107
+                },
+                "target": "{{site.url}}{{site.baseurl}}{{page.dir}}canvas/1"
+              },
+            ],
+          }    
+        ],
+      }
+    ],
+    "annotations": [
+      {
+        "id": "{{site.url}}{{site.baseurl}}{{page.dir}}annotations.json",
+        "type": "AnnotationPage",
+      }
+    ],
+    "homepage": [
+      {
+        "id": "https://library.harvard.edu/poetry/listeningbooth/poets/sexton.html",
+        "type": "Text",
+        "label": { "en": [ "Anne Sexton at the Woodberry Poetry Room" ] },
+        "format": "text/html",
+        "language": [ "en" ]
+      }
+    ]
+  }