digilib - The Digital Image Library

# HG changeset patch # User Robert Casties # Date 1522084607 0 # Node ID 57fcbde44c14143ea6361c06eae8bddc30d4e8a3 # Parent 8a9c66abb57c00340c62005aad7279e14f8c27b3 Creating site for 2.5-SNAPSHOT diff -r 8a9c66abb57c -r 57fcbde44c14 iiif-api.html --- a/iiif-api.html Wed Mar 14 18:57:23 2018 +0000 +++ b/iiif-api.html Mon Mar 26 17:16:47 2018 +0000 @@ -1,13 +1,13 @@ - + digilib - The Digital Image Library – The digilib IIIF API @@ -41,7 +41,7 @@

Last Published: 2018-03-14
Last Published: 2018-03-26
|
Version: 2.5-SNAPSHOT

where digilib-webapp is the name of the digilib web application in the servlet container.

The value of iiif-prefix is defined by the iiif-prefix parameter in digilib-config. The default value is “IIIF”.

The identifier part of the URL must not contain slashes. Since the identifier is mapped to the digilib fn-parameter, which is a filesystem path that likely contains slashes separating subdirectories, all occurrences of a slash have to be replaced by the value of the iiif-slash-replacement parameter in digilib-config. The default value of the replacement string is “!”, so the fn-path “books/book1/page0002” becomes the identifier “books!book1!page0002”.

For a definition of the other parameters region, size, rotation, quality, and format please see the IIIF Image API docs.

A IIIF Image API image request URL could look like:

http://www.example.org/digilib/Manifester/IIIF/books!book1

To try out a viewer on your manifest you can go to the website of the Universal Viewer http://universalviewer.io/ and enter the URL of your manifest in the “view a manifest” box on the page. This will work even with a local digilib installation since the Javascript in your Browser reads and interprets the manifest.

The minimal information in the manifest can be enhanced with additional metadata or the replaced by a custom manifest. If the servlet finds a file with the name

manifest.json
+

in a directory then the contents of that file are sent instead of an auto-generated manifest. This works also in directories with no images so you could put a file with collection information in a higher-level directory.

If the servlet finds a file with the name

manifest-meta.json
+

in a directory with images then the contents of that file are added to the top-level manifest (@context, @type, @id, sequences are ignored). You can use this to add real bibliographical information to the manifest.

The configuration parameter iiif-manifest-page-label determines the format of the label of each image: filename uses the image file name (default, sans extension), index uses the index (counting from 1).

digilib - The Digital Image Library – Issue Tracking

Last Published: 2018-03-14
Last Published: 2018-03-26
|
Version: 2.5-SNAPSHOT

digilib - The Digital Image Library – Project License