翻译者：宋杰

原文链接：https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/

译文：

用例

你想在画布上标注一些文字，作为评论或标签。在此配方中，我们对整个画布进行注释，但如果您想针对画布的特定部分或区域进行注释，请参阅简单注释—标签或用非矩形多边形进行注释。

实现说明

画布的注释以注释页对象的形式存储在画布的注释属性中，其中包含符合 W3C 网络注释格式的注释对象列表。

注释页和注释可以嵌入到清单中（如下例），也可以通过提供包含注释页的外部文档的 URI 来引用（参见嵌入或引用注释）。

注释页对象必须具有 AnnotationPage 类型 type、包含唯一 URI（无需解析）的 id 属性和包含一个或多个注释的列表的 items 属性。

注释必须有Annotation类型 type，和一个包含评论或标签文本的body属性。主体本身可以是一个类型type为TextualBody的对象，它在值value属性中包含文本，并在格式属性中指定文本字符串的格式（例如text/plain），在语言属性中指定语言language（例如德语的de）。

注释必须有一个目标target属性，对于一个完整的Canvas注释来说，它只包含Canvas的URI，没有额外的片段或选择器。

注释应该有一个动机motivation属性，该属性可以包含不同的值，指定注释的目的。W3C网络注解规范有一个完整的动机列表。常用的值是评论commenting和标记tagging。在使用其他动机时要注意，IIIF查看器可能只显示具有某些动机的注释。

限制

对整个 Canvas 进行注释的语义，可以通过使用 Canvas URI 而不使用片段或选择器（如本例），或者使用选择 Canvas 全部区域的选择器来指定（参见 “简单注释 - 标记”，了解如何使用片段选择器的简单示例）。使用选择整个 Canvas 区域的选择器是一种更普遍的模式，可能会得到 IIIF 客户端的更好支持。

示例

这个例子包含一个嵌入的注释，其中包含文本 “Göttinger Marktplatz mit Gänseliesel Brunnen”，其动机是针对整个 Canvas 进行评论。注释是 Canvas 的注解属性中包含的注解页的单一内容。

JSON-LD | 在Mirador中查看

  1. {
  2.   "@context": "http://iiif.io/api/presentation/3/context.json",
  3.   "id": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/manifest.json",
  4.   "type": "Manifest",
  5.   "label": {
  6.     "en": [
  7.       "Picture of Göttingen taken during the 2019 IIIF Conference"
  8.     ]
  9.   },
  10.   "items": [
  11.     {
  12.       "id": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1",
  13.       "type": "Canvas",
  14.       "height": 3024,
  15.       "width": 4032,
  16.       "items": [
  17.         {
  18.           "id": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1/annopage-1",
  19.           "type": "AnnotationPage",
  20.           "items": [
  21.             {
  22.               "id": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1/annopage-1/anno-1",
  23.               "type": "Annotation",
  24.               "motivation": "painting",
  25.               "body": {
  26.                 "id": "https://iiif.io/api/image/3.0/example/reference/918ecd18c2592080851777620de9bcb5-gottingen/full/max/0/default.jpg",
  27.                 "type": "Image",
  28.                 "format": "image/jpeg",
  29.                 "height": 3024,
  30.                 "width": 4032,
  31.                 "service": [
  32.                   {
  33.                     "id": "https://iiif.io/api/image/3.0/example/reference/918ecd18c2592080851777620de9bcb5-gottingen",
  34.                     "profile": "level1",
  35.                     "type": "ImageService3"
  36.                   }
  37.                 ]
  38.               },
  39.               "target": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1"
  40.             }
  41.           ]
  42.         }
  43.       ],
  44.       "annotations": [
  45.         {
  46.           "id": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1/annopage-2",
  47.           "type": "AnnotationPage",
  48.           "items": [
  49.             {
  50.               "id": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1/annopage-2/anno-1",
  51.               "type": "Annotation",
  52.               "motivation": "commenting",
  53.               "body": {
  54.                 "type": "TextualBody",
  55.                 "language": "de",
  56.                 "format": "text/plain",
  57.                 "value": "Göttinger Marktplatz mit Gänseliesel Brunnen"
  58.               },
  59.               "target": "https://iiif.io/api/cookbook/recipe/0266-full-canvas-annotation/canvas-1"
  60.             }
  61.           ]
  62.         }
  63.       ]
  64.     }
  65.   ]
  66. }

相关专题

  • 简单注释—使用片段选择器为注释贴标签
  • 使用SVG选择器的注释的非矩形多边形的注释
  • 最简单的宣言—图像
  • 最简单的宣言—音频
  • 最简单的清单—视频
  • 嵌入或引用的注释