Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Islandora Internet Archive Bookreader is an implementation of Open Library's Internet Archive Bookreader web app. It is used by the Islandora Book Solution Pack to display a series of pages as an entire book that can be accessed on the book's 'View' page.

Dependencies

Provisions

Downloads

The Islandora Internet Archive Bookreader module can be found on the Release Notes and Downloads page. 

...

Internet Archive BookReader Developer documentation

This module requires that you set up 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.

Installation

Though the actual Bookreader module is installed the same way as any Drupal module is, the Bookreader library needs to be downloaded and placed manually. This can be done in two different ways:

  • If 'git' is installed on your server, you can navigate to your Drupal installation's sites/all/libraries folder and run "git clone git://github.com/openlibrary/bookreader.git" to automatically clone the repository. If 'git' isn't installed, you can often get it from standard Linux package managers by running a command similar to 'apt-get install git' or 'yum install git'.
  • If you wouldn't like to use GitHub's standard repository manager, you can navigate to the repository's site in the Downloads section above, click the button to download the repository as a ZIP file, and extract it to your Drupal installation's sites/all/libraries folder. If you do this, you will need to rename the extracted folder from 'bookreader-branch' (e.g. bookreader-master) to simply 'bookreader'.

 

Usage

Controls for the Islandora Internet Archive Bookreader are identical to the standard Internet Archive Bookreader:

...

  • Djatoka URL - the URL at which the Internet Archive Bookreader should be making requests to Djatoka. On a standard installation of Fedora, Tomcat and Drupal, this will be http://path.to.your.site:8080/adore-djatoka/.
  • A field that holds the page sequence numbers - the RELS-EXT field that designates the page or sequence number of a single page.

Troubleshooting/Issues

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