Skip to content

IIIF Linking Properties Usage Survey

Ben W. Brumfield edited this page Jul 16, 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.

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 University

New Haven, Beinecke Rare Book and Manuscript Library, Yale University, Beinecke MS 310

   "related":{
      "@id":"http://brbl-net.library.yale.edu/pre1600ms/docs/pre1600.ms310.htm",
      "label":"Beinecke Rare Book and Manuscript Library, Yale University catalog entry"
   }

Target did not load

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.

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"
    }
  ],