翻译者:ginkgo
原文链接:https://iiif.io/api/cookbook/recipe/0234-provider/
用例
您有一个 IIIF 资源,您希望在其中包含有关为提供资源内容做出贡献的一个或多个组织或人员的信息。您希望为每个贡献者包含一组丰富的信息以便客户端可以以同样强大的方式呈现这些信息。provider属性允许您以一种可扩展的方式来声明贡献者的贡献,可以仅用一个label
,也可以同时使用 label
、homepage
、 logo
和seeAlso
等机器可读的描述来声明贡献者。
实现说明
为了让客户端可以显示资源的一个或多个内容贡献者,provider
属性以代理资源的形式发送信息。该资源必须至少包含:
id
,贡献者的权威且唯一的 URI;type
,始终是字符串“Agent”;label
,贡献者的人类可读名称。
此外,provider
是结构化数据,可以包含多个代理(Agents),并且可以包含纯文本以外的资源,区别于requiredStatement.
为了使信息相互关联以及便于读者使用,强烈建议作为代理的provider
同时拥有homepage和logo属性。这些将允许读者访问贡献者的网站并找到更多信息。请注意,代理(Agent)的id可以但不必与主页(homepage)的id相同。
限制
无
示例
在此示例中,我们重用了加州大学洛杉矶分校图书馆数字馆藏为 IIIF 专题手册提供的歌舞伎节目单的首页。他们作为代理的id
是美国国会图书馆分配给加州大学洛杉矶分校图书馆的权威标识,homepage
是他们的实际主页。logo
也是作为一个整体的图书馆的logo,而seeAlso
则是美国国会图书馆的MADS / XML。在使用此属性时,您可能希望并且能够以不同方式统一属性中的信息。
当前没有查看器能充分且正确地实现provider
。
{
"@context": "http://iiif.io/api/presentation/3/context.json",
"id": "https://iiif.io/api/cookbook/recipe/0234-provider/manifest.json",
"type": "Manifest",
"label": {
"en": [
"Playbill Cover"
]
},
"summary": {
"en": [
"Cover of 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."
]
},
"provider": [
{
"id": "https://id.loc.gov/authorities/n79055331",
"type": "Agent",
"label": {
"en": [
"UCLA Library"
]
},
"homepage": [
{
"id": "https://digital.library.ucla.edu/",
"type": "Text",
"label": {
"en": [
"UCLA Library Digital Collections"
]
},
"format": "text/html",
"language": [
"en"
]
}
],
"logo": [
{
"id": "https://iiif.library.ucla.edu/iiif/2/UCLA-Library-Logo-double-line-2/full/full/0/default.png",
"type": "Image",
"service": [
{
"id": "https://iiif.library.ucla.edu/iiif/2/UCLA-Library-Logo-double-line-2",
"type": "ImageService3",
"profile": "level2",
"width": 1200,
"height": 502,
"sizes": [
{
"width": 300,
"height": 126
},
{
"width": 600,
"height": 251
},
{
"width": 1200,
"height": 502
}
]
}
]
}
],
"seeAlso": [
{
"id": "https://id.loc.gov/authorities/names/n79055331.madsxml.xml",
"type": "Dataset",
"label": {
"en": [
"US Library of Congress data about the UCLA Library"
]
},
"format": "application/xml",
"profile": "http://www.loc.gov/mads/v2"
}
]
}
],
"items": [
{
"id": "https://iiif.io/api/cookbook/recipe/0234-provider/canvas/p0",
"type": "Canvas",
"label": {
"en": [
"front cover with color bar"
]
},
"width": 4520,
"height": 5312,
"items": [
{
"id": "https://iiif.io/api/cookbook/recipe/0234-provider/page/p0/1",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/cookbook/recipe/0234-provider/annotation/p0000-image",
"type": "Annotation",
"motivation": "painting",
"body": {
"id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001_full/full/max/0/default.jpg",
"type": "Image",
"format": "image/jpeg",
"width": 4520,
"height": 5312,
"service": [
{
"id": "https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001_full",
"type": "ImageService3",
"profile": "level1"
}
]
},
"target": "https://iiif.io/api/cookbook/recipe/0234-provider/canvas/p0"
}
]
}
]
}
]
}