Added Theseus Viewer support

[glenrobson]

https://theseusviewer.org/

Bringing #501 into main repo so we get the preview.

[glenrobson]

• 🔗 0001 mvm-image
• 🔗 0002 mvm-audio
• 🔗 0003 mvm-video
• 🔗 0004 canvas-size
• 🔗 0005 image-service
• 🔗 0006 text-language
• 🔗 0007 string-formats
• 🔗 0008 rights
• 🔗 0009 book-1
• 🔗 0010 book-2-viewing-direction
• 🔗 0011 book-3-behavior
• 🔗 0013 placeholderCanvas
• 🔗 0014 accompanyingcanvas
• 🔗 0015 start
• 🔗 0017 transcription-av
• 🔗 0019 html-in-annotations
• 🔗 0021 tagging
• 🔗 0022 linking-with-a-hotspot - not supported
• 🔗 0024 book-4-toc
• 🔗 0026 toc-opera
• 🔗 0029 metadata-anywhere
• 🔗 0030 multi-volume
• 🔗 0031 bound-multivolume
• 🔗 0032 collection
• 🔗 0033 choice
• 🔗 0035 foldouts
• 🔗 0036 composition-from-multiple-images
• 🔗 0040 image-rotation-service
• 🔗 0046 rendering
• 🔗 0047 homepage
• 🔗 0053 Linking to Structured Metadata
• 🔗 0065 Table of Contents for Multiple A/V Files on Multiple Canvases
• 🔗 0117 Image Thumbnail for Manifest
• 🔗 0118 Displaying Multiple Values with Language Maps
• 🔗 0135 Annotating a specific point of an image
• 🔗 0139 Represent Canvas Fragment as a Geographic Area in a Web Mapping Client
• 🔗 0202 Load Manifest Beginning with a Specific Canvas
• 🔗 0219 Using Caption and Subtitle Files with Video Content
• 🔗 0230 Navigation by Chronology
• 🔗 0234 Acknowledge Content Contributors
• 🔗 0258 Tagging with an External Resource
• 🔗 0261 Annotation with a Non-Rectangular Polygon
• 🔗 0266 Simplest Annotation
• 🔗 0269 Embedded or referenced Annotations
• 🔗 0283 Missing Images in a Sequence
• 🔗 0299 Addressing a Spatial Region
• 🔗 0306 Linking external Annotations targeting a Canvas to a Manifest
• 🔗 0377 Image in Annotations
• 🔗 0434 Multiple Choice of Audio Formats in a Single View (Canvas)

[glenrobson]

Test in aviary: https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0065-opera-multiple-canvases/

[glenrobson]

We may need to remove the Label from the annotation as its confusing and doesn't add anything:

https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0135-annotating-point-in-canvas/

Currently viewer shows the label rather than the textual body but will show body once label has been removed.

[glenrobson]

Look at this recipe:

https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0139-geolocate-canvas-fragment/

maybe remove the annotation label but go over the text.

Viewer should show the property/@Label

[glenrobson]

Add a note:

https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0230-navdate/

to say having navDate in the manifest isn't as useful as having it in the collection for viewers.

[glenrobson]

Remove from first example:

https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0306-linking-annotations-to-manifests/

[glenrobson]

Add Newspaper

[stephenwf]

Propose to add - 0154 Locate a Manifest on a Web Map
https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0154-geo-extension/

https://theseusviewer.org/?iiif-content=https://iiif.io/api/cookbook/recipe/0154-geo-extension/manifest.json&collection=https://theseusviewer.org/cookbook-collection.json&panel=informationPanel

[stephenwf]

Propose to add - 0240 Locate multiple canvases on a Web Map
https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0240-navPlace-on-canvases/

https://theseusviewer.org/?iiif-content=https://iiif.io/api/cookbook/recipe/0240-navPlace-on-canvases/manifest.json&panel=navPlace

[stephenwf]

Propose to add 0074 Using Caption and Subtitle Files in Multiple Languages with Video Content
https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0074-multiple-language-captions/

https://theseusviewer.org/?iiif-content=https%3A%2F%2Fiiif.io%2Fapi%2Fcookbook%2Frecipe%2F0074-multiple-language-captions%2Fmanifest.json

[stephenwf]

Propose to add 0022 Linking with a hotspot
https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0022-linking-with-a-hotspot/

https://theseusviewer.org/?iiif-content=https%3A%2F%2Fpreview.iiif.io%2Fcookbook%2Ffeature%2Ftheseus-viewer%2Frecipe%2F0022-linking-with-a-hotspot%2Fmanifest.json&panel=annotations

[glenrobson]

Work to do to get this merged (to be confirmed in cookbook meeting):

Cookbook group review:

• 0154 Locate a Manifest on a Web Map
• 0240 Locate multiple canvases on a Web Map
• 0074 Using Caption and Subtitle Files in Multiple Languages with Video Content
• 0022 Linking with a hotspot
• OK to approve 🔗 0135 Annotating a specific point of an image and 🔗 0139 Represent Canvas Fragment as a Geographic Area in a Web Mapping Client as they do the same as other viewers and label issue tackled in Remove label from annotations #518?

Stephen:

• Remove thesus from the first example: https://preview.iiif.io/cookbook/feature/theseus-viewer/recipe/0306-linking-annotations-to-manifests/

[robcast]

just a note to remind me to tell stephen about UX inconsistency with 0154 (map in about pane) vs 0240 (map icon in left toolbar)...

[triplingual]

For Recipe 74 (#270), a person can change the caption language by changing the primary interface language in the "About this item" interface. However, the change only works for going from Italiano to English, not the reverse. Changing from Italiano to English also turns the CC off.

Steps to reproduce:

1. Load the recipe in Theseus
2. Press play
3. Turn on the closed captions (defaults to English)
4. Action the "About this item" link
5. Choose Italiano from the "Select an item" dropdown
6. Captions should stay on, and remain in English
7. From the gear icon in the AV player, select Captions and then "Sottotitoli in formato WebVTT"
8. Verify that the captions are in Italiano
9. Action the "About this item" link if necessary
10. Choose English from the "Select an item" dropdown
11. Captions should get turned off
12. Turn on captions
13. Captions should be in English

The behavior is slightly different when changing the order of the language selected:

1. Load the recipe in Theseus
2. Press play
3. Turn on the closed captions (defaults to English)
4. From the gear icon in the AV player, select Captions and then "Sottotitoli in formato WebVTT"
5. Verify that the captions are in Italiano
6. Action the "About this item" link
7. Choose English from the "Select an item" dropdown
8. Captions should stay on, and remain in Italian
9. From the gear icon in the AV player, select Captions and then "Captions in WebVTT format"
10. Verify that the captions are in English
11. Action the "About this item" link if necessary
12. Choose Italiano from the "Select an item" dropdown
13. Captions should get turned off
14. Turn on captions
15. Captions should be in English

There's probably a bigger matrix to make to consider other/all possible paths, but perhaps these will suffice for now.

[stephenwf]

@robcast

just a note to remind me to tell stephen about UX inconsistency with 0154 (map in about pane) vs 0240 (map icon in left toolbar)...

Yes! The Manifest map is quite underwhelming, not much room to explore, especially if its a full GeoJSON geometry. Have thought about trying to make it so that you can "expand" and view it on the main area, but not found a nice way to do that. (I'm imagining that there might be cases where both the Manifest and Canvases have GeoJSON attached).

@triplingual
The captions and handling the changing of language is tricky. I was able to reliably change the captions but it would pause the video. I think I need to maybe look into how to handle this more smoothly.

The main things I was aiming for:

• You can change the captions from the player using the cog icon
• You should see the captions that match your browser language by default

But there is definitely work to do on the switching. Happy to go and make some improvements on that and mark this as partial support for now?

[glenrobson]

I'm going to merge this in preperation for Trips recipe.