Overview
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
- Libraries API with the bookreader library installed
- Islandora
- Tuque
- Djatoka
- Islandora Solr Search should be used to organize the book via RELS-EXT and designate an OCR data stream (Optional)
Provisions
Downloads
The Islandora Internet Archive Bookreader module can be found on the Release Notes and Downloads page.
...
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:
...
- Under Book Viewers, select Internet Archive BookReader.
- Under Page Viewers, select OpenSeaDragon.
- Click Save Configuration.
Usage
Controls for the Islandora Internet Archive Bookreader are identical to the standard Internet Archive Bookreader:
...
- Link to the front page of the book
- Another link to the cover
- Search field that is able to look through the OCR datastream of the book object
- Button to initiate an OCR search from the text field
- Button to have the pages automatically and methodically flip to the next one after a short period of time
- Button showing basic MODS information
- Button to view the OCR output for the current page
- Button to generate URL links to share the book
- The actual book's viewing pane
- A slider to quickly switch between pages
- Button to view a single page at a time
- Button to view two pages side by side, like a standard physical book
- Button to view all pages in a grid layout
- Zoom controls (in and out)
- Button to hide the bottom-most navigation pane
- Controls to move to the next or previous page
Configuration
Configuration options for the Islandora Internet Archive Bookreader can be found:
- in the admin page for the Bookreader (admin/islandora/islandora_viewers/internet_archive_bookreader)
- in the admin page for OCR tools (admin/islandora/tools/ocr)
- in the admin page for the Islandora Book Solution Pack (admin/islandora/solution_pack_config/book)
- and in the admin page for the Paged Content Module (admin/islandora/solution_pack_config/paged_content).
Internet Archive Bookreader Configuration
To configure the Internet Archive Bookreader, go to Administration > Islandora > Islandora Viewers > Internet Archive Bookreader (admin/islandora/islandora_viewers/internet_archive_bookreader).
Configuration Options
Field | Default Value | Explanation |
---|
djatoka image compression level | 4 | The level of compression djatoka will use when creating images (usually set at 4 or 5). |
Solr field relating pages to book PIDs | RELS_EXT_isMemberOf_uri_ms | This field is necessary to allow the "Search inside" option in the IAV to search across the full text OCR datastreams of all pages associated with this book. Enter the solr field that indexes the relationship that associates Islandora Page objects with Islandora Book objects. |
Overlay Opacity | 0.5 | The opacity of the overlay, when opening the info, fulltext and share dialogs. Enter a decimal number between 0 (fully transparent) and 1 (fully opaque). |
The content type being displayed within the IAV. | book | This will be displayed in the viewer in places such as the info and share dialogs. |
Default page view | Single page | The number of pages the IAV will show by default. Options are Single page, Side by Side (2 pages), or Thumbnails (all pages). |
Force the Internet Archive Bookreader into full screen for mobile users? | unchecked | Checking this will make book objects full screen by default on mobile devices. |
Use the JPG datastream as a backup. | unchecked | This option can slow a site down, so use it only if necessary. The viewer usually loads JP2 derivatives, but it won't return a JP2 that is smaller than 4096 bytes. If you have a collection with JP2 derivatives smaller than the minimum size, or no JP2s, select this option to use JPG derivatives as the page image instead. |
Troubleshooting/Issues
Having problems or solved a problem? Check out the Islandora google groups for a solution.
...