GithubHelp home page GithubHelp logo

patdunlavey / islandora_internet_archive_bookreader Goto Github PK

View Code? Open in Web Editor NEW

This project forked from diegopino/islandora_internet_archive_bookreader

0.0 2.0 0.0 1.04 MB

Islandora wrapper for the Internet Archive BookReader. Developer documentation: http://openlibrary.org/dev/docs/bookreader Hosted source code: http://github.com/openlibrary/bookreader

License: GNU General Public License v3.0

CSS 2.70% PHP 27.94% JavaScript 69.35%

islandora_internet_archive_bookreader's Introduction

Islandora Internet Archive BookReader Build Status

Introduction

An Islandora wrapper for the Internet Archive BookReader.

This module doesn't do much on its own, it is assumed that it will be used in conjunction with a solution pack, where it will be enabled as a viewer.

Requirements

This module requires the following modules/libraries:

And one (1) of the following Image Server options:

This module has the following as optional requirements for certain features:

Allows OCR based search using the Viewer's Search box.

Installation

Install as usual, see this for further information.

Download/clone our fork of the Internet Archive BookReader to sites/all/libraries/bookreader, or run drush iabookreader-plugin. This is currently the only version we support.

This module requires that you set up either Djatoka or an IIIF Image API compliant Image Sever. For Djatoka please follow the steps outlined at here.

This module requires Colorbox and its dependant library Colorbox library. Depending on the version of the Colorbox module and library you are using, there can be some issues with Colorbox finding the library. This comment solves the issue.

Note: If you use the Drush command, it is advisable to Move (not copy) the install script to your .drush folder before running it.

Configuration

Common settings

You can setup which 'Solr field relating pages to book PIDs' is used, the amount of 'Overlay Opacity', what content type is to be displayed to final users within the Internet Archive Book Reader Viewer, the 'Default page view' mode and the full screen behaviour for mobile users in Administration » Islandora » Islandora Viewers » Internet Archive BookReader (/admin/islandora/islandora_viewers/internet_archive_bookreader).

Configuration

Image server selection

This module is able to use either Adore-djatoka or an IIIF Image API compliant Image Server as source for each book's page image.

Adore-djatoka

Djatoka specific options are:

  • Compression level (the larger the number, the lower the quality but also the smaller the file size)
  • Using an Object's JPG datastream as a backup in case Djatoka cannot return a JP2.

Note: The Adore-datoka Server URI (Open URL endpoint) must be set from Islandora Paged Content Solution Pack's admin settings.

IIIF

Any IIIF image server can be used as the IIIF tile source.

The IIIF Image Server Base URL needs to be setup here. This URL can be relative or absolute but needs to be openly accessible to a visiting user (Ajax).

This module provides Drupal tokens to allow highly configurable replacement patterns to be used for the IIIF identifier creation.

These IIIF identifier are send to the IIIF Image server where they are resolved back into URLs that can be accessed by it and used as Source for its tile creation.

This resolvers need to be properly configured at the Image server level. E.g, a Cantaloupe 🍈 IIIF image server can be configured to resolve these identifiers using the HttpResolver with no prefix specified.

Islandora also uses temporary authentication tokens to give backend services limited time access to protected resources (Datastreams). You can select if those tokens are passed as part of a IIIF identifier or via an HTTP Header.

Configuration

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

islandora_internet_archive_bookreader's People

Contributors

adam-vessey avatar aulorbe avatar bondjimbond avatar bwoodhead avatar cderven avatar christianselig avatar daniel-dgi avatar diegopino avatar dltj avatar giancarlobi avatar jmacwilliams avatar jonathangreen avatar jordandukart avatar kellibee123 avatar manez avatar matthewperry avatar mjordan avatar morgandawe avatar mrmiguez avatar nhart avatar nigelgbanks avatar nmader avatar patdunlavey avatar philsogadgi avatar ppound avatar rosiel avatar ruebot avatar whikloj avatar willtp87 avatar yqjiang avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.