Skip to content

Commit

Permalink
Took a try at incorporating editor comments πŸ†™πŸ“
Browse files Browse the repository at this point in the history
  • Loading branch information
triplingual committed Sep 20, 2023
1 parent 976af6e commit 70ea71d
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion recipe/0283-missing-image/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ You have a paged object, such as a printed book or early manuscript, that has an

This recipe attempts to address desires to have a good user experience for people interacting with IIIF resources presented sequentially but lacking one or more images. The recipe also contemplates software consumption of the same. None of the Manifest information described here is required by the [IIIF Presentation API][prezi3], but it may bring benefits to those accessing your work. Nothing in the IIIF Presentation API makes any provision for specifying how or even whether a Canvas replaces what is supposed to appear at that point of the page flow, as the API is agnostic both about your content and its semantics as well as any semantics of your Manifest's structure.

To maintain a sequence presentation of a paged object with missing images, we suggest adding a content-less Canvas with, at a bare minimum, the `ID`, `type`, `height`, `width`, and `items` properties. The first two are required by the API for any Canvas, the dimensions tell the viewer to maintain a viewing space of the appropriate size, and the final property ensures the widely used IIIF validator will pass the Manifest. (Some viewers cope well with such an empty `items` property but others do not, highlighting that this recipe and API conformance diverge.)
To maintain a sequence presentation of a paged object with missing images, we suggest adding a content-less Canvas with, at a bare minimum, the `id`, `type`, `height`, `width`, and `items` properties. The `items` property would be written as empty. The spec doesn’t require the presence of `items` but the IIIF-C validator will fail to validate a Canvas without `items` as it differentiates between Canvas references found in `range`s and Canvas references found not in Ranges by the presence of `items`.

Using an empty Canvas is a very lightweight and authentic way to show missing content. That is, having a content-free Canvas takes modest effort and can represent the lack of content in a real-world object or an error in creating a digital version. However, with only the bare minimum properties neither viewers, nor people interacting with the resources, nor code interacting with it have any indication of why the image is absent. Consequently, as shown in this recipe's Manifest, it's a good idea to make use of the `label` property to contain useful text.

Expand Down

0 comments on commit 70ea71d

Please sign in to comment.