用例

您有一个 IIIF 格式的资源，您希望为研究人员提供下载 PDF 版本的机会。您从之前的经验中了解到，使用您的馆藏的研究人员倾向于拥有可供离线阅读的图像和文本；或者您知道您的用户有带宽问题，他们需要尽量减少在线时间；当然还有其他原因，例如您可能想要提供对象文本的转录和翻译。通过使用rendering属性，您可以提醒符合要求的客户端注意此格式（或其他格式，例如 ePub）的存在，以便他们反过来为用户提供适当的 UX 工作流程。

实现说明

此属性用于将查看器指向它所附加到的资源的非 IIIF 表示。通常，另一种表示将需要一个客户端，它不同于用来查看IIIF资源的客户端。

其他三个属性可能看起来相似，因此需要强调差异：

homepage （IIIF展示API参考）
rendering呈现相同资源的附加表示，homepage指向关于资源表示对象的网页。
accompanyingCanvas （IIIF展示API参考）
一个accompanyingCanvas资源是与主要资源共同展示的IIIF资源；rendering的目标不是与IIIF兼容，而是使得在主要资源查看器外部的浏览成为可能。此外，accompanyingCanvas用于补充主要资源的内容，而rendering指向同一资源的附加表示。
seeAlso （IIIF展示API参考）
不同于rendering，seeAlso属性提供与当前资源相关的机器可读资源的 URI。在大多数情况下，都柏林核心集、MODS 或 RDF 等格式的结构化元数据是最有效的。seeAlso非常有助于发现，例如通过向聚合器提供其内容分面所需的内容。seeAlso的type取值通常为dataset，而rendering的type取值则多种多样，以便与各种可能的目标格式保持一致。

任何资源都可能具有rendering属性。它的每个实例可包含多个项目，只要每个都具有最低限度的id、type和label属性。符合标准的客户端应该以某种方式在收藏（Collection）、清单（Manifest）或画布（Canvas）上呈现此属性，但也可以在其他资源上呈现。请特别注意，客户端对属性的显示没有明确的形式要求。

限制

此属性不适用于展示同一视图的多个 IIIF 版本，例如一幅画的红外和自然光视图。在那种情况下，您应该使用 [选择（最简单）][0033] 或 [选择 - 多光谱风味示例，带有图像服务][0034]。

示例

在此示例中，整个程序都可以使用 PDF，因此rendering属性位于清单中。如果 PDF 可分别用于每个视图或页面，则每个画布（Canvas）将是相应 PDF 的逻辑位置。

要查看 Mirador 中的属性，请通过激活内容窗口左上角的三线（“汉堡包”）菜单来切换侧边栏。然后，您应该在“相关”（Related）区域中查看“替代格式”（Alternate formats）标题下的链接。

JSON-LD | 在Mirador中查看

{
  "@context": "http://iiif.io/api/presentation/3/context.json",
  "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/manifest.json",
  "type": "Manifest",
  "label": {
    "en": [
      "Alternative Representations Through Rendering"
    ]
  },
  "summary": {
    "en": [
      "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."
    ]
  },
  "viewingDirection": "right-to-left",
  "rendering": [
    {
      "id": "https://fixtures.iiif.io/other/UCLA/kabuki_ezukushi_rtl.pdf",
      "type": "Text",
      "label": {
        "en": [
          "PDF version"
        ]
      },
      "format": "application/pdf"
    }
  ],
  "items": [
    {
      "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p1",
      "type": "Canvas",
      "label": {
        "en": [
          "front cover"
        ]
      },
      "width": 3497,
      "height": 4823,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/page/p1/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/annotation/p0001-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "width": 3497,
                "height": 4823,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001",
                    "type": "ImageService3",
                    "profile": "level1"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p1"
            }
          ]
        }
      ]
    },
    {
      "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p2",
      "type": "Canvas",
      "label": {
        "en": [
          "pages 1–2"
        ]
      },
      "width": 6062,
      "height": 4804,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/page/p2/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/annotation/p0002-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_002/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "width": 6062,
                "height": 4804,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_002",
                    "type": "ImageService3",
                    "profile": "level1"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p2"
            }
          ]
        }
      ]
    },
    {
      "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p3",
      "type": "Canvas",
      "label": {
        "en": [
          "pages 3–4"
        ]
      },
      "width": 6127,
      "height": 4776,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/page/p3/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/annotation/p0003-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_003/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "width": 6127,
                "height": 4776,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_003",
                    "type": "ImageService3",
                    "profile": "level1"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p3"
            }
          ]
        }
      ]
    },
    {
      "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p4",
      "type": "Canvas",
      "label": {
        "en": [
          "pages 5–6"
        ]
      },
      "width": 6124,
      "height": 4751,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/page/p4/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/annotation/p0004-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_004/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "width": 6124,
                "height": 4751,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_004",
                    "type": "ImageService3",
                    "profile": "level1"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p4"
            }
          ]
        }
      ]
    },
    {
      "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p5",
      "type": "Canvas",
      "label": {
        "en": [
          "back cover"
        ]
      },
      "width": 3510,
      "height": 4808,
      "items": [
        {
          "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/page/p5/1",
          "type": "AnnotationPage",
          "items": [
            {
              "id": "https://iiif.io/api/cookbook/recipe/0046-rendering/annotation/p0005-image",
              "type": "Annotation",
              "motivation": "painting",
              "body": {
                "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_005/full/max/0/default.jpg",
                "type": "Image",
                "format": "image/jpeg",
                "width": 3510,
                "height": 4808,
                "service": [
                  {
                    "id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_005",
                    "type": "ImageService3",
                    "profile": "level1"
                  }
                ]
              },
              "target": "https://iiif.io/api/cookbook/recipe/0046-rendering/canvas/p5"
            }
          ]
        }
      ]
    }
  ]
}

IIIF官方文档知识库

提供替代表示

用例

实现说明

限制

示例

相关专题