Skip to content

sayyidsh/diva.js

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

diva.js - Document Image Viewer with AJAX

Description

Diva.js (Document Image Viewer with AJAX) is a Javascript frontend 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 hundreds (or even thousands) of high-resolution page images from digitized books and other documents on a single web page. Written as a jQuery plugin, diva.js requires the jQuery Javascript library, along with several jQuery plugins and the jQuery UI, all of which are included. On the backend, the images will be served by IIPImage server after processing, and the image information will be sent, in JSON format, through an AJAX request by a PHP script (also included).

Installation and setup

Setting up the document viewer comes in two parts: the jQuery plugin on the frontend, and the tile image server and PHP script on the backend.

Setting up the frontend

Download the contents of this repository, using git clone git://github.com/DDMAL/diva.js.git, or downloading the zip or compressed tar packages. The included example.html file gives an example of how the document viewer can set up. For more, see Setup and installation - Configuring the frontend.

Setting up the backend

Setting up the backend requires access to a server capable of running IIPImage as well as PHP. For more, see Setup and installation - Setting up the backend.

Getting help

Help for diva.js is available through this repository's wiki, in the form of code documentation, installation instructions and usage tips.

Let Us Know

We're developing Diva.js as part of our research in Distributed Digital Music Libraries. If you use it in your project, it would be great if you could let us know.