Recipe #103 -- Annotating a Poetry Reading #130

glenrobson · 2019-11-20T12:35:43Z

Merging Sara's remote copy to the IIIF repo so that it can be built automatically. Original pull request with comments is #107. Original description from Sara:

An initial attempt at a IIIF v3 manifest with annotations on an audio file.

This needs to be updated with github pages references instead of raw github references to our repo, but I think that's a chicken & egg problem that will be fixed after merging (by whom?)

Discussion here or in the IIIF AV Slack channel.

… file

change minutes to seconds. Co-Authored-By: cjcolvar <[email protected]>

glenrobson · 2019-11-20T12:36:29Z

(Automated comment): Branch aviliable for testing at https://preview.iiif.io/cookbook/0103-poetry

glenrobson · 2019-11-20T12:38:28Z

Actually recipe available at:

https://preview.iiif.io/cookbook/0103-poetry/recipe/0103-poetry-reading-annotations/

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

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

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

azaroth42 · 2019-12-18T17:49:32Z

Comments on the text:

The numbered list is broken -- it restarts at 1. for "While the IIIF Specification" ...
The examples do not use arrays of motivations, so I suggest deleting the entry completely.
The text and example do not line up -- The text says the final example has both supplementing and commenting, whereas it only has commenting. As below, I think it should be only supplementing.

Comments on the examples:

Shouldn't the MP3 be stored in IIIF S3 space to ensure that it stays working (see Newspaper recipe)
Is "her kind" a transcription of the spoken content? If so then it should be motivation supplementing, not commenting. See: https://iiif.io/api/presentation/3.0/#35-values

glenrobson · 2019-12-18T17:55:43Z

Thanks for your comments Rob. Regarding:

Shouldn't the MP3 be stored in IIIF S3 space to ensure that it stays working (see Newspaper recipe)

We did discuss this but haven't heard from Harvard if they are happy for us to take a copy of the content so haven't done so. It would be interesting to raise in the TRC what peoples thoughts are on this but is it better to have examples with external content soon or examples with hosted content which may take longer to arrange?

For info there was a similar discussion with the Newspapers and thankfully Europeana were OK for us to copy the images but we only copied the first two images and left the last two as remote.

glenrobson · 2019-12-19T12:33:44Z

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

+      {
+         "id":"{{ id.path }}/canvas/annotation1",
+         "type":"Annotation",
+         "motivation":"commenting",


Oh this is a difficult one... Is noting a breath taken a comment or a transcription?

but should be an array of values.

Comment. Pretty sure our academic partner calls this "paratext", which I wouldn't call transcription.

Sorry I'm wrong here it should be a string not an array...

glenrobson · 2019-12-19T12:36:09Z

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

+      {
+         "id":"{{ id.path }}/canvas/segment1/annotation/4",
+         "type":"Annotation",
+         "motivation":"commenting",


Per Rob's comment "Is "her kind" a transcription of the spoken content? If so then it should be motivation supplementing, not commenting. See: https://iiif.io/api/presentation/3.0/#35-values"

Listening to the recording it is a transcription so this should be:

"motivation":["supplementing"]

We'll change this to an array so it matches the IIIF spec rather than the w3c annotation spec.

Commenting is the correct motivation, as below.

Sorry I'm wrong here it should be a string...

glenrobson · 2019-12-19T12:37:00Z

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

+            {
+              "id":"{{ id.path }}/canvas/1/annotation/1",
+              "type":"Annotation",
+              "motivation":"commenting",


Should this be supplementing as above?

but needs to be an array

Sorry I'm wrong here it should be a string...

glenrobson · 2019-12-19T12:37:13Z

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

+            {
+              "id":"{{ id.path }}/canvas/1/annotation/2",
+              "type":"Annotation",
+              "motivation":"commenting",


Per Rob's comment "Is "her kind" a transcription of the spoken content? If so then it should be motivation supplementing, not commenting. See: https://iiif.io/api/presentation/3.0/#35-values"

Listening to the recording it is a transcription so this should be:

"motivation":["supplementing"]

We're going to change "her kind" into "repetition of 'her kind'" -- it's meant as commentary on the structure of the poem, rather than a direct transcription. That will clarify it.

Sorry I'm wrong here it should be a string...

glenrobson · 2019-12-19T12:38:45Z

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

+```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.


Related to the other changes but Rob's comments:

"The text and example do not line up -- The text says the final example has both supplementing and commenting, whereas it only has commenting. As below, I think it should be only supplementing."

…into 0103-poetry

benwbrum · 2019-12-19T14:40:14Z

I'm trying to figure out whether the motivations in this example should be ["supplementing", "commenting"] or just ["commenting"]. @saracarl has cleared up the fact that the annotations are not supposed to be transcriptions, which would necessitate a supplementing motivation as I understand it, but the annotations are certainly derived from the canvas, so I'm not sure whether supplementing should be added.

The IIIF spec says,

Thus content of any type may be associated with the Canvas via an Annotation that has the motivation value painting, meaning the content is part of the Canvas; an Annotation that has the motivation value supplementing, meaning the content is from the Canvas but not necessarily part of it; or an Annotation with another motivation meaning that it is somehow about the Canvas.

A scholar who notes when a performer draws a breath or emphasizes a phrase is not really transcribing the poem--especially if the remaining text of the poem is not also represented in the associated annotations--so we're not required to use supplementing here. On the other hand, I don't really understand the difference between the annotation being "from the canvas" versus "about the canvas".

The spec also gives some hints when it suggests behavior for presenting annotations with a supplementing motivation:

Resources associated with a Canvas by an Annotation that has the motivation value supplementing MAY be presented to the user as part of the representation of the Canvas, or MAY be presented in a different part of the user interface. The content can be thought of as being from the Canvas. [...] For example, an Annotation that has the motivation value supplementing, a body of an Image and the target of part of the Canvas is an instruction to present that Image to the user either in the Canvas's rendering area or somewhere associated with it, and could be used to present an easier to read representation of a diagram. Similarly, a textual body is to be presented either in the targeted region of the Canvas or otherwise associated with it, and might be a transcription or translation of handwritten text or captions for what is being said in a Canvas with audio content.

When presenting these annotations, we hope to see them alongside the media. However, they should not replace the media or be presented over the media: if, for example, these annotations were applied to a video recording of the performance instead of a pure audio recording, we would not want these annotations presented as captions. They function as footnotes to the performance--intended to be linked to particular sections of the media--but don't replace it. Clearly we should not use painting as a motivation, but does supplementing apply?

azaroth42 · 2019-12-19T17:56:04Z

As they're not intended to be transcription, then they're not supplementing. That said, I think the example is a poor one for a recipe due to this confusion. If the authors are confused, then people reading the recipe will be even more confused.

benwbrum · 2019-12-19T18:32:28Z

We'll remove the paragraph about supplementing from the markdown, and include a sentence clarifying that non-transcription/translation content such as scholarly commentary should use ["commenting"] motivations without supplementing. That might be useful for people who--like me--found the spec's distinction between "from the canvas" and "about the canvas" unclear when implementing.

glenrobson · 2019-12-19T21:36:42Z

Note the build is breaking as it expects the motivation to be a string... so I will need to fix that.

…e it anymore.

saracarl · 2019-12-19T23:06:01Z

Changes from the TRC:

remove the array brackets from the annotation motivation.
remove the array/string discussion in the implementation notes
explanation should explain "commenting" as a motivation.

Should we break this into 2 recipes; this one would only demonstrate scholarly commentary on audio files; another one would show how annotations can be internal to a manifest OR linked to an external annotation file?

benwbrum · 2020-01-24T17:22:35Z

Changes from today's cookbook meeting:

Fix renumbered list item in comment explanation
Remove version with embedded annotations -- a separate recipe will discuss embedding annotations vs. externalizing them.
Remove extra slash in URI for Harvard MP3 file.

Handle comment renumbering.

glenrobson · 2023-04-06T13:49:38Z

Tasks:

Merge in main so that you get the new styles
Send Glen and audio fixture for fixtures.iiif.io
Create a couple of annotations using Fragment selector
Re-work text and add links to Start for pointSelector and for remote annotations.
Only 1 manifest per recipe
Look at macros in: https://raw.githubusercontent.com/IIIF/cookbook-recipes/master/recipe/0001-mvm-image/index.md

saracarl and others added 16 commits September 17, 2019 12:43

initial directory & readme for poetry annotations

23c0443

initial manifest

2224c3b

manifest with working @id

971336a

@id with a .json

9f6b638

missed comma

16771c0

@id with a .json

5e35f81

added annotation

88cb0f2

added homepage link to manifest

53da3af

aded a RangeSelector annotation

53c8b36

edits to show both embedded annotations and annotations in a separate…

1ab053f

… file

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

b593f6a

change minutes to seconds. Co-Authored-By: cjcolvar <[email protected]>

updates per the Ann Arbor working meeting review

1440f36

better IDs/URIs for all the things

d7b1ec7

fixed double frontmatter

fae0bea

Merge remote-tracking branch 'sara/master' into 0103-poetry

dc834e4

Importing from Sara's branch and updating Jekyll variables

6a5f995

glenrobson added 2 commits November 20, 2019 15:47

Merge branch 'master' into 0103-poetry

039e394

Merge branch 'master' into 0103-poetry

3e1ea5d

glenrobson mentioned this pull request Dec 3, 2019

Recipe #103 -- Annotating a Poetry Reading #107

Closed

glenrobson added content: av Recipe involves temporal material meta: ready-for-trc Issue is ready for TRC review labels Dec 4, 2019

glenrobson mentioned this pull request Dec 4, 2019

Recipe #103 -- Annotating a Poetry Reading IIIF/trc#34

Closed

azaroth42 requested changes Dec 10, 2019

View reviewed changes

recipe/0103-poetry-reading-annotations/manifest1.json Outdated Show resolved Hide resolved

azaroth42 removed the meta: ready-for-trc Issue is ready for TRC review label Dec 10, 2019

azaroth42 reviewed Dec 10, 2019

View reviewed changes

recipe/0103-poetry-reading-annotations/annotations.json Outdated Show resolved Hide resolved

azaroth42 reviewed Dec 10, 2019

View reviewed changes

recipe/0103-poetry-reading-annotations/annotations.json Outdated Show resolved Hide resolved

azaroth42 reviewed Dec 10, 2019

View reviewed changes

recipe/0103-poetry-reading-annotations/manifest1.json Outdated Show resolved Hide resolved

azaroth42 reviewed Dec 10, 2019

View reviewed changes

recipe/0103-poetry-reading-annotations/manifest1.json Outdated Show resolved Hide resolved

Fixing numbered list

0b947c7

glenrobson commented Dec 19, 2019

View reviewed changes

saracarl added 2 commits December 19, 2019 08:19

changes

c316a21

Merge branch '0103-poetry' of https://github.com/IIIF/cookbook-recipes …

13d0482

…into 0103-poetry

more stuff

d7056dd

fixed the reference to the annotation description, since we don't hav…

f4451e2

…e it anymore.

glenrobson mentioned this pull request Dec 19, 2019

Motivations can be arrays IIIF/presentation-validator#85

Closed

saracarl added 2 commits January 17, 2020 10:06

made single motivations scalar

68829eb

explanation for commenting not supplementing

52c6cdf

saracarl added 4 commits July 24, 2020 11:14

Update index.md

43a91b2

Handle comment renumbering.

Remove reference to embedded annotations.

9983b3f

Delete manifest containing embedded annotations.

618b172

Merge branch 'master' into 0103-poetry

d6bde57

github-actions bot temporarily deployed to staging July 24, 2020 17:01 Inactive

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Recipe #103 -- Annotating a Poetry Reading #130

Recipe #103 -- Annotating a Poetry Reading #130

glenrobson commented Nov 20, 2019

glenrobson commented Nov 20, 2019

glenrobson commented Nov 20, 2019

azaroth42 commented Dec 18, 2019

glenrobson commented Dec 18, 2019

glenrobson Dec 19, 2019 •

edited

Loading

glenrobson Dec 19, 2019

saracarl Dec 19, 2019

glenrobson Dec 19, 2019

glenrobson Dec 19, 2019

saracarl Dec 19, 2019

glenrobson Dec 19, 2019

glenrobson Dec 19, 2019

glenrobson Dec 19, 2019

glenrobson Dec 19, 2019

glenrobson Dec 19, 2019

saracarl Dec 19, 2019

glenrobson Dec 19, 2019

glenrobson Dec 19, 2019

benwbrum commented Dec 19, 2019

azaroth42 commented Dec 19, 2019

benwbrum commented Dec 19, 2019 •

edited

Loading

glenrobson commented Dec 19, 2019

saracarl commented Dec 19, 2019

benwbrum commented Jan 24, 2020

glenrobson commented Apr 6, 2023

Recipe #103 -- Annotating a Poetry Reading #130

Are you sure you want to change the base?

Recipe #103 -- Annotating a Poetry Reading #130

Conversation

glenrobson commented Nov 20, 2019

glenrobson commented Nov 20, 2019

glenrobson commented Nov 20, 2019

azaroth42 commented Dec 18, 2019

glenrobson commented Dec 18, 2019

glenrobson Dec 19, 2019 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

benwbrum commented Dec 19, 2019

azaroth42 commented Dec 19, 2019

benwbrum commented Dec 19, 2019 • edited Loading

glenrobson commented Dec 19, 2019

saracarl commented Dec 19, 2019

benwbrum commented Jan 24, 2020

glenrobson commented Apr 6, 2023

glenrobson Dec 19, 2019 •

edited

Loading

benwbrum commented Dec 19, 2019 •

edited

Loading