Skip to content

Islandora/openseadragon

Repository files navigation

Mascot OpenSeadragon

Build Status Contribution Guidelines LICENSE

Introduction

Drupal FieldFormatter to display an image or generic file using a IIIF Image server and OpenSeadragon.

Requirements

Installation

This module can be installed via composer and enabled via Drush, like:

  1. composer require drupal/openseadragon:^2.0
  2. drush pm-en openseadragon

Downloading/deploying the openseadragon library itself is not neccessary, as it is referenced externally via a CDN.

If you are using the islandora-playbook, there is an Ansible role already built-in for installing OpenSeadragon.

Configuration

The module, once enabled will create a configuration page under Configuration > Media > Openseadragon Settings. There will be some default settings checked for you. The one setting which you will need to set as a required minimum is the IIIF Image Server Location, such as http://127.0.0.1:8080/cantaloupe/iiif/2 There are a myriad of other configuration settings available there. Additional OpenSeadragon documentation is available here.

Config

Documentation

Further documentation for this module is available on the Islandora 2 documentation site.

Troubleshooting/Issues

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

Maintainers

Current maintainers:

Development

If you would like to contribute, please get involved by attending our weekly Tech Call. We love to hear from you!

If you would like to contribute code to the project, you need to be covered by an Islandora Foundation Contributor License Agreement or Corporate Contributor License Agreement. Please see the Contributors pages on Islandora.ca for more information.

We recommend using the islandora-playbook or isle-dc to get started.

License

GPLv2