IIIF-Producer

A CLI tool that generates IIIF Presentation API v2 and v3 Manifests from METS/MODS (produced by Kitodo)

Build

$ ./gradlew clean build

Test

$ gradle test

Install

• find distribution archive in producer/build/distributions
• extract archive

$ cd producer-{$version}
$ chmod +x bin/producer

Configuration

See etc/producer-config.yml

Usage

bin/producer -x xmlFile -o outputfile -v view_identifier -c configFile -f v2

Argument	Description	Example	Default
-x	A METS/MODS xml file path	/MS_187.xml
-o	An JSON-LD output file path	/output.json	/tmp/output.json
-v	The name of the IIIF viewer identifer	0004285964
-c, --config	a yaml configuration File	etc/producer-config.yml	etc/producer-config.yml
-f, --format	a Presentation API version format	v2	v3

Images

The images must already be present on the image server consistent the semantics of the service URL builder.

Example: https://iiif.ub.uni-leipzig.de/iiif/j2k/{$viewId[0-4]}/{$viewId[5-8]}/{$viewId[0-10]}/{imageIndex[0-8]}.jpx

Java

• This requires Java 8 or higher

Local Testing

If using IntelliJ, enable the built-in webserver (requires the PHP plugin). See Preferences -> Build,Execution,Deployment -> Debugger.

Install Mirador 3

npm install mirador

Start Mirador

npm start

Add local manifest to catalogue e.g. http://localhost:63342/iiif-producer/converter/src/test/resources/HSP.json