Cocktail - IIIF Manifest to PDF Generator

This program takes a url input from a IIIF manifest (Presentation 2 or 3) and converts to a pdf document with some 'minimal' styling options. You can set defaults within the option/parser or config.yaml file

It uses the excellent prawnpdf gem and additional functionality can be added with reference to the Prawn manual. Prawn manual Prawn Documentation

Example of input and outputs

At the V&A we have an article that presents Piccolpassso's treatise on maiolica with the IIIF manifest displayed using Universal Viewer for the page turning experience. We also have a download link for the pdf generated from the same IIIF manifest using Cocktail.

• Link to manifest: https://iiif.vam.ac.uk/collections/MSL:1861:7446/manifest.json
• Link to pdf: https://s3-eu-west-1.amazonaws.com/vanda-production-assets/static/piccolpasso_vanda_010419.pdf
• Link to V&A article showing Universal Viewer experience https://www.vam.ac.uk/articles/piccolpassos-treatise-on-maiolica

To Use Cocktail

• Install dependencies bundle install
• You can start the Command Line Interface (CLI) with bin/cocktail with flags appended for specific options.
• -u followed by manifest URL is the only required argument the rest will run with default options, specified in option/parser.

CLI Options:

• -a folio prefix (default = false). This adds 'ff.' in front of digits in image label if they match this regex /^\d+[vr]/
• -b left footer content. Starts with copyright symbol followed by the footer content.
• -c fill colour for image padding (default is black).
• -d fontpath. Path to custom ttf file (not required)
• -f Filename (default = manifest)
• -h help
• -i path to title page (default = /images/title.jpg) overwite this with your specific title image or add a specific path to the image
• -j array start. First argument for range printing (not required)
• -k array length. Second argument for range printing (not required)
• -l Landscape or Portrait (this will autocomplete so l or p will suffice. Portrait is default)
• -p Additional Padding (default = 10)
• -s Font size (default = 14)
• -t include title page (default = false)
• -u URL (Required)
• -v --configfile PATH (you can specify the path to a YAML file holding the default options)

Example CLI instructions for Presentation 2
bin/cocktail -u https://iiif.vam.ac.uk/collections/MSL:1876:Forster:141:I/manifest.json -l po -f v2test -t -s 14

Or using the config file: bin/cocktail -u https://iiif.vam.ac.uk/collections/MSL:1876:Forster:141:I/manifest.json -v config.yaml

Example Manifests:

"Codex Forster I" - Presentation 2 (best portrait) = https://iiif.vam.ac.uk/collections/MSL:1876:Forster:141:I/manifest.json

Example configuration file:

layout: 'landscape'
title: true
title_path: './images/title.jpg'
footer_content: 'Hello from config file'

To test (automated but incomplete)

• run rspec for coverage and unit tests

To test (manual end to end):

For P2 Manifest:

test2 = Cocktail.new('https://iiif.vam.ac.uk/collections/MSL:1876:Forster:141:I/manifest.json', 'portrait', 0, 14)  
test2.extract  
test2.insert_title  
test2.full_page_generation  
puts test2.manifest_version  
test2.save_as('v2test.pdf')  

Shout Outs

• How to colour a page in prawnpdf using this technique to stroke a bounding box.
• Using a configuration file with optparse