...
SeaDragon is a zoomable viewer available for Book/Newspaper Pages and Large Images. The viewer supports a custom Djatoka tilesource and a IIIF tilesource, based in spirit from the JS component of Kevin Clarke's FreeLib-Djatoka. Instead of "synthesizing" the info for DZI this module creates the path to access Djatoka directly and obtain different regions for the tiles.
Dependencies
Drupal.org modules:
OpenSeadragon
Download and install the Openseadragon library to your sites/libraries folder, or run drush openseadragon-plugin
. Openseadragon 2.2.1 is known to work well with Islandora. Note: If you use the Drush command, it is advisable to Move (not copy) the install script to your .drush
folder and run it.
If you have an existing install it's required to update Openseadragon to it's latest version. You can do this quickly with the provided Drush command.
drush openseadragonplugin
Reverse Proxy
Reverse proxy config: We make the assumption that we (reverse) proxy Djatoka, to fix the same-origin issue.
...
in the Apache config somewhere (either the main apache.conf, httpd.conf, or in and arbitrarily named named *.conf
in in your Apache's conf.d directory should suffice to establish the reverse proxy.
In Debian derived systems one will need to create location entries for each proxy or remove the Deny from All in mod_proxy's conf file.
Configuration
Dependencies
Drupal.org modules:
OpenSeadragon:
It is assumed that the core OpenSeadragon Javascript is put into sites/all/libraries/openseadragon. Openseadragon .9.129 is known to work well with Islandora. The most current version breaks the Islandora integration, which will be addressed in the future. The correct version for Islandora can be obtained from here: https://github.com/thatcher/openseadragon/tarball/1c7f5839f90c28e97c96c169fdf23da24826605f
Note |
---|
There is a conditional dependency on the islandora_paged_content module, but this should not require any additional actions from the user as the solution packs that use the feature requiring the islandora_paged_content module include it in their depency lists. |
Configuration
Set the paths for 'Djatoka server base URL' and configure OpenSeadradon in Administration » Islandora » OpenSeadragon (admin/islandora/module).
Djatoka Image Server
Set the paths for 'Djatoka server base URL' and configure OpenSeadradon in Administration » Islandora » OpenSeadragon (admin/islandora/module).
IIIF Server
Any IIIF image server can be used the the IIIF tile source. The IIIF tile source provides a full URL to the datastream to be displayed as the IIIF identifier
. The IIIF server needs to be configured to resolve this full URL to retrieve the image.
The Cantaloupe 🍈 IIIF image server can be configured to resolve these identifiers using the HttpResolver
with no prefix specified.
Configuration Screenshots
There are a lot of options to configure Open Seadragon. Here are screenshots to every available option in the current version.
Image Added
Note the option to select either an adore-Djatoka Image Server or a IIIF Image server
Image AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage Removed
Troubleshooting/Issues
Having problems or solved a problem? Check out the Islandora google groups for a solution. Have a solution (or a problem with these docs)? Share it with the community!