IIIF Linking Properties Usage Survey

Ben W. Brumfield edited this page Jul 19, 2017 · 13 revisions

A survey of linking property usage among IIIF content providers, conducted on most providers with top-level repositories listed at the IIIF Top-level Collections Spreadsheet on 2017-07-15 as research for the next version of FromThePage's IIIF Presentation API service.

Background

The IIIF Presentation API lists linking properties for pointing to external content, including web pages listing catalog records, PDF files containing text, machine-readable information services, and many other things. The properties provided for this are related, rendering, seeAlso, and service. See the relevant section of the IIIF Presentation API 2.1.1. Other linking properties (like within) are provided but were not surveyed.

Survey Results

Not all content providers are using linking properties, and of those which are, not all are using them consistently. (Note that no effort was made to evaluate which version of the Presentation API was implemented at each provider.)

Content providers not using linking properties

Use of related

Biblissima

George Washington, lettre au comte Louis-Marie de Noaillesau comte de Noailles, Princeton,

  "related" : "http://gallica.bnf.fr/ark:/12148/btv1b105243418",

Target is the Gallica page viewer for this item.

Villanova University

Francis Bolton Elwell Scrapbook: 1917-1919.

    "related": {
        "@id": "https://digital.library.villanova.edu/Item/vudl:482844",
        "format": "text/html"
    },

Target is the Villanova Digital Library viewer with the item loaded.

Wellcome Library

Fermented liquors : a treatise on brewing, distilling, rectifying, and manufacturing of sugars, wines, spirits, and all known liquors, including cider and vinegar. Also, hundreds of valuable directions in medicine, metallurgy, pyrotechny, and the arts in general

  "related": {
    "@id": "https://wellcomelibrary.org/item/b21051951",
    "format": "text/html"
  },

Target is Wellcome's instance of the Universal Viewer with this item loaded

Yale British Art Collections

Added 2017-07-17 Joseph Farington, 1747–1821, British, Caernarvon Castle, ca. 1780, Oil on canvas, Yale Center for British Art, B1976.7.118, Paintings and Sculpture

   "related":{
      "@id":"http://collections.britishart.yale.edu/vufind/Record/1667702",
      "label":"catalog entry at the Yale Center for British Art",
      "format":"text/html"
   },

Target is a web page for the catalog record, featuring a thumbnail and links to viewers.

Use of rendering

Harvard Art Museums

http://iiif.harvardartmuseums.org/manifests/object/299843

   "rendering":{
      "label":"Full record view",
      "@id":"http://harvardartmuseums.org/collections/object/299843",
      "format":"text/html"
   },

Target is the catalog record webpage and viewer for this item.

National Library of Scotland

Travels of Cyrus At the default sequence level

            "rendering" : [
                {
                    "@id" : "https://deriv.nls.uk/dcn23/1188/7314/118873148.23.pdf",
                    "format" : "application/pdf",
                    "label" : "Download as PDF"
                }
            ],

Target is a direct link to a PDF of the scanned images, with a text layer supporting search-within on OCR.

University College Dublin

The Re-Conquest of Ireland, A. D. 1895.

   "rendering": {
         "@id": "https://digital.ucd.ie/get/ivrla:2622/content",
         "format": "application/pdf",
         "label": "Download as PDF"
   },

Target is a direct link to a PDF of the scanned images, with no text layer.

Villanova University

Francis Bolton Elwell Scrapbook: 1917-1919. This is a member of the default sequence:

            "rendering": [],

This is a member on each canvas:

                    "rendering": [
                        {
                            "@id": "https://digital.library.villanova.edu/files/vudl:482873/MASTER",
                            "format": "image/tiff",
                            "label": "Original source file - 148.38 MB"
                        },
                        {
                            "@id": "https://digital.library.villanova.edu/files/vudl:482873/OCR-DIRTY",
                            "format": "text/plain",
                            "label": "Raw OCR Data"
                        },
                        {
                            "@id": "https://digital.library.villanova.edu/files/vudl:482873/MASTER-MD",
                            "format": "application/xml",
                            "label": "Technical Metadata"
                        }
                    ],
  • Target 1 is a direct link to a TIFF of the page image.
  • Target 2 is uncorrected, plain-text OCR output for this page.
  • Target 3 is a "FITS Output" XML file containing information about image size, sampling/scanning parameters, tools used, etc.

Wellcome Library

Fermented liquors : a treatise on brewing, distilling, rectifying, and manufacturing of sugars, wines, spirits, and all known liquors, including cider and vinegar. Also, hundreds of valuable directions in medicine, metallurgy, pyrotechny, and the arts in general

Note that this is a member of the default sequence, not the manifest

      "rendering": [
        {
          "@id": "https://dlcs.io/pdf/wellcome/pdf-item/b21051951/0",
          "format": "application/pdf",
          "label": "Download as PDF"
        },
        {
          "@id": "https://wellcomelibrary.org/service/fulltext/b21051951/0?raw=true",
          "format": "text/plain",
          "label": "Download raw text"
        }
      ],
  • Target 1 is a direct link to a PDF of the entire work, apparently with a text layer only on the cover page, but not on the work contents itself.
  • Target 2 is a plaintext file containing OCR output for the entire work, without page or line-break formatting.

Use of seeAlso

Biblissima

George Washington, lettre au comte Louis-Marie de Noaillesau comte de Noailles, Princeton,

  "seeAlso" : [ "http://oai.bnf.fr/oai2/OAIHandler?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:bnf.fr:gallica/ark:/12148/btv1b105243418" ],

Target is an XML response to an OAI-PMH query for this item.

Bodleian Library

Added 2017-07-29 MS. Barocci 197

  "seeAlso": "http://digital.bodleian.ox.ac.uk/inquire/p/eba7435d-673e-449b-8a8f-bd644ee88ea4", 

Target is the catalog entry web page, containing the item in an embedded viewer.

BSB

Livre des Assises de la baisse Court, c'est de la Court dou Visconte dou Reaume de Chipre - BSB Cod.gall. 51

   "seeAlso":[
      {
         "@id":"https://opacplus.bsb-muenchen.de/title/BV037443140"
      }
   ],

Target is a web page for the catalog record for this item, with links to viewers.

e-codices

Bulle, Mus\u00e9e gru\u00e9rien, 383

   "seeAlso":"http://www.e-codices.unifr.ch/en/list/one/mgb/0383",

Target is a web page for the catalog record for this item, including a thumbnail, link to a viewer, list of annotations, IIIF manifest icon, and reference images.

Stanford

Fragment of Laudes?

  "seeAlso": {
    "@id": "https://purl.stanford.edu/rh991sr7828.mods",
    "format": "application/mods+xml"
  },

Target is an XML MODS record.

Universitätsbibliothek Heidelberg

Missale

   "seeAlso" : "http://digi.ub.uni-heidelberg.de/diglit/codheidnf21_2/mets",

Target is an XML METS record.

University College Dublin

The Re-Conquest of Ireland, A. D. 1895.

   "seeAlso": [
      {
         "@id": "https://digital.ucd.ie/view/ivrla:2622.xml",
         "format": "text/xml",
         "profile": "http://www.loc.gov/mods/v3",
         "label": "MODS metadata describing this object"
      },
      {
         "@id": "https://digital.ucd.ie/view/ivrla:2622.n3",
         "format": "text/rdf+n3",
         "label": "RDF n3 serialisation of metadata describing this object"
      },
      {
         "@id": "https://data.ucd.ie/api/edm/v1/ivrla:2622",
         "format": "application/x.europeana-edm+xml",
         "label": "EDM (Europeana Data Model) RDF metadata",
         "profile": "http://www.europeana.eu/schemas/edm/"
      },
      {
         "@id": "https://digital.ucd.ie/view/ivrla:2622.rdf",
         "format": "application/rdf+xml",
         "label": "RDF-XML metadata describing this object"
      }   ],

Wellcome Library

Fermented liquors : a treatise on brewing, distilling, rectifying, and manufacturing of sugars, wines, spirits, and all known liquors, including cider and vinegar. Also, hundreds of valuable directions in medicine, metallurgy, pyrotechny, and the arts in general

  "seeAlso": [
    {
      "@id": "https://wellcomelibrary.org/data/b21051951.json",
      "format": "application/json",
      "profile": "http://wellcomelibrary.org/profiles/res"
    },
    {
      "@id": "https://wellcomelibrary.org/resource/schemaorg/b21051951",
      "format": "application/ld+json",
      "profile": "http://iiif.io/community/profiles/discovery/schema"
    },
    {
      "@id": "https://wellcomelibrary.org/resource/dublincore/b21051951",
      "format": "application/ld+json",
      "profile": "http://iiif.io/community/profiles/discovery/dc"
    }
  ],
  • Target 1 is item metadata in a Wellcome-specific JSON format.
  • Target 2 is item metadata in Schema.org JSON-LD.
  • Target 3 is item metadata in Dublin Core JSON-LD.

Use of service

e-codices

Bulle, Mus\u00e9e gru\u00e9rien, 383

   "service":[
      {
         "@context":"https://www.w3.org/TR/webmention/",
         "@id":"http://www.e-codices.unifr.ch/webmention/receive",
         "profile":"http://w3.org/TR/webmention",
         "label":"e-codices Webmention Service"
      }
   ],

Target is a REST endpoint for posting webmentions

Wellcome Library

Fermented liquors : a treatise on brewing, distilling, rectifying, and manufacturing of sugars, wines, spirits, and all known liquors, including cider and vinegar. Also, hundreds of valuable directions in medicine, metallurgy, pyrotechny, and the arts in general

  "service": [
    {
      "@context": "http://wellcomelibrary.org/ld/iiif-ext/0/context.json",
      "@id": "https://wellcomelibrary.org/iiif/b21051951-0/access-control-hints-service",
      "profile": "http://wellcomelibrary.org/ld/iiif-ext/access-control-hints",
      "accessHint": "open"
    },
    {
      "@context": "http://iiif.io/api/search/0/context.json",
      "@id": "https://wellcomelibrary.org/annoservices/search/b21051951",
      "profile": "http://iiif.io/api/search/0/search",
      "label": "Search within this manifest",
      "service": {
        "@id": "https://wellcomelibrary.org/annoservices/autocomplete/b21051951",
        "profile": "http://iiif.io/api/search/0/autocomplete",
        "label": "Get suggested words in this manifest"
      }
    },
    {
      "@context": "http://universalviewer.io/context.json",
      "@id": "http://wellcomelibrary.org/service/trackingLabels/b21051951",
      "profile": "http://universalviewer.io/tracking-extensions-profile",
      "trackingLabel": "Format: monograph, Institution: Francis A. Countway Library of Medicine, Identifier: b21051951, Digicode: digmhl(francis), Collection code: n/a"
    }
  ],

Yale British Art Collections

Added 2017-07-17 Joseph Farington, 1747–1821, British, Caernarvon Castle, ca. 1780, Oil on canvas, Yale Center for British Art, B1976.7.118, Paintings and Sculpture


   "seeAlso":[
      {
         "@id":"http://collection.britishart.yale.edu/id/data/object/340",
         "format":"text/rdf+n3"
      },
      {
         "@id":"https://manifests.britishart.yale.edu/xml/340.xml",
         "format":"text/xml"
      }
   ],

Client Survey

After discussion on the IIIF Community Call on 2017-07-19, I surveyed how viewers present the linking properties covered by this survey. To my knowledge, only Mirador, the Universal Viewer, the Bodleian Manifest Editor, and FromThePage are clients which consume IIIF manifests, although individual customizations of clients may present links differently, as with the Harry Ransom Center's change to place related links above metadata in their installation of Mirador.

Bodleian Manifest Editor

The Manifest Editor prompts users to change related and seeAlso if they are present in the manifest, but it is unclear whether this functionality is fully supported. It does not expose rendering in the sequence metadata editor.

Editor displaying related/seeAlso properties

FromThePage

FromThePage does nothing at all with the four linking properties surveyed.

Mirador

Mirador presents seeAlso and related links under the metadata block in the information pane.
Mirador's information view It does not appear to filter out links based on human readability.

No support for rendering or service (at least the Search API) was visible.

Universal Viewer

The Universal Viewer does not appear to display related properties.

The rendering property for a sequence is displayed on the pop-up a user sees when they click on the Download icon:

Download pop-up in the Universal Viewer
No support for the rendering at the canvas level was apparent.

The service property is supported for the Search API: Search field

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.