Recipe #103 -- Annotating a Poetry Reading

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

@@ -0,0 +1,107 @@
+---
+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:
+  - basic
+  - audio
+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
+
+1. This implementation builds off of the [audio example][0002], but adds Web Annotations.
+
+2. We show both annotation targeting using a FragmentSelector and a simplified Media Fragment appended to the canvas URL.
+
+FragementSelector 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,707"
+                        }
+                     }
+
+```
+
+Media Fragment using "#t=702,705" appended to the canvas URL. Instead of "source" you'd condense it into the "target" field:
+
+```
+"target":"{{ id.path }}/canvas/1#t=702,705"
+```
+
+But you could also use the more verbose form:
+
+    ```
+              "target":{
+                "source":"{{ id.path }}/canvas/1",
+                "selector":{
+                  "type":"RangeSelector",
+                  "startSelector":{
+                    "type":"PointSelector",
+                    "t":702
+                  },
+                  "endSelector":{
+                    "type":"PointSelector",
+                    "t":705
+                  }
+                }
+    ```
+
+
+3.  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.
+
+{: .line-numbers data-src="manifest2.json" }
+```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,135 @@
+{
+   "@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,
+         "items":[
+            {
+               "type":"AnnotationPage",
+               "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
+                     },
+                     "target":"{{ id.path }}/canvas/1"
+                  }
+               ]
+            }
+         ],
+         "annotations":[
+            {
+               "@context":"http://iiif.io/api/presentation/3/context.json",
+               "id":"{{ id.path }}/canvas/1/page1",
+               "type":"AnnotationPage",
+               "label":{
+                  "en":[
+                     "Default"
+                  ]
+               },
+               "items":[
+                  {
+                     "@context":"http://www.w3.org/ns/anno.jsonld",
+                     "type":"Annotation",
+                     "motivation":[
+                        "commenting"
+                     ],
+                     "id":"{{ id.path }}/canvas/1/page1/anno1",
+                     "body":[
+                        {
+                           "type":"TextualBody",
+                           "value":"In this final poem, Marlatt seems to blend the past and present reading conventions that we have heard in the recording. The poem she chooses demands the precision and round, assonant vowels most prominently featured in the 1969 clips. But it is brief poem, and her 2019 reading is also present in a softness and spaciousness which which she delivers the poem. Here, in a social voice, Marlatt is perhaps aware of her own voice across time.",
+                           "format":"text/plain",
+                           "motivation":"commenting"
+                        }
+                     ],
+                     "target":"{{ id.path }}/canvas/1#t=701,701"
+                  },
+                  {
+                     "@context":"http://www.w3.org/ns/anno.jsonld",
+                     "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,705"
+                  },
+                  {
+                     "@context":"http://www.w3.org/ns/anno.jsonld",
+                     "type":"Annotation",
+                     "motivation":[
+                        "commenting"
+                     ],
+                     "id":"{{ id.path }}/canvas/1/page1/anno3",
+                     "body":[
+                        {
+                           "type":"TextualBody",
+                           "value":"Well, that was…",
+                           "format":"text/plain",
+                           "motivation":"commenting"
+                        }
+                     ],
+                     "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,707"
+                        }
+                     }
+                  },
+                  {
+                     "@context":"http://www.w3.org/ns/anno.jsonld",
+                     "type":"Annotation",
+                     "motivation":[
+                        "commenting"
+                     ],
+                     "id":"{{ id.path }}/canvas/1/page1/anno4",
+                     "body":[
+                        {
+                           "type":"TextualBody",
+                           "value":"Marlatt's final words, possibly addressed to someone sitting beside her, are cut off. ",
+                           "format":"text/plain",
+                           "motivation":"commenting"
+                        }
+                     ],
+                     "target":"{{ id.path }}/canvas/1#t=707,707"
+                  }
+               ]
+            }
+         ]
+      }
+   ]
+}