Extension:IIIF

The IIIF extension offers a number of API services and associated tools for working with IIIF (International Image Interoperability Framework), such as integrating annotations, creating collections and using image files from MediaWiki sites. Beginning with v0.3, it also provides an image annotation tool based on OpenSeadragon and Annotorious. Some of its features support integration with Extension:Semantic MediaWiki and in fact, v0.5 comes with two new result formats for visualising annotations.

The most up to date and detailed guide on usage and configuration is included with the extension on the special page Special:IIIF. A blog about initial development can be found on https://codecs.vanhamel.nl/Show:Lab/IIIF.

• Download and place the file(s) in a directory called IIIF in your extensions/ folder.
• Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See T173141 for potential complications.)
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'IIIF' );
  

• Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

IIIF (International Image Interoperability Framework) refers to a set of open web standards for delivering digital resources, such as images and audio/visual files, along with their metadata. Adopted across the GLAM sector and perhaps further afield, it has significantly contributed to the dissemination of cultural heritage assets in digital form and to engagement with them in research and education. Central to IIIF standards is a set of APIs, notably the Presentation API and Image API. This extension focuses on the implementation of IIIF APIs within the MediaWiki context as well as tools can make use of them.

See the IIIF website for a general introduction and further information.

Once the extension is installed, a full guide is available from Special:IIIF.

• Parser functions :
  • #iiif-annotator - lets you enable an image annotation tool on a wiki page. Users can then create Annotations, which are stored as JSON in a wiki page. In 'view only' mode, the same parser function can be used to exhibit the IIIF resource in the viewer and the Annotations that were created for it. JSON schemas can be used to let you create forms for use with the annotator and set up models for displaying the data. Without a JSON schema, the tool defaults to using a textarea with 'description' as the name of the input.
  • #iiif-annotator-data - lets you reuse Annotation data by sending them to a wiki template. This can be useful, for instance, if you want to store Annotations through Semantic MediaWiki's #subobject format.
  • #iiif-tify - lets you use the TIFY viewer to load a Manifest.
  • #iiif-get-canvases - convenience function for retrieving structured information about canvas items.
• Result formats for Semantic MediaWiki :
  • iiif-canvas-viewer - uses the OpenSeadragon/Annotorious image viewer to show annotated canvases.
  • iiif-annotation-gallery - creates a gallery of image crops matching the annotated regions. A lightbox-type viewer is used to reveal larger images and details.
• A set of API modules :
  • iiif-manifest - takes a Manifest URL and the wiki page for which Semantic MediaWiki data have been created, and returns a new IIIF Manifest in which those data have been merged as Annotations.
  • iiif-annotations - auxiliary service for iiif-manifest that returns Annotations as AnnotationPage (v3) or sc:AnnotationList (v2), or if 'dest' is set to 'localstorage', as a LocalStorageService.
  • iiif-mw-pres - implements the IIIF Presentation API using the MediaWiki file system. It supports image files (level 0, tileless, pyramidically sized) from the local MediaWiki repository as well as from external repositories such as Wikimedia Commons.
  • iiif-mw-img - auxiliary service used by iiif-mw-pres to obtain Image Information Requests (v2 and v3).
  • iiif-collection - lets you create a IIIF Collection, i.e. a collection of IIIF Manifests, on the basis of a Semantic MediaWiki query. The configuration for the query can be set in LocalSettings or in a wiki page referenced by the smwconfig URL parameter.
  • iiif-wiki - returns the JSON content of a wiki page in the IIIF namespace. For instance, if a parser function accepts a Manifest URL and that Manifest is stored on a wiki page, the API's URL address would be a convenient identifier.
  • Special:IIIFServ - special page for redirecting a web request to the relevant API module.
• A JSON namespace with the prefix IIIF for storing configuration data, Manifests and Annotations.

Example of the annotation tool using the #iiif-annotator parser function

• Extension:Mirador

• Stable extensions
• API extensions
• Parser function extensions
• User interface extensions
• ContentHandler extensions
• GPL licensed extensions
• Extensions in GitHub version control
• ParserFirstCallInit extensions
• BeforePageDisplay extensions
• AdminLinks extensions
• ContentHandlerDefaultModelFor extensions
• ListDefinedTags extensions
• ChangeTagsListActive extensions
• ChangeTagsAllowedAdd extensions
• CodeEditorGetPageLanguage extensions
• All extensions
• Extensions requiring Composer with git
• Media handling extensions
• Annotation extensions
• Semantic MediaWiki extensions

• Extensions without an image
• Extensions without a compatibility policy
• Extensions with manual MediaWiki version
• Extensions not in ExtensionJson