Recipe #103 -- Annotating a Poetry Reading

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

@@ -0,0 +1,86 @@
+---
+title: Scholarly Annotation of a Poetry Reading
+id: 103
+layout: recipe
+tags: [audio, presentation, annotation]
+summary: "Use annotations to indicate aspects of the performance of a particular poem."
+viewers:
+  - Mirador
+  - Aviary Viewer
+  - Ramp
+  - UV
+topic:
+  - AV
+code:
+  - iiif-prezi3
+---
+
+
+## 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.  
+
+For a performance of a published text, transcribing the performance is of little use to the researcher annotating the performance.  Rather, the annotations serve as commentary on the performance itself.
+
+A researcher might want to annotate the following types of information:
+* structural information (introduction, title, stanzas)
+* points where the performer takes a breath
+* repeated or emphasized phrases
+
+## Implementation notes
+
+This implementation builds off of the [audio example][0002], but adds Web Annotations. We show both annotation targeting using a FragmentSelector and a simplified Media Fragment appended to the canvas URL.
+
+FragmentSelector using a SpecificResource:
+
+```
+"target":{
+  "type":"SpecificResource",
+  "source":{
+     "id":"{{ id.path }}/canvas/1",
+     "type":"Canvas",
+     "partOf":[
+        {
+           "id":"{{ id.url }}",
+           "type":"Manifest"
+        }
+     ]
+  },
+  "selector":{
+     "type":"FragmentSelector",
+     "conformsTo":"http://www.w3.org/TR/media-frags/",
+     "value":"t=705.0,707.0"
+  }
+}
+
+```
+
+Media Fragment using "#t=702.0,705.0" appended to the canvas URL. Instead of "source" you'd condense it into the "target" field:
+
+```
+"target":"{{ id.path }}/canvas/1#t=702.0,705.0"
+```
+
+If you are targeting a single point, you should use a point selector.  The [Begin playback at a specific point - Time-based media][0015] recipe demonstrates that approach.
+
+Because the annotations are pointing out features of the audio, rather than transcriptions, the "motivation" for each annotation is "commenting" not "supplementing".  (If the annotations were transcriptions, their motivation would be "supplementing".)
+
+
+## Example
+
+A manifest for a poetry reading by Canadian poet Daphne Marlatt in 2018.  The recording is 707 seconds long.
+{% include manifest_links.html manifest="manifest.json" %}
+
+{% include jsonviewer.html src="manifest2.json" %}
+
+
+# Related recipes
+
+* [Simple Manifest - Audio][0002]
+* [Transformation - WebVTT or OHMS XML to Annotations][0079]
+* [Begin playback at a specific point - Time-based media][0015]
+* [Embedded or Referenced Annotations][0269]
+
+{% include acronyms.md %}
+{% include links.md %}
+

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

@@ -0,0 +1,66 @@
+{
+   "@context":"http://iiif.io/api/presentation/3/context.json",
+   "id":"{{ id.url }}",
+   "type":"Manifest",
+   "label":{
+      "en":[
+         "Mediation and Lived Experience - Daphne Marlatt Performs With Her Younger Self"
+      ]
+   },
+   "items":[
+      {
+         "id":"{{ id.path }}/canvas/1",
+         "type":"Canvas",
+         "duration":707.0,
+         "items":[
+            {
+               "type":"AnnotationPage",
+               "id":"{{ id.path }}/canvas/1/item_page/1",
+               "items":[
+                  {
+                     "id":"{{ id.path }}/canvas/1/painting/1",
+                     "type":"Annotation",
+                     "motivation":"painting",
+                     "body":{
+                        "id":"https://soundbox.ok.ubc.ca/wp-content/uploads/2023/02/Performing-the-Archive%EF%BC%9A-Leaf-leaf%E2%A7%B8s-by-Daphne-Marlatt.mp3",
+                        "type":"Sound",
+                        "format":"audio/mpeg",
+                        "duration":707.0
+                     },
+                     "target":"{{ id.path }}/canvas/1"
+                  }
+               ]
+            }
+         ],
+         "annotations":[
+            {
+               "id":"{{ id.path }}/canvas/1/page1",
+               "type":"AnnotationPage",
+               "label":{
+                  "en":[
+                     "Environmental Noise"
+                  ]
+               },
+               "items":[
+                  {
+                     "type":"Annotation",
+                     "motivation":[
+                        "commenting"
+                     ],
+                     "id":"{{ id.path }}/canvas/1/page1/anno2",
+                     "body":[
+                        {
+                           "type":"TextualBody",
+                           "value":"Soft laughter, rustling",
+                           "format":"text/plain",
+                           "motivation":"commenting"
+                        }
+                     ],
+                     "target":"{{ id.path }}/canvas/1#t=702.0,70.05"
+                  }
+               ]
+            }
+         ]
+      }
+   ]
+}