R2D2BC

Introduction

R2D2BC is an implementation of the Readium v2 EPUB reader for the web. It is built as a modular toolkit (rather than a full-featured app) so that applications can use it to handle the EPUB-related functions while customizing the own design, user interface, and extensions.

Goals

Follow the Readium architecture specification for best interoperability
Allow maximum configurability via API methods, callbacks, code and style injection, and clear separation of functions.
Modularity
Clarity of code and ease of maintenance
Speed
Accessibility
Free and open source

The R2D2BC project intentionally includes only a base-bones demonstration user interface, and no sample content. Any implementer can add their own functionality and design without refactoring the whole project.

See below for projects that provide the necessary other elements to try it out and see it in action.

Architecture

This project implements most components of the Readium Architecture:

Implements Locator
Implements UserSettings
Implements Webpub Manifest
Implements the Readium shared models
Integrates Readium CSS
Integrates a simple Navigator for reflowable publications

Additionally, it:

Provides a decoupled Minimal UI
Provides build system optimization (Webpack)

Origins

Here is the original proposal, initiated by Aferdita Muriqi to the Readium Weekly Eng Meeting - 05/22/2019

Subsequent development of R2D2BC has been supported by DITA, Bokbasen, and CAST - which explains the D2, B, and C in the name.

Extensions and Implementations

The R2D2BC reader has been used in:

The Clusive learning environment
Bokbasen's Allbok.no and Allvit.no
The UNODC Fieldguides
The DITA Gateway D2G

Contributing

Contributions are always welcomed! Please see CONTRIBUTING for detailed guidelines.

Get Started

Download ebook examples here: https://standardebooks.org/ebooks and copy them to ./examples/epubs. Then:

npm install

npm run build && npm run examples

Then visit http://localhost:4444/. Follow the prompts to view example apps.

D2Reader