From 9cce2f181290d65ab20d08d9ccb2ea76fff7940c Mon Sep 17 00:00:00 2001 From: giacomounivr Date: Fri, 29 Sep 2023 16:15:54 +0200 Subject: [PATCH] Add more detailed explanation and links --- _includes/links.md | 1 + index.md | 2 +- recipe/0022-linking-with-a-hotspot/index.md | 15 +++++++++++++-- recipe/0022-linking-with-a-hotspot/manifest.json | 2 +- 4 files changed, 16 insertions(+), 4 deletions(-) diff --git a/_includes/links.md b/_includes/links.md index e9ab0fa12..d1849b215 100644 --- a/_includes/links.md +++ b/_includes/links.md @@ -21,6 +21,7 @@ [0019]: {{ site.cookbook_url | absolute_url }}/recipe/0019-html-in-annotations/ "HTML in Annotations" [0021]: {{ site.cookbook_url | absolute_url }}/recipe/0021-tagging/ "Simple Annotation — Tagging" +[0022]: {{ site.cookbook_url | absolute_url }}/recipe/0022-linking-with-a-hotspot/ "Redirecting from one Canvas to another resource (Hotspot linking)" [0033]: {{site.baseurl}}/recipe/0033-choice/ "Multiple choice of images in a single view" [0035]: {{site.baseurl}}/recipe/0035-foldouts/ "Foldouts, Flaps, and Maps" diff --git a/index.md b/index.md index c93c7888f..aa145c4c1 100644 --- a/index.md +++ b/index.md @@ -84,7 +84,7 @@ _(leading on to segmentation examples later)_ * [Simple Annotation - Tagging][0021] * [Annotation with a Non-Rectangular Polygon][0261] * [Tagging with an External Resource][0258] -* hotspot linking +* [Redirecting from one Canvas to another resource (Hotspot linking)][0022] * [Annotate a specific images or layers][0326] * [Geographic coordinates][0139] * [Embedded or Referenced Annotations][0269] diff --git a/recipe/0022-linking-with-a-hotspot/index.md b/recipe/0022-linking-with-a-hotspot/index.md index bcc69aa02..2fd647e46 100644 --- a/recipe/0022-linking-with-a-hotspot/index.md +++ b/recipe/0022-linking-with-a-hotspot/index.md @@ -19,12 +19,23 @@ In an image showing multiple objects or parts, you want to see a detailed versio The create the annotation, we create an Annotation inside an AnnotationPage To select the area we want to link to a specific resource we set the target using the link of the Canvas and a fragment as in [Simple Annotation — Tagging][0021], however, in this case, the `motivation` of the annotation is `linking`. -The `body` contains a SpecificResource with `source` attribute set to the Canvas we want to link. + +In the case the link is between a region of a Canvas and another Canvas in a Manifest, the `body` contains a SpecificResource with `source` attribute set to the Canvas we want to link. The `partOf` attribute of the Canvas must point to the Manifest containing the Canvas and have the same `id`. -The element must be present even when the Canvas is part of the same Manifest, in this way when the manifest is consumed it is always possible to identify where the Canvas is contained. +The `partOf` attribute must be present even when the Canvas is part of the same Manifest, in this way when the manifest is consumed it is always possible to identify where the Canvas is contained. + +In the case the link is between a region of a Canvas and and an external resource it is recommended to add the correct type as indicated in the [Web Annotation Data Model](https://www.w3.org/TR/annotation-model/#h-accessibility-of-content), for instance: + +```json +{ + "id": "http://example.org/website1", + "type": "Text" + } +``` The implementer could consider adding also a Textual Body to the annotation to give more context to the end-user. + ## Restrictions None known. diff --git a/recipe/0022-linking-with-a-hotspot/manifest.json b/recipe/0022-linking-with-a-hotspot/manifest.json index 580c54e4f..0dd42d1de 100644 --- a/recipe/0022-linking-with-a-hotspot/manifest.json +++ b/recipe/0022-linking-with-a-hotspot/manifest.json @@ -55,7 +55,7 @@ "type": "TextualBody", "language": "de", "format": "text/plain", - "value": "Der Gänseliesel-Brunnen" + "value": "A link to a close up of Gänseliesel-Brunnen fountain." }, { "type": "SpecificResource",