翻译：羊牧东岭
原文地址：https://iiif.io/api/cookbook/recipe/0053-seeAlso/

用例

你有一个 IIIF 清单资源以及附带的机器可读的元数据，可以通过 seeAlso 属性，供聚合程序或其它处理、索引程序使用。您从以前的经验中知道，当传递结构化的元数据时，聚合程序能以最好的收效来抓取您的收藏，继而为读者提供面向特定领域而分析的能力，使您的资源更易于被精准搜索。通过使用该 seeAlso 属性，您可以向聚合程序提醒数据集的存在，以便聚合程序向用户提供有关您的资源的适当且复杂的信息。

实施说明

此属性用于将查看器指向非 IIIF 的外部资源的 URI，其中包含有关当前 IIIF 资源的信息。最常见的情况是，这样的非 IIIF 资源是结构化的元数据。为了更有效率，该资源应该是机器可读的格式，例如 XML、JSON 或 RDF。 seeAlso 的 type 值通常是 dataset 。

其他三个属性可能看起来相似，因此这里强调一下其间差异。

  • homepage （IIIF展示API参考）
    如果 rendering 呈现的是相同资源的另一种展示，则 homepage 指向关于该资源所表示的对象的网页。
  • accompanyingCanvas （IIIF展示API参考）
    accompanyingCanvas 指向的资源是与主体资源同时展现的IIIF资源，而 rendering 中的一个目标资源不兼容IIIF，且必须在主资源的查看器之外查看。此外，accompanyingCanvas 用于补充主要资源的内容，而 rendering 指向同一资源的另外的展现。
  • rendering （IIIF展示API参考）
    与 seeAlso 不同，该 rendering 属性为当前资源提供一种可替代展示形式的 URI，比如提供了 PDF 或 ePub 形式的版本。与 seeAlso 相比，rendering 的 type 值的变化范围更广，以与可能的各种目标格式保持一致。

任何资源都可能具有 seeAlso 属性。它的每个实例都可能包含多个项目，前提是每个项目都具有 id 和 type 属性；label 、 format 和 profile 是强烈推荐使用的属性。符合标准的客户端可能会以某种方式处理此属性，但客户端处理的结果没有特定的形式。

限制条件

无。

例子

在本例中，MODS XML 文件作为整体被提交给了程序，因此该 seeAlso 属性被附加到了清单。如果此类数据文件可分别用于每个视图或页面，则每个画布 (Canvas) 将是相应 seeAlso 实例的逻辑位置。

要动态查看 Mirador 中的属性，请在其内容窗口左上角的三行菜单处（“hamburger”）进行激活，来切换侧边栏。然后，您应该在“相关”区域中，查看“另请参阅”副标题下“相关”部分中的链接。

JSON-LD | 在Mirador中查看

  1. {
  2.   "@context": "http://iiif.io/api/presentation/3/context.json",
  3.   "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/manifest.json",
  4.   "type": "Manifest",
  5.   "label": {
  6.     "en": [
  7.       "Linking to Structured Metadata"
  8.     ]
  9.   },
  10.   "summary": {
  11.     "en": [
  12.       "Playbill for \"Akiba gongen kaisen-banashi,\" \"Futatsu chōchō kuruwa nikki\" and \"Godairiki koi no fūjime\" performed at the Chikugo Theater in Osaka from the fifth month of Kaei 2 (May, 1849); main actors: Gadō Kataoka II, Ebizō Ichikawa VI, Kitō Sawamura II, Daigorō Mimasu IV and Karoku Nakamura I; on front cover: producer Mominosuke Ichikawa's crest."
  13.     ]
  14.   },
  15.   "viewingDirection": "right-to-left",
  16.   "seeAlso": [
  17.     {
  18.       "id": "https://fixtures.iiif.io/other/UCLA/ezukushi_mods.xml",
  19.       "type": "Dataset",
  20.       "label": {
  21.         "en": [
  22.           "MODS metadata"
  23.         ]
  24.       },
  25.       "format": "text/xml",
  26.       "profile": "http://www.loc.gov/mods/v3"
  27.     }
  28.   ],
  29.   "items": [
  30.     {
  31.       "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p1",
  32.       "type": "Canvas",
  33.       "label": {
  34.         "en": [
  35.           "front cover"
  36.         ]
  37.       },
  38.       "width": 3497,
  39.       "height": 4823,
  40.       "items": [
  41.         {
  42.           "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/page/p1/1",
  43.           "type": "AnnotationPage",
  44.           "items": [
  45.             {
  46.               "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/annotation/p0001-image",
  47.               "type": "Annotation",
  48.               "motivation": "painting",
  49.               "body": {
  50.                 "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001/full/max/0/default.jpg",
  51.                 "type": "Image",
  52.                 "format": "image/jpeg",
  53.                 "height": 4823,
  54.                 "width": 3497,
  55.                 "service": [
  56.                   {
  57.                     "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001",
  58.                     "type": "ImageService3",
  59.                     "profile": "level1"
  60.                   }
  61.                 ]
  62.               },
  63.               "target": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p1"
  64.             }
  65.           ]
  66.         }
  67.       ]
  68.     },
  69.     {
  70.       "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p2",
  71.       "type": "Canvas",
  72.       "label": {
  73.         "en": [
  74.           "pages 1–2"
  75.         ]
  76.       },
  77.       "width": 6062,
  78.       "height": 4804,
  79.       "items": [
  80.         {
  81.           "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/page/p2/1",
  82.           "type": "AnnotationPage",
  83.           "items": [
  84.             {
  85.               "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/annotation/p0002-image",
  86.               "type": "Annotation",
  87.               "motivation": "painting",
  88.               "body": {
  89.                 "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_002/full/max/0/default.jpg",
  90.                 "type": "Image",
  91.                 "format": "image/jpeg",
  92.                 "width": 6062,
  93.                 "height": 4804,
  94.                 "service": [
  95.                   {
  96.                     "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_002",
  97.                     "type": "ImageService3",
  98.                     "profile": "level1"
  99.                   }
  100.                 ]
  101.               },
  102.               "target": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p2"
  103.             }
  104.           ]
  105.         }
  106.       ]
  107.     },
  108.     {
  109.       "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p3",
  110.       "type": "Canvas",
  111.       "label": {
  112.         "en": [
  113.           "pages 3–4"
  114.         ]
  115.       },
  116.       "width": 6127,
  117.       "height": 4776,
  118.       "items": [
  119.         {
  120.           "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/page/p3/1",
  121.           "type": "AnnotationPage",
  122.           "items": [
  123.             {
  124.               "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/annotation/p0003-image",
  125.               "type": "Annotation",
  126.               "motivation": "painting",
  127.               "body": {
  128.                 "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_003/full/max/0/default.jpg",
  129.                 "type": "Image",
  130.                 "format": "image/jpeg",
  131.                 "width": 6127,
  132.                 "height": 4776,
  133.                 "service": [
  134.                   {
  135.                     "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_003",
  136.                     "type": "ImageService3",
  137.                     "profile": "level1"
  138.                   }
  139.                 ]
  140.               },
  141.               "target": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p3"
  142.             }
  143.           ]
  144.         }
  145.       ]
  146.     },
  147.     {
  148.       "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p4",
  149.       "type": "Canvas",
  150.       "label": {
  151.         "en": [
  152.           "pages 5–6"
  153.         ]
  154.       },
  155.       "width": 6124,
  156.       "height": 4751,
  157.       "items": [
  158.         {
  159.           "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/page/p4/1",
  160.           "type": "AnnotationPage",
  161.           "items": [
  162.             {
  163.               "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/annotation/p0004-image",
  164.               "type": "Annotation",
  165.               "motivation": "painting",
  166.               "body": {
  167.                 "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_004/full/max/0/default.jpg",
  168.                 "type": "Image",
  169.                 "format": "image/jpeg",
  170.                 "width": 6124,
  171.                 "height": 4751,
  172.                 "service": [
  173.                   {
  174.                     "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_004",
  175.                     "type": "ImageService3",
  176.                     "profile": "level1"
  177.                   }
  178.                 ]
  179.               },
  180.               "target": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p4"
  181.             }
  182.           ]
  183.         }
  184.       ]
  185.     },
  186.     {
  187.       "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p5",
  188.       "type": "Canvas",
  189.       "label": {
  190.         "en": [
  191.           "back cover"
  192.         ]
  193.       },
  194.       "width": 3510,
  195.       "height": 4808,
  196.       "items": [
  197.         {
  198.           "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/page/p5/1",
  199.           "type": "AnnotationPage",
  200.           "items": [
  201.             {
  202.               "id": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/annotation/p0005-image",
  203.               "type": "Annotation",
  204.               "motivation": "painting",
  205.               "body": {
  206.                 "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_005/full/max/0/default.jpg",
  207.                 "type": "Image",
  208.                 "format": "image/jpeg",
  209.                 "width": 3510,
  210.                 "height": 4808,
  211.                 "service": [
  212.                   {
  213.                     "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_005",
  214.                     "type": "ImageService3",
  215.                     "profile": "level1"
  216.                   }
  217.                 ]
  218.               },
  219.               "target": "https://iiif.io/api/cookbook/recipe/0053-seeAlso/canvas/p5"
  220.             }
  221.           ]
  222.         }
  223.       ]
  224.     }
  225.   ]
  226. }

与fixture的直接链接非常方便。

相关专题

  • [主页][0047] 用于指向关于当前资源所代表的对象的网页
  • 为同一对象的替代表示提供替代表示