Skip to content
Andrew Hankinson edited this page Sep 8, 2015 · 54 revisions

Description

Diva.js (Document Image Viewer with AJAX) is a document image viewer designed to present multi-page documents. Using "lazy loading" methods for loading parts of a document on demand, it presents an "instant-on" method of displaying high-resolution document images, which makes it ideal for use in libraries, archives, and museums.

Version 4.0 contains many new features and improvements:

  • Support for the International Image Interoperability Framework (IIIF)
  • Book Layout view (openings with 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.

Clone this wiki locally