IIIF / cookbook-recipes

For working on the recipes
https://iiif.io/api/cookbook/index.html
37 stars 32 forks source link

ContentState: deep linking into a book #522

Open abrin opened 1 month ago

abrin commented 1 month ago

Recipe Name

ContentState: deep linking into a book

Use case

It would be useful to be able to share a link that not only takes someone to a page of a book, but also retains the range if one exists that was specified. This would be useful if a manuscript is broken into two ranges one for the entire manuscript, and one for the pages with illuminations. Thus a canvas exists in both ranges, but it might be preferable to send a user to a specific context.

As an aside, it would be nice to be also include the behavior for a manuscript e.g. facing or single page, but this is likely out of scope. Similarly, choice might be something that could be covered in content-state, but it will almost immediately run into an issue if there is more than one choice on a canvas because you cannot capture the combined state of all the choices. Not sure if that means we don't want to use that to capture the state, OR if instead, partial support is enough.

glenrobson commented 1 month ago

This would be a useful recipe but first we need to do a multiple range recipe and then build this one on top of it.