Merge pull request #130 from IIIF/0103-poetry

Recipe #103 -- Annotating a Poetry Reading

Author: glenrobson

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

@@ -0,0 +1,52 @@
+---
+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:
+  - Ramp
+  - Aviary
+topic:
+  - AV
+---
+
+
+## Use Case
+
+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 annotation targeting using a simplified Media Fragment `#t=702.0,705.0` appended to the canvas URL.
+
+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 that includes an annotation describing environmental noise.  The recording is 707 seconds long.
+{% include manifest_links.html manifest="manifest.json" %}
+
+{% include jsonviewer.html src="manifest.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/manifest.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.81,
+         "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://fixtures.iiif.io/audio/ubc/Performing-the-Archive-Leaf-leafs-by-Daphne-Marlatt.mp3",
+                        "type":"Sound",
+                        "format":"audio/mpeg",
+                        "duration":707.81
+                     },
+                     "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,705.0"
+                  }
+               ]
+            }
+         ]
+      }
+   ]
+}