BookReader



Latest version

Yuzu is a learning platform that lets you read and interact with digital content. BENEFITS OF eTEXTBOOKS ON YUZU Interactive Learning - eTextbooks can include videos and other multimedia content and links to related websites, to make the learning experience richer and more engaging. Travel Lighter - Replace multiple textbooks with one app where. The University of New Hampshire Library provides students, faculty, staff, and community members with research help as well as access to resources, spaces, and tools for success. The eBook Reader.com is an organized, informative resource for everything about the world of electronic book readers, from dedicated ereaders like Kindles. BookReader is a free multiplatform program (also available for Mac), that belongs to the category Education & Reference and subcategory Books and that has been published by Alex Drel. More about BookReader. Since we added this program to our catalog in 2016, it has obtained 38 downloads, and last week it gained 2 downloads.

Book reader app

Released:

A Django book reading application that utilizes Djatoka and a DSpace repository to present browseable views of scanned books.

Project description

Introduction

This is a book reading UI application for items that have been deposited in aDSpace repository that has the OAI-PMH repository views enabled.

Using the bookreader

Installation

Package

Install the bookreader Python package by doing one of the following:

  • Adding it to your list of eggs in buildout.cfg and running bin/buildout
  • Use easy_install bookreader to install it globally
  • Download the source code, unpack it and run python setup.py install

Django

Bookreader online

In your project’s settings.py, add bookreader to the list of INSTALLED_APPSand run manage.py syncdb to add the tables to the database. Then includebookreader.urls in your url patterns. Last, you will need to add the baseURL for your Djatoka server in your settings file as DJATOKA_BASE_URL.

Administration

The bookreader uses the Django admin interface for the manipulation of the data.First, you must add a Repository. The only input required is the OAI-PMH serverurl of your DSpace repository. Using that url, Django will connect to the serverand query for its name. Then collections can be added by DSpace handle. Once ahandle is entered, Django will query the server to validate that it is a validhandle and query for the name of the collection. At this point, it will also queryfor all books (items) in the collection and harvest the metadata and pages forthose books. This automatic behavior can be disabled by settingBOOKREADER_SIGNALS_ENABLED to False in your settings.

DSpace Requirements

Item and Bitstream Layout

For the use case of this Django UI, books are DSpace items and pages arebitstreams attached to those book items. The page bitstreams must be JPEG2000files in the ‘ORIGINAL’ or main content bundle. Thumbnails can be provided foreach page by adding a jpeg file in a ‘THUMBNAILS’ bundle that has the same basefilename as the original page bitstream. For example, if the page bitstreamfilename is tamu_pl_0001.jpf then the thumbnail must end with tamu_pl_0001.jpg.In this case thumbs/tamu_pl_0001.jpg would also be acceptable.

OAI-PMH Repository

Easy Reader Books Printable

In order for the data be harvested, the DSpace OAI-PMH server must have theORE and DIM metadata prefixes enabled and compatible crosswalks installedfor the books.

Metadata Fields

DIM data

The DIM metadata prefix is used to gather the book (item) metadata. The fieldsare harvested using the pyoaiMetadataReaderthat is extended in the Python dspacelibrary, NestedMetadataReader. XPath evaluators are used to map xml elementsto fields. For the current mapping, see bookreader.harvesting.metadata.dim_reader.

ORE data

The ORE metadata prefix is used to gather the page and link (bitstream) metadata.The bitstream URL, title, and bundle are all gathered from the ORE xml document.

Canonical Items

Starting with version 0.3, a new canonical items requirement was added. Thelist of bitstreams is checked for an additional bitstream in the ‘METADATA’bundle that is named bitstream_metadata.xml. This file is then parsed fora repository url of a canonical version of the book as well as additionalmetadata about the page bitstreams so that missing pages can be marked forfuture reference/use. See the schema at docs/bitstream_metadata.xsd for morereference on the format.

History

1.0 (2011-07-07)

BookReader
  • First official version
  • Compiled PDFs for frankenbooks and other copies
  • Bug and error fixes

0.9 (2011-03-29)

  • Switching to a ‘type’ field to support multiple book forms (canonical,franken, extant and work). South data and schema migrations provided.
  • Detailed pages view now supports a jp2 url in the request to select thecurrent page
  • Added SWORD client configuration parameters to the repository
  • Switched URL to base_url and oai_path for OAI client to match the changes inthe DSpace client
  • Added published flag to books
  • Added view to publish books over SWORD
  • Added ability to add books (except for extant books)

0.8 (2010-12-02)

  • Added South integration with the initial migration based on version 0.7
  • Added is_canonical attribute to accommodate feature requests
  • Updated CanonicalSelectionForm to use new is_canonical attribute
  • Tests for canonical flag in bitstream metadata files
  • Added a PageURLForm for editing only page urls
  • Added a URL for accessing the page editing view with the new PageURLForm
  • Added admin list_filter for collection when viewing books
BookReader

0.7.1 (2010-11-15)

  • Bugfix: harvesting missing pages was creating too many pages

0.7 (2010-11-12)

  • Added a redirecting print view
  • Fixed print url to the new printable view
  • Reading view now enforces a more ‘reading’ like interaction: front cover,pages, then back cover
  • Cleaned up extra imports
  • Added sequence and internal fields to page form
  • Changed Exterior Page form to be page conversion form
  • Added external_views property to book objects
  • Changed edit-external url to be conversion url
  • Clarified harvesting code on missing books a bit
  • Added an exterior editor view, page adding view only sets page sequence ifit isn’t in the incoming form
  • Harvesting pages without a bitstream_metadata.xml forces all pages to beinternal
  • Modified the canonical selection form so that canonical link can be removed

Ebook Reader Mac

0.6.1 (2010-11-02)

  • Bug fix for book pages view when no sequence/page set

0.6 (2010-11-02)

  • Added Exterior page form, Canonical selection form, and annotation form
  • Made canonical attribute of books be editable
  • Fixed holdover rtf->rft attribute bug in template tag
  • Added views/urls: book annotations, edit canonical, copy annotations, editexterior page, add/edit/delete annoations
  • Added CSRF wrappers to posted views

0.5 (2010-10-27)

  • Added various editor views (edit pages, add page, edit page, order pages,delete page)
  • Added a page annotations view, fixed a bug with the page view
  • Added bitstream_metadata view to export bitstream_metadata files
  • Added a page form
  • Added necessary url configurations for new views
  • Added an Annotation model
  • Added an Internal flag to pages
  • Updates to harvesting and tests for newer bitstream_metadata format

0.4 (2010-09-29)

  • Add a setting for the url arguments for books to compare,BOOKREADER_COMPARISON_GET_ARGUMENT
  • Add a setting for the session key for storing books to compare,BOOKREADER_COMPARISON_SESSION_KEY
  • Add a setting for the template variable for the books to compare,BOOKREADER_COMPARISON_TEMPLATE_VARIABLE
  • Add a context processor for turning book id’s into books, prefers GETarguments over session variable for bookmarkability
  • Add template tags for adding/removing/retrieving get arguments for comparisons
  • Add views for adding to/removing from/clearing the comparison list
  • Add separate view for a comparison portlet
  • Updated the bitstream_metadata.xsd and the detailed page harvesting to match
Book reader magazine

0.3 (2010-09-14)

  • Added canonical field to Book model
  • Made jp2 url field on Page model optional (support for ‘missing’ pages)
  • Made title field on Page model optional (support for ‘missing’ pages)
  • Added python logging support with a default null handler
  • Added a parser for the bitstream metadata file
  • Added a custom lxml etree parser since the default is now to disable network
  • Switched loading pages and loading links signals to be on creation of books only

0.2 (2010-08-23)

  • Switching data model to one where books are items and the pages are justrepresented by bitstreams.
  • Harvesting of books in a collection
  • Harvesting of pages in a book
  • Signal for loading repository names from the repositories
  • Signal for loading collection name from the repository
  • Signal for loading books in a collection from the repository
  • Signal for loading book metadata from the repository
  • Signal for loading pages from the repository

0.1 (Unreleased)

Bookreader Online

  • Books and pages generated from Manakin views of a DSpace repository wherepages are items and the bitstreams are the jpeg2000 files for the pages.

Release historyRelease notifications | RSS feed

1.0

0.9

0.8

0.7.1

Bookreader Mac

0.7

0.6.1

0.6

0.5

0.4

0.3

Book Reader Download

0.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for bookreader, version 1.0
Filename, sizeFile typePython versionUpload dateHashes
Filename, size bookreader-1.0.tar.gz (42.2 kB) File type Source Python version None Upload dateHashes
Close

Hashes for bookreader-1.0.tar.gz

Book Readers Electronic

Hashes for bookreader-1.0.tar.gz
AlgorithmHash digest
SHA256e06bf086632b9c2d20b51a40314343a90f1e60fd263a4563674aa1e6291616a7
MD523a7b28fef9f0c86821cb9ac38d75ce7
BLAKE2-25697b2a057df7dbcec097d574f856ea7a7cd9f62b40fe8d2407698cae3c9a1bcb7