Skip to content

Adds functionality to Islandora for ingesting and viewing PDF files.

License

Notifications You must be signed in to change notification settings

Islandora/islandora_solution_pack_pdf

Repository files navigation

PDF Solution Pack Build Status

Introduction

Loads all required Fedora Objects, and creates an empty collection object to accept PDFs.

Requirements

This module requires the following modules/libraries:

  • Islandora
  • Tuque
  • ImageMagick - Debian/Ubuntu sudo apt-get install imagemagick
  • ImageMagick module
    • ensure that the full path to Imagemagick's convert is specified in the Image Toolkit (admin/config/media/image-toolkit)
  • pdftotext - Debian/Ubuntu sudo apt-get install poppler-utils
  • ghostscript - Debian/Ubuntu sudo apt-get install ghostscript

Installation

Install as usual, see this for further information.

Configuration

Configuration options are found at Administration » Islandora » Solution pack configuration » PDF Solution Pack (admin/islandora/solution_pack_config/pdf) and include:

  • whether users are allowed to upload .txt files along with the PDFs, to be used for full text indexing
  • whether text streams should be extracted automatically from the PDFs using pdftotext. If enabled, the path to pdftotext should be provided
  • whether PDF/A derivatives should be created. If enabled, the path to gs (GhostScript) should be provided
  • image sizes for thumbnail and preview derivatives, as well as color spaces that should be used for generating them
  • whether the dUseCIEColor switch should be used for GhostScript. Not recommended for GhostScript versions 9.11 or higher
  • which viewer should be used

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