From f61ce0955cbfb9c4e38cfcb63067ce6468aae909 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 3 Mar 2020 13:38:00 -0500 Subject: [PATCH 01/32] =?UTF-8?q?Initial=20commit=20to=20version=20control?= =?UTF-8?q?=20=E2=9A=A1=EF=B8=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- recipe/0013-placeholderCanvas/manifest.json | 61 +++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 recipe/0013-placeholderCanvas/manifest.json diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json new file mode 100644 index 000000000..ef01f55d9 --- /dev/null +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -0,0 +1,61 @@ +{ + "@context": "http://iiif.io/api/presentation/3/context.json", + "id": "{{ id.url }}", + "type": "Manifest", + "label": { "en": [ "Audio Example 1" ] }, + "items": [ + { + "id": "{{ id.path }}/canvas/segment1", + "type": "Canvas", + "duration": 3600, + "placeholderCanvas": { + "id": "{{ id.path }}/canvas/segment1/placeholder", + "type": "Canvas", + "height": 1400, + "width": 1200, + "items": [ + { + "id": "{{ id.path }}/canvas/segment1/placeholder/page" + "type": "AnnotationPage", + "items": [ + { + "id": "{{ id.path }}/canvas/segment1/placeholder/image", + "type": "Annotation", + "motivation": "painting", + "body": { + "id": "[actual url to the image]", + // Possibly something at http://www.bl.uk/manuscripts/Viewer.aspx?ref=zweig_ms_49_f001r#dcId=1583259243655&p=1 + "type": "Image", + "format": "image/jpeg", + "height": 1359, + "width": 971 + }, + "target": "{{ id.path }}/canvas/segment1" + } + ] + } + ] + }, + "items": [ + { + "id": "{{ id.path }}/annotation/segment1/page", + "type": "AnnotationPage", + "items": [ + { + "id": "{{ id.path }}/annotation/segment1-audio", + "type": "Annotation", + "motivation": "painting", + "body": { + "id": "https://fixtures.iiif.io/audio/indiana/mahler-symphony-3/CD1/high/320Kbps.mp4", + "type": "Audio", + "format": "audio/mp4", + "duration": 1985.024 + }, + "target": "{{ id.path }}/canvas/segment1" + } + ] + } + ] + } + ] +} From 3249c654e1b5a101a2b70e3cfda43ec6cc948fa6 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 3 Mar 2020 13:39:16 -0500 Subject: [PATCH 02/32] Updated index doc to more recent template --- recipe/0013-placeholderCanvas/index.md | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 3685789df..e6dceb610 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -6,7 +6,6 @@ tags: [tbc] summary: "tbc" --- - ## Use Case Why is this pattern is important? @@ -23,15 +22,8 @@ When is this pattern is usable / not usable? Is it deprecated? If it uses multip Describe in prose and provide examples, e.g.: -``` json-doc -{ - "@context": [ - "http://www.w3.org/ns/anno.jsonld", - "http://iiif.io/api/presentation/{{ page.major }}/context.json" - ], - "id": "https://example.org/iiif/book1/manifest", - "type": "Manifest" -} +{: .line-numbers data-src="manifest.json" } +```json ``` # Related recipes From 7c05cd12183941e2427798069670fc832dc483b3 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 3 Mar 2020 16:33:13 -0500 Subject: [PATCH 03/32] Added this recipe to this branch's TOC --- _includes/links.md | 1 + recipe/index.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/_includes/links.md b/_includes/links.md index 1078e25b9..e799f747e 100644 --- a/_includes/links.md +++ b/_includes/links.md @@ -3,6 +3,7 @@ [0001]: {{site.baseurl}}/recipe/0001-mvm-image/ "Simplest Manifest - Image" [0002]: {{site.baseurl}}/recipe/0002-mvm-audio/ "Simplest Manifest - Audio" [0003]: {{site.baseurl}}/recipe/0003-mvm-video/ "Simplest Manifest - Video" +[0013]: {{site.baseurl}}/recipe/0003-mvm-video/ "Posters: placeholderCanvas" [prezi3]: https://iiif.io/api/presentation/3 "IIIF Presentation API" [prezi3-languages]: https://iiif.io/api/presentation/3.0/#language-of-property-values "Language of Property Values" \ No newline at end of file diff --git a/recipe/index.md b/recipe/index.md index 4256fbd91..61a4229c1 100644 --- a/recipe/index.md +++ b/recipe/index.md @@ -57,7 +57,7 @@ _The corresponding 2.1 test fixture(s) is given like this, where appropriate: .. * Book (viewingDirection variations) (11,12,13,14) * Book (paging variations) (15,16,17) * thumbnail algorithm / discussion -* placeholderCanvas +* [Posters: placeholderCanvas][0013] (n/a) (use resource as image before other resource loads) * accompanyingCanvas * start (65) From 27539bf8099ea3fb77f14034ab85216199e9a2e4 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 3 Mar 2020 16:34:56 -0500 Subject: [PATCH 04/32] Next pass of revisions --- recipe/0013-placeholderCanvas/manifest.json | 44 ++++++++++----------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index ef01f55d9..ce96a76b6 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -2,60 +2,60 @@ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "{{ id.url }}", "type": "Manifest", - "label": { "en": [ "Audio Example 1" ] }, + "label": { "en": [ "Placeholder Canvas Example 1" ] }, "items": [ { - "id": "{{ id.path }}/canvas/segment1", + "id": "{{ id.path }}/podcast1/canvas/segment1", "type": "Canvas", "duration": 3600, "placeholderCanvas": { - "id": "{{ id.path }}/canvas/segment1/placeholder", - "type": "Canvas", - "height": 1400, - "width": 1200, - "items": [ - { - "id": "{{ id.path }}/canvas/segment1/placeholder/page" + "id": "{{ id.path }}/podcast/canvas/segment1/placeholder", + "type": "Canvas", + "height": 3024, + "width": 4032, + "items": [ + { + "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/page", "type": "AnnotationPage", "items": [ { - "id": "{{ id.path }}/canvas/segment1/placeholder/image", + "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/image", "type": "Annotation", "motivation": "painting", "body": { - "id": "[actual url to the image]", - // Possibly something at http://www.bl.uk/manuscripts/Viewer.aspx?ref=zweig_ms_49_f001r#dcId=1583259243655&p=1 + "id": "https://fixtures.iiif.io/images/Glen/photos/gottingen.jpg", "type": "Image", "format": "image/jpeg", - "height": 1359, - "width": 971 + "height": 3024, + "width": 4032 }, "target": "{{ id.path }}/canvas/segment1" } ] - } - ] - }, + } + ] + }, "items": [ { - "id": "{{ id.path }}/annotation/segment1/page", + "id": "{{ id.path }}/podcast1/annotation/segment1/page", "type": "AnnotationPage", "items": [ { - "id": "{{ id.path }}/annotation/segment1-audio", + "id": "{{ id.path }}/podcast1/annotation/segment1-audio", "type": "Annotation", "motivation": "painting", "body": { "id": "https://fixtures.iiif.io/audio/indiana/mahler-symphony-3/CD1/high/320Kbps.mp4", - "type": "Audio", + "type": "Sound", "format": "audio/mp4", "duration": 1985.024 }, - "target": "{{ id.path }}/canvas/segment1" + "target": "{{ id.path }}/podcast1/canvas/segment1" } ] } ] } ] -} + } + From 50c00d6a5d57a3975f8a0991c32f490461d8ea44 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 1 Apr 2020 12:05:56 -0400 Subject: [PATCH 05/32] Corrected link for this recipe --- _includes/links.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/links.md b/_includes/links.md index e799f747e..259d98055 100644 --- a/_includes/links.md +++ b/_includes/links.md @@ -3,7 +3,7 @@ [0001]: {{site.baseurl}}/recipe/0001-mvm-image/ "Simplest Manifest - Image" [0002]: {{site.baseurl}}/recipe/0002-mvm-audio/ "Simplest Manifest - Audio" [0003]: {{site.baseurl}}/recipe/0003-mvm-video/ "Simplest Manifest - Video" -[0013]: {{site.baseurl}}/recipe/0003-mvm-video/ "Posters: placeholderCanvas" +[0013]: {{site.baseurl}}/recipe/0013-placeholderCanvas/ "Posters: placeholderCanvas" [prezi3]: https://iiif.io/api/presentation/3 "IIIF Presentation API" [prezi3-languages]: https://iiif.io/api/presentation/3.0/#language-of-property-values "Language of Property Values" \ No newline at end of file From bb54ae452fcb69e8e1d1610618bfa9e7496e543c Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Mon, 13 Apr 2020 16:59:29 -0400 Subject: [PATCH 06/32] Matched master branch --- Gemfile.lock | 34 ++++++++++++++++------------------ 1 file changed, 16 insertions(+), 18 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 32971bdd1..272f3aa71 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,20 +1,20 @@ GEM remote: https://rubygems.org/ specs: - addressable (2.5.2) - public_suffix (>= 2.0.2, < 4.0) + addressable (2.7.0) + public_suffix (>= 2.0.2, < 5.0) colorator (1.1.0) - concurrent-ruby (1.1.4) + concurrent-ruby (1.1.6) em-websocket (0.5.1) eventmachine (>= 0.12.9) http_parser.rb (~> 0.6.0) eventmachine (1.2.7) - ffi (1.9.25) + ffi (1.12.2) forwardable-extended (2.6.0) http_parser.rb (0.6.0) i18n (0.9.5) concurrent-ruby (~> 1.0) - jekyll (3.8.5) + jekyll (3.8.6) addressable (~> 2.4) colorator (~> 1.0) em-websocket (~> 0.5) @@ -29,26 +29,24 @@ GEM safe_yaml (~> 1.0) jekyll-sass-converter (1.5.2) sass (~> 3.4) - jekyll-watch (2.1.2) + jekyll-watch (2.2.1) listen (~> 3.0) kramdown (1.17.0) - liquid (4.0.1) - listen (3.1.5) - rb-fsevent (~> 0.9, >= 0.9.4) - rb-inotify (~> 0.9, >= 0.9.7) - ruby_dep (~> 1.2) + liquid (4.0.3) + listen (3.2.1) + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.3.6) pathutil (0.16.2) forwardable-extended (~> 2.6) - public_suffix (3.0.3) - rake (12.3.2) + public_suffix (4.0.3) + rake (13.0.1) rb-fsevent (0.10.3) - rb-inotify (0.10.0) + rb-inotify (0.10.1) ffi (~> 1.0) - rouge (3.1.1) - ruby_dep (1.5.0) - safe_yaml (1.0.4) - sass (3.7.2) + rouge (3.17.0) + safe_yaml (1.0.5) + sass (3.7.4) sass-listen (~> 4.0.0) sass-listen (4.0.0) rb-fsevent (~> 0.9, >= 0.9.4) From 315c71dde4e559781b91c308273fd29db9846a45 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Mon, 13 Apr 2020 17:00:32 -0400 Subject: [PATCH 07/32] Began refining --- recipe/0013-placeholderCanvas/index.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index e6dceb610..5f9c6fb3a 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -2,18 +2,25 @@ title: "Posters: placeholderCanvas" id: 13 layout: recipe -tags: [tbc] -summary: "tbc" +tags: video, audio, image, av +summary: "I wish to provide the user with something to look at before they choose to start interacting with the object, and/or while they wait for it to load/buffer." --- ## Use Case -Why is this pattern is important? +I wish to provide the user with something to look at before they choose to start interacting with the object, and/or while they wait for it to load/buffer. ## Implementation notes +For this value, it's particularly important to note the latitude given conforming clients. The spec only says that clients _may_ render the `placeholderCanvas` property, not _must_. + +Note also the differences between this property and the `accompanyingCanvas` property. This property provides content to render before the main content is rendered + How does one implement the pattern? +See also [https://github.com/IIIF/trc/issues/8](https://github.com/IIIF/trc/issues/8), [https://github.com/IIIF/api/issues/1605](https://github.com/IIIF/api/issues/1605) + + ## Restrictions When is this pattern is usable / not usable? Is it deprecated? If it uses multiple specifications, which versions are needed, etc.? (Not present if not needed.) @@ -22,7 +29,9 @@ When is this pattern is usable / not usable? Is it deprecated? If it uses multip Describe in prose and provide examples, e.g.: -{: .line-numbers data-src="manifest.json" } +[JSON-LD](manifest.json) | View in X | View in Y + +{: .line-numbers data-download-link data-download-link-label="Download me" data-src="manifest.json" } ```json ``` From 49391ee63ef205c92a6d3f8680b2bfec25d5b46e Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Mon, 13 Apr 2020 17:05:52 -0400 Subject: [PATCH 08/32] Improved formatting, refined content --- recipe/0013-placeholderCanvas/manifest.json | 57 ++++++++++----------- 1 file changed, 28 insertions(+), 29 deletions(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index ce96a76b6..f31ccc22f 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -7,33 +7,33 @@ { "id": "{{ id.path }}/podcast1/canvas/segment1", "type": "Canvas", - "duration": 3600, + "duration": 1985.024, "placeholderCanvas": { - "id": "{{ id.path }}/podcast/canvas/segment1/placeholder", - "type": "Canvas", - "height": 3024, - "width": 4032, - "items": [ - { - "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/page", - "type": "AnnotationPage", - "items": [ - { - "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/image", - "type": "Annotation", - "motivation": "painting", - "body": { - "id": "https://fixtures.iiif.io/images/Glen/photos/gottingen.jpg", - "type": "Image", - "format": "image/jpeg", - "height": 3024, - "width": 4032 - }, - "target": "{{ id.path }}/canvas/segment1" - } - ] - } - ] + "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder", + "type": "Canvas", + "height": 3024, + "width": 4032, + "items": [ + { + "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/page", + "type": "AnnotationPage", + "items": [ + { + "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/image", + "type": "Annotation", + "motivation": "painting", + "body": { + "id": "https://fixtures.iiif.io/images/Glen/photos/gottingen.jpg", + "type": "Image", + "format": "image/jpeg", + "height": 3024, + "width": 4032 + }, + "target": "{{ id.path }}/podcast1/canvas/segment1" + } + ] + } + ] }, "items": [ { @@ -55,7 +55,6 @@ ] } ] - } + } ] - } - +} \ No newline at end of file From ced102686ae98a0de33553841223589d11f771cd Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Fri, 22 May 2020 16:01:13 -0400 Subject: [PATCH 09/32] Improved Manifest label --- recipe/0013-placeholderCanvas/manifest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index f31ccc22f..5948348dd 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -2,7 +2,7 @@ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "{{ id.url }}", "type": "Manifest", - "label": { "en": [ "Placeholder Canvas Example 1" ] }, + "label": { "en": [ "Poster image displayed before interaction" ] }, "items": [ { "id": "{{ id.path }}/podcast1/canvas/segment1", From 24dd41985667a03f1639d1abc523a64f1f2eecbd Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 26 May 2020 15:04:57 -0400 Subject: [PATCH 10/32] Replaced unhelpful URI path nodes --- recipe/0013-placeholderCanvas/manifest.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index 5948348dd..02439e870 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -5,21 +5,21 @@ "label": { "en": [ "Poster image displayed before interaction" ] }, "items": [ { - "id": "{{ id.path }}/podcast1/canvas/segment1", + "id": "{{ id.path }}/canvas/segment1", "type": "Canvas", "duration": 1985.024, "placeholderCanvas": { - "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder", + "id": "{{ id.path }}/canvas/segment1/placeholder", "type": "Canvas", "height": 3024, "width": 4032, "items": [ { - "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/page", + "id": "{{ id.path }}/canvas/segment1/placeholder/page", "type": "AnnotationPage", "items": [ { - "id": "{{ id.path }}/podcast1/canvas/segment1/placeholder/image", + "id": "{{ id.path }}/canvas/segment1/placeholder/image", "type": "Annotation", "motivation": "painting", "body": { @@ -29,7 +29,7 @@ "height": 3024, "width": 4032 }, - "target": "{{ id.path }}/podcast1/canvas/segment1" + "target": "{{ id.path }}/canvas/segment1" } ] } @@ -37,11 +37,11 @@ }, "items": [ { - "id": "{{ id.path }}/podcast1/annotation/segment1/page", + "id": "{{ id.path }}/annotation/segment1/page", "type": "AnnotationPage", "items": [ { - "id": "{{ id.path }}/podcast1/annotation/segment1-audio", + "id": "{{ id.path }}/annotation/segment1-audio", "type": "Annotation", "motivation": "painting", "body": { @@ -50,7 +50,7 @@ "format": "audio/mp4", "duration": 1985.024 }, - "target": "{{ id.path }}/podcast1/canvas/segment1" + "target": "{{ id.path }}/canvas/segment1" } ] } From 0147aab52f9965ca847ab7cc957eec98153d1834 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Fri, 29 May 2020 16:53:41 -0400 Subject: [PATCH 11/32] Replaced content, made IDs more semantic --- recipe/0013-placeholderCanvas/manifest.json | 42 +++++++++++---------- 1 file changed, 23 insertions(+), 19 deletions(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index 02439e870..f99153750 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -5,31 +5,33 @@ "label": { "en": [ "Poster image displayed before interaction" ] }, "items": [ { - "id": "{{ id.path }}/canvas/segment1", + "id": "{{ id.path }}/canvas/donizetti", "type": "Canvas", - "duration": 1985.024, + "duration": 7278.466, + "width": 640, + "height": 360, "placeholderCanvas": { - "id": "{{ id.path }}/canvas/segment1/placeholder", + "id": "{{ id.path }}/canvas/donizetti/placeholder", "type": "Canvas", - "height": 3024, - "width": 4032, + "width": 640, + "height": 360, "items": [ { - "id": "{{ id.path }}/canvas/segment1/placeholder/page", + "id": "{{ id.path }}/canvas/donizetti/placeholder/1", "type": "AnnotationPage", "items": [ { - "id": "{{ id.path }}/canvas/segment1/placeholder/image", + "id": "{{ id.path }}/canvas/donizetti/placeholder/1-image", "type": "Annotation", "motivation": "painting", "body": { - "id": "https://fixtures.iiif.io/images/Glen/photos/gottingen.jpg", + "id": "https://fixtures.iiif.io/video/indiana/donizetti-elixir/act1-thumbnail.png", "type": "Image", - "format": "image/jpeg", - "height": 3024, - "width": 4032 + "format": "image/png", + "width": 640, + "height": 360 }, - "target": "{{ id.path }}/canvas/segment1" + "target": "{{ id.path }}/canvas/donizetti/placeholder" } ] } @@ -37,20 +39,22 @@ }, "items": [ { - "id": "{{ id.path }}/annotation/segment1/page", + "id": "{{ id.path }}/donizetti/1", "type": "AnnotationPage", "items": [ { - "id": "{{ id.path }}/annotation/segment1-audio", + "id": "{{ id.path }}/donizetti/1-video", "type": "Annotation", "motivation": "painting", "body": { - "id": "https://fixtures.iiif.io/audio/indiana/mahler-symphony-3/CD1/high/320Kbps.mp4", - "type": "Sound", - "format": "audio/mp4", - "duration": 1985.024 + "id": "https://fixtures.iiif.io/video/indiana/donizetti-elixir/vae0637_accessH264_low.mp4", + "type": "Video", + "duration": 7278.466, + "width": 640, + "height": 360, + "format": "video/mp4" }, - "target": "{{ id.path }}/canvas/segment1" + "target": "{{ id.path }}/canvas/donizetti" } ] } From a630d58e26ca180aac24041b3eb283cb7d65dbc9 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 3 Jun 2020 12:30:21 -0400 Subject: [PATCH 12/32] Edited for readability and precision --- recipe/0013-placeholderCanvas/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 379fd2e30..3fdf235fb 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -3,7 +3,7 @@ title: "Posters: placeholderCanvas" id: 13 layout: recipe tags: video, audio, image, av -summary: "Provide the user with something to look at before they choose to start interacting with the object, and/or while they wait for it to load/buffer." +summary: "Provide the user with something to look at before they choose to start interacting with the main content, and/or while they wait for it to load/buffer, and/or while interacting with the main content." --- ## Use Case @@ -12,9 +12,9 @@ Provide the user with something to look at before they choose to start interacti ## Implementation notes -For this value, it's particularly important to note the latitude given conforming clients. The spec only says that clients _may_ render the `placeholderCanvas` property, not _must_. +For this property, it's particularly important to note the latitude given conforming clients. The IIIF Presentation API 3.0 only says that clients _may_ render the `placeholderCanvas` property, not _must_. -Note also the differences between this property and the `accompanyingCanvas` property. Only this property is used to load content before the main content is loaded. Either `placeholderCanvas` or `accompanyingCanvas` can be used for content while the user is interacting with the main content, with slightly different semantics. `placeholderCanvas` and `accompanyingCanvas` are each appropriate for indicating an image to be shown while the main audio content is playing. `accompanyingCanvas` is more appropriate to use for audio to play while a user is interacting with a visual object. +Note also the differences between this property and the `accompanyingCanvas` property. Only this property is used to load content before the main content is loaded. Either `placeholderCanvas` or `accompanyingCanvas` can be used for content while the user is interacting with the main content, with slightly different semantics. `placeholderCanvas` and `accompanyingCanvas` are each appropriate for describing an image to be shown while the main audio content is playing. `accompanyingCanvas` is more appropriate to use for audio to play while a user is interacting with a visual object. ## Restrictions @@ -22,7 +22,7 @@ None known. ## Example -Describe in prose and provide examples, e.g.: +**[FPO content]** In the example, the main content is a video and the `placeholderCanvas` is a promotional artwork for the video. {% include manifest_links.html viewers="UV" manifest="manifest.json" %} From df75207ba393ca9f06dad9dfddd8f1f23da89d5b Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Thu, 4 Jun 2020 09:54:36 -0400 Subject: [PATCH 13/32] Dummy commit to test include behavior --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 3fdf235fb..40015fa49 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -24,7 +24,7 @@ None known. **[FPO content]** In the example, the main content is a video and the `placeholderCanvas` is a promotional artwork for the video. -{% include manifest_links.html viewers="UV" manifest="manifest.json" %} +{% include manifest_links.html viewers="UV,Mirador" manifest="manifest.json" %} {% include jsonviewer.html src="manifest.json" config="data-line='15-46'"%} From 8b45f3ffaa15c232bbdb7bf0caf07cc38c011b13 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 7 Jul 2020 10:15:37 -0400 Subject: [PATCH 14/32] Added recipe link to main page --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 9ae45d53a..b92de67d2 100644 --- a/index.md +++ b/index.md @@ -36,7 +36,7 @@ _The corresponding 2.1 test fixture(s) is given like this, where appropriate: .. * Book (viewingDirection variations) (11,12,13,14) * Book (paging variations) (15,16,17) * thumbnail algorithm / discussion -* placeholderCanvas +* [Posters: placeholderCanvas][0013] * accompanyingCanvas * start (65) From a02311267158879a92ea167ab7ff7519f9edd458 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 7 Jul 2020 10:16:26 -0400 Subject: [PATCH 15/32] Fixed omission of recipe number in Related Recipes --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 40015fa49..6e8fff123 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -30,7 +30,7 @@ None known. # Related recipes -* [Additional optional accompanying content] describes how to use `accompanyingCanvas`, a similar property to this one. +* [Additional optional accompanying content][0014] describes how to use `accompanyingCanvas`, a similar property to this one. {% include acronyms.md %} {% include links.md %} From c1d092669c4aa17a5d2566c887f6158d335ab2a4 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 7 Jul 2020 10:19:45 -0400 Subject: [PATCH 16/32] Rewrote text introducing example Manifest --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 6e8fff123..18e5019ca 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -22,7 +22,7 @@ None known. ## Example -**[FPO content]** In the example, the main content is a video and the `placeholderCanvas` is a promotional artwork for the video. +In the example, the main content is a video of Donizetti's "L'elisir d'amore" and the `placeholderCanvas` is a stillframe from the video, useful if the video itself is taking a long time to load for the site visitor. {% include manifest_links.html viewers="UV,Mirador" manifest="manifest.json" %} From d00754fb26a1c5f0ca43f63afb2dafd486ba1820 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 7 Jul 2020 15:55:04 -0400 Subject: [PATCH 17/32] =?UTF-8?q?Added=20summary=20for=20accessibility=20?= =?UTF-8?q?=E2=99=BF=EF=B8=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- recipe/0013-placeholderCanvas/manifest.json | 2 ++ 1 file changed, 2 insertions(+) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index f99153750..b2a395de5 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -10,11 +10,13 @@ "duration": 7278.466, "width": 640, "height": 360, + "summary": "Video recording of Act 1 of a performance of Donizetti's L'elisir d'amore", "placeholderCanvas": { "id": "{{ id.path }}/canvas/donizetti/placeholder", "type": "Canvas", "width": 640, "height": 360, + "summary": "Still image from Act 1 of a performance of Donizetti's L'elisir d'amore, which should be playable shortly", "items": [ { "id": "{{ id.path }}/canvas/donizetti/placeholder/1", From c41b21d82bd5566da0cfd9b1fce43dc9cf519f30 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 7 Jul 2020 15:56:58 -0400 Subject: [PATCH 18/32] Major rewrite for readability and content --- recipe/0013-placeholderCanvas/index.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 18e5019ca..43c87be0f 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -3,34 +3,34 @@ title: "Posters: placeholderCanvas" id: 13 layout: recipe tags: video, audio, image, av -summary: "Provide the user with something to look at before they choose to start interacting with the main content, and/or while they wait for it to load/buffer, and/or while interacting with the main content." +summary: "Provide the user with something to look at before they choose to start interacting with the main content, and/or while they wait for it to load/buffer." --- ## Use Case -Provide the user with something to look at before they choose to start interacting with the main content, and/or while they wait for it to load/buffer, and/or while interacting with the main content. +You have a long video to present to site visitors. As each visitor's connection reliability and bandwidth are unknown and unpredictable, you want to show them a more lightweight resource (which will load more quickly) until the video has finished loading or has sufficiently buffered. ## Implementation notes -For this property, it's particularly important to note the latitude given conforming clients. The IIIF Presentation API 3.0 only says that clients _may_ render the `placeholderCanvas` property, not _must_. +Across a Manifest and its properties, you may use more than one `placeholderCanvas`, allowing you to have an authentic `placeholderCanvas` for each appropriate resource (Collection, Manifest, Canvas, and Range). -Note also the differences between this property and the `accompanyingCanvas` property. Only this property is used to load content before the main content is loaded. Either `placeholderCanvas` or `accompanyingCanvas` can be used for content while the user is interacting with the main content, with slightly different semantics. `placeholderCanvas` and `accompanyingCanvas` are each appropriate for describing an image to be shown while the main audio content is playing. `accompanyingCanvas` is more appropriate to use for audio to play while a user is interacting with a visual object. +Always keep in mind the wide latitude given conforming clients: It is up to the client whether and in what sort of UI to display content you place in a `placeholderCanvas` property. Don't use this property for content that must be displayed. On the other hand, placing content in a `placeholderCanvas` does tell a client that the content, if displayed, should be displayed before the resource to which it is attached. ## Restrictions -None known. +Each instance of `placeholderCanvas` may only contain one Canvas, and as such may specifically not contain an additional `placeholderCanvas` or an `accopanyingCanvas`. ## Example -In the example, the main content is a video of Donizetti's "L'elisir d'amore" and the `placeholderCanvas` is a stillframe from the video, useful if the video itself is taking a long time to load for the site visitor. +In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, it could be helpful to show them the still frame as an implicit notice that the video is downloading. {% include manifest_links.html viewers="UV,Mirador" manifest="manifest.json" %} -{% include jsonviewer.html src="manifest.json" config="data-line='15-46'"%} +{% include jsonviewer.html src="manifest.json" config="data-line='18-45'"%} # Related recipes -* [Additional optional accompanying content][0014] describes how to use `accompanyingCanvas`, a similar property to this one. +* [Additional optional accompanying content][0014], for using `accompanyingCanvas` to present content simultaneously with another resource. {% include acronyms.md %} {% include links.md %} From fb3857ce6b0eb47e66aa337fed6814b573d9429b Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 8 Jul 2020 08:58:57 -0400 Subject: [PATCH 19/32] Fixed value to be a proper JSON object --- recipe/0013-placeholderCanvas/manifest.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index b2a395de5..45d2d0097 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -10,13 +10,13 @@ "duration": 7278.466, "width": 640, "height": 360, - "summary": "Video recording of Act 1 of a performance of Donizetti's L'elisir d'amore", + "summary": {"en": ["Video recording of Act 1 of a performance of Donizetti's L'elisir d'amore"]}, "placeholderCanvas": { "id": "{{ id.path }}/canvas/donizetti/placeholder", "type": "Canvas", "width": 640, "height": 360, - "summary": "Still image from Act 1 of a performance of Donizetti's L'elisir d'amore, which should be playable shortly", + "summary": {"en": ["Still image from Act 1 of a performance of Donizetti's L'elisir d'amore, which should be playable shortly"]}, "items": [ { "id": "{{ id.path }}/canvas/donizetti/placeholder/1", From f90383367eb26442ad9c13e653b34795449316b7 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 8 Jul 2020 09:06:03 -0400 Subject: [PATCH 20/32] Fixed misspelling --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 43c87be0f..1ad73b662 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -18,7 +18,7 @@ Always keep in mind the wide latitude given conforming clients: It is up to the ## Restrictions -Each instance of `placeholderCanvas` may only contain one Canvas, and as such may specifically not contain an additional `placeholderCanvas` or an `accopanyingCanvas`. +Each instance of `placeholderCanvas` may only contain one Canvas, and as such may specifically not contain an additional `placeholderCanvas` or an `accompanyingCanvas`. ## Example From 7e0ce985e54e64badc443b3a20e805441db3d031 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 8 Jul 2020 09:09:02 -0400 Subject: [PATCH 21/32] Adjusted line highlighting --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 1ad73b662..719b695aa 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -26,7 +26,7 @@ In the example, the main content is a video of a performance of Donizetti's _L'e {% include manifest_links.html viewers="UV,Mirador" manifest="manifest.json" %} -{% include jsonviewer.html src="manifest.json" config="data-line='18-45'"%} +{% include jsonviewer.html src="manifest.json" config="data-line='22-53'"%} # Related recipes From a72077c68c1a93d8fd5dbd75a46572aa88b051c9 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 8 Jul 2020 09:19:02 -0400 Subject: [PATCH 22/32] Removed Mirador No support for A/V in Mirador --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 719b695aa..16c5f2752 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -24,7 +24,7 @@ Each instance of `placeholderCanvas` may only contain one Canvas, and as such ma In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, it could be helpful to show them the still frame as an implicit notice that the video is downloading. -{% include manifest_links.html viewers="UV,Mirador" manifest="manifest.json" %} +{% include manifest_links.html viewers="UV" manifest="manifest.json" %} {% include jsonviewer.html src="manifest.json" config="data-line='22-53'"%} From 2ed6e854883bc00168b35fda4aeb8d6643802f37 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Fri, 17 Jul 2020 09:31:36 -0400 Subject: [PATCH 23/32] Edited text, added related recipe --- recipe/0013-placeholderCanvas/index.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 16c5f2752..40cf71f1f 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -8,13 +8,13 @@ summary: "Provide the user with something to look at before they choose to start ## Use Case -You have a long video to present to site visitors. As each visitor's connection reliability and bandwidth are unknown and unpredictable, you want to show them a more lightweight resource (which will load more quickly) until the video has finished loading or has sufficiently buffered. +You have an exceptionally large resource to present to site visitors. As each visitor's connection reliability and bandwidth are unknown and unpredictable, you want to show them a more lightweight resource (which will load more quickly) until the main resource has finished loading or has sufficiently buffered. ## Implementation notes -Across a Manifest and its properties, you may use more than one `placeholderCanvas`, allowing you to have an authentic `placeholderCanvas` for each appropriate resource (Collection, Manifest, Canvas, and Range). +Across a Manifest and its resources, you may use more than one `placeholderCanvas`, allowing you to have an authentic `placeholderCanvas` for each appropriate resource (Collection, Manifest, Canvas, and Range). -Always keep in mind the wide latitude given conforming clients: It is up to the client whether and in what sort of UI to display content you place in a `placeholderCanvas` property. Don't use this property for content that must be displayed. On the other hand, placing content in a `placeholderCanvas` does tell a client that the content, if displayed, should be displayed before the resource to which it is attached. +Always keep in mind the wide latitude given conforming clients: It is up to the client whether and in what sort of UI to display content you place in a `placeholderCanvas` property. Don't use this property for content that must be displayed. On the other hand, placing content in a `placeholderCanvas` does communicate to a conforming client that the content, if displayed, should be displayed before the resource to which it is attached. ## Restrictions @@ -22,7 +22,7 @@ Each instance of `placeholderCanvas` may only contain one Canvas, and as such ma ## Example -In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, it could be helpful to show them the still frame as an implicit notice that the video is downloading. +In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, showing the still frame allows them to get an advance look at performance aspects such as costuming, staging, and set design. {% include manifest_links.html viewers="UV" manifest="manifest.json" %} @@ -30,6 +30,7 @@ In the example, the main content is a video of a performance of Donizetti's _L'e # Related recipes +* [Simplest Manifest - Video][0003] * [Additional optional accompanying content][0014], for using `accompanyingCanvas` to present content simultaneously with another resource. {% include acronyms.md %} From abecabde0315d77da56b5c89ef6f9388ed0f0506 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Fri, 17 Jul 2020 09:53:17 -0400 Subject: [PATCH 24/32] Added disclaimer about lack of property support --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 40cf71f1f..17403b53b 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -22,7 +22,7 @@ Each instance of `placeholderCanvas` may only contain one Canvas, and as such ma ## Example -In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, showing the still frame allows them to get an advance look at performance aspects such as costuming, staging, and set design. +In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, showing the still frame allows them to get an advance look at performance aspects such as costuming, staging, and set design. _Note: The `placeholderCanvas` property for time-based objects is not yet supported in viewers._ {% include manifest_links.html viewers="UV" manifest="manifest.json" %} From 281819080ef25529c7b571358301e83e12c46cc4 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Fri, 24 Jul 2020 11:56:03 -0400 Subject: [PATCH 25/32] Separated support note, cleaned related recipe entry --- recipe/0013-placeholderCanvas/index.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 17403b53b..840bacd98 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -22,7 +22,9 @@ Each instance of `placeholderCanvas` may only contain one Canvas, and as such ma ## Example -In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, showing the still frame allows them to get an advance look at performance aspects such as costuming, staging, and set design. _Note: The `placeholderCanvas` property for time-based objects is not yet supported in viewers._ +In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, showing the still frame allows them to get an advance look at performance aspects such as costuming, staging, and set design. + +_Note: The `placeholderCanvas` property for time-based objects is not yet supported in viewers._ {% include manifest_links.html viewers="UV" manifest="manifest.json" %} @@ -31,7 +33,7 @@ In the example, the main content is a video of a performance of Donizetti's _L'e # Related recipes * [Simplest Manifest - Video][0003] -* [Additional optional accompanying content][0014], for using `accompanyingCanvas` to present content simultaneously with another resource. +* [Posters: placeholderCanvas][0014], for presenting content simultaneously with another resource. {% include acronyms.md %} {% include links.md %} From bdbe780936b2091ff3c0818109a450b4de0ad0f9 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Mon, 27 Jul 2020 09:49:10 -0400 Subject: [PATCH 26/32] Stripped superfluous summaries --- recipe/0013-placeholderCanvas/manifest.json | 3 --- 1 file changed, 3 deletions(-) diff --git a/recipe/0013-placeholderCanvas/manifest.json b/recipe/0013-placeholderCanvas/manifest.json index 45d2d0097..5d3bbd14d 100644 --- a/recipe/0013-placeholderCanvas/manifest.json +++ b/recipe/0013-placeholderCanvas/manifest.json @@ -2,7 +2,6 @@ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "{{ id.url }}", "type": "Manifest", - "label": { "en": [ "Poster image displayed before interaction" ] }, "items": [ { "id": "{{ id.path }}/canvas/donizetti", @@ -10,13 +9,11 @@ "duration": 7278.466, "width": 640, "height": 360, - "summary": {"en": ["Video recording of Act 1 of a performance of Donizetti's L'elisir d'amore"]}, "placeholderCanvas": { "id": "{{ id.path }}/canvas/donizetti/placeholder", "type": "Canvas", "width": 640, "height": 360, - "summary": {"en": ["Still image from Act 1 of a performance of Donizetti's L'elisir d'amore, which should be playable shortly"]}, "items": [ { "id": "{{ id.path }}/canvas/donizetti/placeholder/1", From f2edb49083683a44fb40657032b0081ca13897ff Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Mon, 27 Jul 2020 09:51:47 -0400 Subject: [PATCH 27/32] Adjusted title per #cookbook convo; stripped viewer --- recipe/0013-placeholderCanvas/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 840bacd98..7736918d9 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -1,5 +1,5 @@ --- -title: "Posters: placeholderCanvas" +title: "Load a Preview Image Before the Main Content" id: 13 layout: recipe tags: video, audio, image, av @@ -26,7 +26,7 @@ In the example, the main content is a video of a performance of Donizetti's _L'e _Note: The `placeholderCanvas` property for time-based objects is not yet supported in viewers._ -{% include manifest_links.html viewers="UV" manifest="manifest.json" %} +{% include manifest_links.html viewers="" manifest="manifest.json" %} {% include jsonviewer.html src="manifest.json" config="data-line='22-53'"%} From 682452d12f9e103ea383500a0c325ab963832135 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Mon, 27 Jul 2020 09:55:51 -0400 Subject: [PATCH 28/32] Updated link titles to reflect recipe updates --- _includes/links.md | 2 +- recipe/0013-placeholderCanvas/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_includes/links.md b/_includes/links.md index 0c9e15e60..33cb56945 100644 --- a/_includes/links.md +++ b/_includes/links.md @@ -3,7 +3,7 @@ [0001]: {{site.baseurl}}/recipe/0001-mvm-image/ "Simplest Manifest - Image" [0002]: {{site.baseurl}}/recipe/0002-mvm-audio/ "Simplest Manifest - Audio" [0003]: {{site.baseurl}}/recipe/0003-mvm-video/ "Simplest Manifest - Video" -[0013]: {{site.baseurl}}/recipe/0013-placeholderCanvas/ "Posters: placeholderCanvas" +[0013]: {{site.baseurl}}/recipe/0013-placeholderCanvas/ "Load a Preview Image Before the Main Content" [0068]: {{site.baseurl}}/recipe/0068-newspaper/ "A newspaper" diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 7736918d9..a15a9f825 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -33,7 +33,7 @@ _Note: The `placeholderCanvas` property for time-based objects is not yet suppor # Related recipes * [Simplest Manifest - Video][0003] -* [Posters: placeholderCanvas][0014], for presenting content simultaneously with another resource. +* [Audio Presentation with Accompanying Image][0014], using `accompanyingCanvas` to present one resource simultaneously with another. {% include acronyms.md %} {% include links.md %} From 35d80c48c8c3eddbc1c61d3ac12fc54bab035a13 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Tue, 28 Jul 2020 16:15:25 -0400 Subject: [PATCH 29/32] Changed copy per cookbook editor review comments Comments noted by @glenrobson in https://github.com/IIIF/cookbook-recipes/pull/151#issuecomment-665050554 --- recipe/0013-placeholderCanvas/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index a15a9f825..fead59151 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -8,13 +8,13 @@ summary: "Provide the user with something to look at before they choose to start ## Use Case -You have an exceptionally large resource to present to site visitors. As each visitor's connection reliability and bandwidth are unknown and unpredictable, you want to show them a more lightweight resource (which will load more quickly) until the main resource has finished loading or has sufficiently buffered. +You have an exceptionally large video to present to site visitors. As each visitor's connection reliability and bandwidth are unknown and unpredictable, you want to show them a still image preview of the video (which will load more quickly) until the video has finished loading or has sufficiently buffered. ## Implementation notes Across a Manifest and its resources, you may use more than one `placeholderCanvas`, allowing you to have an authentic `placeholderCanvas` for each appropriate resource (Collection, Manifest, Canvas, and Range). -Always keep in mind the wide latitude given conforming clients: It is up to the client whether and in what sort of UI to display content you place in a `placeholderCanvas` property. Don't use this property for content that must be displayed. On the other hand, placing content in a `placeholderCanvas` does communicate to a conforming client that the content, if displayed, should be displayed before the resource to which it is attached. +Always keep in mind the wide latitude given conforming clients: It is up to the client whether and in what sort of UI to display content you place in a `placeholderCanvas` property. Do not use this property for content that must be displayed. On the other hand, placing content in a `placeholderCanvas` does communicate to a conforming client that the content, if displayed, should be displayed before the resource to which it is attached. ## Restrictions @@ -24,7 +24,7 @@ Each instance of `placeholderCanvas` may only contain one Canvas, and as such ma In the example, the main content is a video of a performance of Donizetti's _L'elisir d'amore_ and the `placeholderCanvas` is a still frame from the video. For a site visitor with limited bandwidth, showing the still frame allows them to get an advance look at performance aspects such as costuming, staging, and set design. -_Note: The `placeholderCanvas` property for time-based objects is not yet supported in viewers._ +_Note: The `placeholderCanvas` property is not yet supported in viewers._ {% include manifest_links.html viewers="" manifest="manifest.json" %} From 642b4668ebbdd7c6b673f4f04883376136c33e92 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 5 Aug 2020 10:58:58 -0400 Subject: [PATCH 30/32] Conforming title text to recipe title --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index b92de67d2..7c6f2c8b8 100644 --- a/index.md +++ b/index.md @@ -36,7 +36,7 @@ _The corresponding 2.1 test fixture(s) is given like this, where appropriate: .. * Book (viewingDirection variations) (11,12,13,14) * Book (paging variations) (15,16,17) * thumbnail algorithm / discussion -* [Posters: placeholderCanvas][0013] +* [Load a Preview Image Before the Main Content][0013] * accompanyingCanvas * start (65) From 4a3007188de3f965a453a287e5096dc98cd91c08 Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 5 Aug 2020 10:59:52 -0400 Subject: [PATCH 31/32] Fixed line highlighting --- recipe/0013-placeholderCanvas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index fead59151..98733e121 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -28,7 +28,7 @@ _Note: The `placeholderCanvas` property is not yet supported in viewers._ {% include manifest_links.html viewers="" manifest="manifest.json" %} -{% include jsonviewer.html src="manifest.json" config="data-line='22-53'"%} +{% include jsonviewer.html src="manifest.json" config="data-line='12-38'"%} # Related recipes From 084bbb4840bb8cf5fd6c8b6431200c5a68a9655e Mon Sep 17 00:00:00 2001 From: Trip Kirkpatrick Date: Wed, 5 Aug 2020 11:27:28 -0400 Subject: [PATCH 32/32] Added note about target of germane annotation --- recipe/0013-placeholderCanvas/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/recipe/0013-placeholderCanvas/index.md b/recipe/0013-placeholderCanvas/index.md index 98733e121..e6fa9eea4 100644 --- a/recipe/0013-placeholderCanvas/index.md +++ b/recipe/0013-placeholderCanvas/index.md @@ -12,7 +12,9 @@ You have an exceptionally large video to present to site visitors. As each visit ## Implementation notes -Across a Manifest and its resources, you may use more than one `placeholderCanvas`, allowing you to have an authentic `placeholderCanvas` for each appropriate resource (Collection, Manifest, Canvas, and Range). +Across a Manifest and its resources, you may use more than one `placeholderCanvas`, allowing you to have an authentic `placeholderCanvas` for each appropriate resource (Collection, Manifest, Canvas, and Range). + +The target of the Annotation of a `placeholderCanvas` should have as its value the id of the `placeholderCanvas`, not the id of the resource that has the `placeholderCanvas`. Always keep in mind the wide latitude given conforming clients: It is up to the client whether and in what sort of UI to display content you place in a `placeholderCanvas` property. Do not use this property for content that must be displayed. On the other hand, placing content in a `placeholderCanvas` does communicate to a conforming client that the content, if displayed, should be displayed before the resource to which it is attached.