Skip to content
evan magoni edited this page Sep 7, 2015 · 54 revisions

Description

Diva.js (Document Image Viewer with AJAX) is a web application for viewing documents, designed to work with digital libraries to present multi-page documents as a single, continuous item. Using "lazy loading" methods for loading parts of a document on demand, it presents a quick and efficient way of displaying many high-resolution page images from digitized books and other documents on a single web page.

Version 4.0 contains many new features and improvements:

  • Support for the International Image Interoperability Framework (IIIF)
  • Book Layout view (facing pages)
  • New plugins including Autoscroll, Page Alias, and IIIF Metadata
  • Improved development workflow (Gulp, new unit tests)
  • Numerous bug fixes and optimizations (see commits for details)

To browse through the pages within a document, simply scroll through the document panel using the scroll wheel, the scrollbar, the arrow keys or the page up/page down keys. To zoom in, either click the plus button or double-click the page you are viewing. To zoom out, click the minus button or hold control while double-clicking the current page. Change views and enter fullscreen mode by clicking the icons above the viewer pane on the upper right.

Try a demo installation here.

Setup and Installation

There are two main components to a Diva.js install:

  • An image server: IIPImage or IIIF-compatible server. The image server will send the images of the documents to Diva.js.
  • The Diva.js viewer itself. Diva is embedded in your web page and displays the images.

If using IIP Image Server, you will need to configure your web server (Apache, Nginx, or similar) to serve JSON files to the viewer. For a complete guide, see Installation.