Islandora Paged Content

Overview

The Islandora Paged Content module is required by the Book Solution Pack and Newspaper Solution Pack modules, to provide numbered, individual pages as objects. This module takes files in TIFF format, and is able to create several kinds of derivatives depending on the type of collection they are being ingested into. Solution Packs that use the Paged Content module are referred to below as 'Paged Content collections'.

Dependencies

• The Large Image Solution Pack is required to create image derivatives
• Ghostscript is used to compile PDF derivatives into a single document
• Core Collection Solution Pack

Provisions

• The Book Solution Pack or Newspaper Solution Pack are examples of Paged Content collections. It is advisable to install one of those solution packs, and check their pages for additional dependencies.

Downloads

Release Notes and Downloads

Usage

Adding a collection that uses the Paged Content module (such as Book and Newspaper Solution Pack) adds a new button to the end of the 'Manage' tab - 'Book', for the Book Solution Pack, and 'Newspaper' for the Newspaper Solution Pack, for example. It also adds a 'Page' button to the 'Manage' tab of any page objects added to a Paged Content collection. Clicking on this button will bring up several options, depending on what components of the module are selected and enabled:

• Add Page - This brings up a page that uses the TIFF uploader form in conjunction with Tesseract to allow you to choose the file and language of your page, and add it to the parent Paged Content collection.
• Create PDF - This section includes the ability to create either a single page PDF if selected from a single page's 'Manage' tab, or a PDF of an entire Paged Content collection if selected from the collection's 'Manage' tab. The resolution of the image can also be set here. Creating a PDF will overwrite any existing PDF datastream.
• Perform OCR - This section includes the ability to create OCR datastreams for a single page if selected from that page's 'Manage' tab, or OCR datastreams for an entire Paged Content collection if selected if selected from the collection's 'Manage' tab. If multiple languages are installed into Tesseract, the option to switch between them will also be given here. Creating new OCR datastreams will overwrite any existing ones.
• Create Images - This section adds the option to create image derivatives if the Large Image Solution Pack is installed. Any existing image derivatives will be overwritten if this is used. If this option is selected from a Paged Content collection, the option will be given to create a thumbnail image for the collection from the first ordered page, updating and overwriting any existing thumbnail.
• Reorder Pages - This section allows a user to re-order the pages in a Paged Content collection if they are not in their correct place.
• Delete Pages - This section allows a user to remove pages from a Paged Content collection.

Configuration

Few configuration options exist for the paged content module out-of-the-box; most of the configuration is associated with the relevant, dependent solution pack (book or newspaper).  A configuration page  at http://path.to.your.site/admin/islandora/paged_content, and includes the following options:

PDF Derivative Settings

Enter the path to the Ghostscript executable here. This will allow multi-page PDFs to be compiled using each page in the book or newspaper. More information about installing Ghostscript on your server can be found at the official project website, http://www.ghostscript.com/.

Content Models, Prescribed Datastreams and Forms

The Paged Content Solution Pack comes with the following objects in http://path.to.your.site/admin/islandora/solution_pack_config/solution_packs:

• Islandora Page Content Model (islandora:pageCModel)

A page image ingested into a Paged Content collection using ImageMagick, the Large Image Solution Pack and the Islandora OCR modules, will have the following datastreams:

The Paged Content Solution Pack does not come with any forms.