A Djatoka TileSource for Seadragon based in spirit from the JS component of https://github.com/ksclarke/freelib-djatoka.
Clone or download
Pull request Compare This branch is 34 commits ahead of nigelgbanks:7.x.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
build
css
images
includes
js
test
theme
.travis.yml
CONTRIBUTING.md
LICENSE.txt
README.md
TODO.txt
build.xml
islandora_openseadragon.drush.inc
islandora_openseadragon.info
islandora_openseadragon.install
islandora_openseadragon.module

README.md

Islandora OpenSeadragon Build Status

Introduction

An Islandora viewer module using OpenSeadragon. Works with large image datastreams (JPEG-2000). Supports a custom Djatoka tilesource and a IIIF tilesource.

Based in spirit from the JS component of Kevin Clarke's FreeLib-Djatoka

Requirements

This module requires the following modules/libraries:

Installation

Install as usual, see this for further information.

Download and install the Openseadragon library to your sites/libraries folder, or run drush openseadragon-plugin. Openseadragon 2.3.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.

Configuration

Djatoka Image Server

Drupal

Set the paths for 'Djatoka server base URL' and configure OpenSeadragon in Administration » Islandora » Islandora Viewers » OpenSeadragon (admin/islandora/islandora_viewers/openseadragon).

Configuration

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 openseadragon-plugin

Apache Reverse Proxy

Reverse proxy config: We make the assumption that we (reverse) proxy Djatoka, to fix the same-origin issue.

For Apache, with Drupal running on the same box as Apache, a couple lines like:

ProxyPass /adore-djatoka http://localhost:8080/adore-djatoka
ProxyPassReverse /adore-djatoka http://localhost:8080/adore-djatoka

in the Apache config somewhere (either the main apache.conf, httpd.conf, or in and arbitrarily named *.conf 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.

IIIF

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.

Documentation

Further documentation for this module is available at our wiki

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute to this module, please check out CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info, as well as our Developers section on the Islandora.ca site.

License

GPLv3