digilib image server
The digilib development repository lives on Sourceforge:Â http://digilib.sourceforge.netÂ
with a Mercurial code repository:Â http://hg.code.sf.net/p/digilib/codeÂ
(there is also a mirror on github: https://github.com/robcast/digilib ).
Dependencies
To run digilib you need:
- Java (version 7 or later)
- Tomcat (version 7 or later) or Jetty
To build and develop digilib you also need:
- Mercurial (or git)
- Maven
Installing digilib
You can get digilib either as a pre-built WAR file from:
- https://sourceforge.net/projects/digilib/files/releases/Â (Sourceforge release version)
- https://it-dev.mpiwg-berlin.mpg.de/downloads/digilib/daily-build/Â (daily build)
or build your own version (preferred) by following the "Developer build" instructions on http://digilib.sourceforge.net/build-maven.html
You can put the resulting WAR file or the "exploded" web application directory in the "webapps" directory of your Tomcat server and restart Tomcat.
Configuring digilib
See the digilib configuration documentation at http://digilib.sourceforge.net/digilib-config.html
The most important digilib configuration option is basedir-list
. It specifies the base directory that digilib uses to find its images. (If you want to use prescaled images and thumbnails please read http://digilib.sourceforge.net/image-directories.html).
You can check the current settings in your running digilib on the page http://localhost:8080/digilib/server/dlConfig.jspÂ
Using digilib
When digilib is running you can access your images in the default HTML frontend digilib.html by putting the relative path to the image file or folder in the fn-parameter:Â http://localhost:8080/digilib/digilib.html?fn=book1/page0001
You can also use the digilib Scaler API or the IIIF Image API to access scaled images directly:
- digilib Scaler API documentation:Â http://digilib.sourceforge.net/scaler-api.html
- digilib IIIF Image API documentation:Â http://digilib.sourceforge.net/iiif-api.html
- IIIF Image API:Â http://iiif.io/api/image/2.1/
- IIIF Presentation API:Â http://iiif.io/api/presentation/2.1/