Islandora PDF.js

Introduction

An Islandora viewer module using Mozilla PDF.js.

Requirements

• Islandora
• Tuque
• PDF.js

Installation

Install as usual, see this for further information.

You also need to Download and install the generic build of PDF.js and move the directory to sites/libraries/pdfjs folder, or run drush pdfjs-plugin.

Note: If you use the Drush command, ensure that your .drush directory contains the install script islandora_pdfjs.drush.inc. If it doesn't, move (not copy) the script from the islandora_pdfjs module's root directory to your .drush folder before you run the drush command.

Configuration

Currently the PDF.js viewer can be used as the viewer for the PDF Solution Pack, Book Solution Pack, and Scholar Solution Pack.

• PDF Solution Pack
  • Administration » Islandora » Solution pack configuration » PDF Solution Pack (admin/islandora/solution_pack_config/pdf).

This is what the PDF frame looks like with the Islandora PDF.js viewer enabled.

• Book Solution Pack (both the book and the page object are options)
  • Administration » Islandora » Solution pack configuration » Book Solution Pack (admin/islandora/solution_pack_config/book).
    
    

• Scholar Solution Pack
  • Administration » Islandora » Solution pack configuration » Scholar (admin/islandora/solution_pack_config/scholar).

Troubleshooting/Issues

• Ensure that the PDF.js library is installed in /sites/all/libraries/pdfjs
• If enabled as the default viewer for the Book Solution Pack, you need to ensure that there is a PDF datastream in the Book object. This PDF can be generated automatically at the time of ingest or you can manually upload your own PDF file to the Book object.
  
• The PDF.js site provides a list of supported browsers that implementers may want to consult should there be rendering issues.