Scribd
Upload
51 views25 pages

A Page-Turning Document Viewer For Dspace Using Flexpaper: Terry - Brady@Georgetown - Edu

This document discusses adding a page-turning document viewer called FlexPaper to DSpace to allow users to view digitized special collections materials. It describes initially adding a "Book View" option for PDFs, but then outlines challenges around large file downloads, inconsistent page orientations, and irregular page sizes in some materials. Solutions developed include pre-compiling assets, using a desktop viewer for mixed orientations, and disabling the viewer for irregular page sizes. Lessons learned include digital assets being more complicated than expected and the need to pre-process all assets before deployment. Future plans include exploring IIIF-based viewers and storing derivative resources on an image server.

Uploaded by

Cristobal Miusen Caris
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PPTX, PDF, TXT or read online on Scribd
51 views25 pages

A Page-Turning Document Viewer For Dspace Using Flexpaper: Terry - Brady@Georgetown - Edu

This document discusses adding a page-turning document viewer called FlexPaper to DSpace to allow users to view digitized special collections materials. It describes initially adding a "Book View" option for PDFs, but then outlines challenges around large file downloads, inconsistent page orientations, and irregular page sizes in some materials. Solutions developed include pre-compiling assets, using a desktop viewer for mixed orientations, and disabling the viewer for irregular page sizes. Lessons learned include digital assets being more complicated than expected and the need to pre-process all assets before deployment. Future plans include exploring IIIF-based viewers and storing derivative resources on an image server.

Uploaded by

Cristobal Miusen Caris
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PPTX, PDF, TXT or read online on Scribd
You are on page 1/ 25

A Page-Turning Document Viewer for

DSpace using FlexPaper


Terry Brady
[email protected]
https://github.com/terrywbrady/info
Need
Page-turning viewer for digitized special
collections material
Preferably showing 2 pages, side-by-side
Prior solution
Prior solution was flash-based
Did not deploy well under https
Required vendor coordination for each DSpace
upgrade
No access to source code
Annual maintenance cost
FlexPaper: http://flexpaper.devaldi.com/

Very attractive viewer


Reasonable cost
Flexible viewer options:
● html5, html4, flash
● dynamic rendering and pre-compiled
● desktop and server compilation of resources
Flexible, and confusing to understand
Solution 1
Add “Book View” Option for PDF Bitstreams
JavaScript rendering

$('#documentViewer').FlexPaperViewer(
Invoke Viewer

{ config : {
Path to PDF
PDFFile : loc,
HTML5 Viewer
RenderingOrder : 'html5',

key : '<<License key goes here>>',


License Key

}}
Initial Results
● Beautiful display
● Easy integration
● PDF is accessed from DSpace
○ Embargo/restrictions honored
Challenge 1: Large file download
Solution 2: Pre-compile high-demand materials
Viewer assets loaded page by page

● Create pre-compile folder

● pdftk - break pdf into one page pdf’s

● convert - convert each pdf page into thumbnail

● pdf2json - extract search terms

● sed - generate static index.html


Pre-compiled Asset Storage
● Assets needed to reside in one directory
○ assetstore could not be used.
● Assets served up by Apache, not tomcat
● No awareness of item/bitstream restrictions
○ By policy, PDF’s under embargo could not be pre-
compiled.
Reference pre-compiled assets
$('#documentViewer').FlexPaperViewer(
{ config : {
JSONFile : '/bookview/HANDLESEQ/link.pdf_{page}.js',
Pre-compiled
PDFFile : '/bookview/HANDLESEQ/link_[*,2].pdf',
Assets ThumbIMGFiles : '/bookview/HANDLESEQ/link-{page}.jpg',
RenderingOrder : 'html5', HTML5 Viewer
License Key key : '<<License key goes here>>',
}}
);
Challenge 2: Inconsistent
Page Orientation
Flexpaper HTML5 viewer normalizes page
dimensions
Solution 3: Compile irregular page
orientation materials on desktop
Flash-based desktop viewer
Built a tool to identify mixed-orientation PDF’s
Problem 3: Irregular page
sizes
Digitized material containing page fragments
Actual Page Sizes
Solution 4: Turn off viewer for irregular
page size items
Results
● Beautiful viewer
● Easy to integrate
● Imperfect Solution
○ More exceptions than expected
Lessons learned
● Use cases are more complicated than
expected
○ Often in the assets that are most desirable to see in
a viewer
○ We should have pre-processed every asset before
production deployment
Plans for the future
Need to think bigger
● Explore IIIF based viewer solutions
● Derivative resources will reside on image
server
DSpace Wiki Page: FlexPaper Document Viewer for XMLUI
Terry Brady
Georgetown University Library
[email protected]
https://github.com/terrywbrady/info

You might also like