mirador-pdf-plugin

A Mirador 3 plugin that adds a Download PDF option to the window top-bar menu. It connects to an external PDF download service and allows users to optionally specify a page number or range before downloading.

Features

• Adds a Download PDF menu item to the Mirador window top-bar plugin menu
• Opens a dialog where users can optionally enter a page number (e.g. 5) or a range (e.g. 5-10)
• Validates page input against the total number of pages in the manifest
• Constructs the correct download URL from a configurable API base URL and the manifest's URN
• Opens the download in a new browser tab

Requirements

• NVM
• Mirador 3

Setup

1. Run npm i to install dependencies
2. Use one of the NPM scripts to perform the actions described below.

NPM scripts

The following are some useful scripts that can be run using npm run <script>. A full list can be seen in package.json.

| Script | Description | | ------- | -------------------------------------------------------------- | | clean | Removes the dist directories | | build | Builds the source files into the ./dist directory | | serve | Spins up the local development server at http://localhost:9000 | | test | Runs the test suite |

Installing in Mirador

The mirador-pdf-plugin requires an instance of Mirador 3. Visit the Mirador wiki to learn how to install an existing plugin and for additional information about plugins.

Install the package:

npm i @harvard-lts/mirador-pdf-plugin

Configuration

Pass a miradorPdfPlugin object in your Mirador config block:

import Mirador from 'mirador/dist/es/src/index';
import Plugin from '@harvard-lts/mirador-pdf-plugin';

Mirador.viewer(
  {
    id: 'mirador',
    windows: [
      { manifestId: 'https://example.com/URN-3:FOO:BAR:MANIFEST:1' }
    ],
    miradorPdfPlugin: {
      pdfAPI: 'https://your-pdf-service.example.com/pdf/download/',
    },
  },
  [...Plugin]
);

Config options

| Option | Type | Description | | -------- | ------ | ------------------------------------------------ | | pdfAPI | String | Base URL of the PDF download service (required). |

URL construction

The plugin derives a URN from the manifest ID by stripping the protocol, hostname, and any :MANIFEST suffix. It then builds the download URL as:

<pdfAPI>/<URN>
<pdfAPI>/<URN>?page=5
<pdfAPI>/<URN>?start=5&end=10

Contribute

Mirador's development, design, and maintenance is driven by community needs and ongoing feedback and discussion. Join us at our regularly scheduled community calls, on IIIF slack #mirador, or the mirador-tech and iiif-discuss mailing lists. To suggest features, report bugs, and clarify usage, please submit a GitHub issue.