Skip to content

d-i-t-a/R2D2BC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

afba140 · Aug 12, 2024
Oct 23, 2023
Apr 20, 2022
Oct 9, 2022
Sep 11, 2022
Aug 12, 2024
Feb 20, 2024
Dec 9, 2021
Apr 13, 2021
Jan 17, 2023
Aug 5, 2021
Apr 12, 2021
Aug 5, 2021
Aug 12, 2020
Jun 22, 2020
Apr 20, 2022
Jun 22, 2020
Apr 20, 2022
Jun 18, 2020
Jan 31, 2024
Aug 12, 2024
Aug 12, 2024
Aug 10, 2022
Aug 14, 2020
Jan 22, 2022

Repository files navigation

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.

Features & Functionalities

  • ePub Reflowable + Fixed Layout
  • Reader Settings
  • Configurable Modules with Callbacks
  • Injectable Fonts, CSS, Javascript
  • Text Selection with Injectable Context Menu
  • Bookmarks
  • Highlights
  • Annotations
  • TTS - Text to speech / Read Aloud
  • Media Overlays - Read Along
  • Search
  • Content Protection
  • Definitions
  • Popup Footnotes
  • Page Breaks - Page Numbers in margin
  • Sample Read
  • Timeline
  • Layers
  • Line Focus (Beta Feature)
  • Popups and Popovers

Extensions and Implementations

The R2D2BC reader has been used in:

  • The Clusive learning environment
  • Bokbasen's Allbok.no
  • Allvir's Allvit.no Reading Platform
  • The UNODC Fieldguides
  • The DITA Gateway D2G with several open collections
  • Ekitabu's Web Reader Implementations through Dita Gateway
  • NYPL's Web Reader Implementations
  • Bibliotheca's CloudLibrary as Sample Reader and Full ePub Reader
  • Above the Treeline's Edeweiss+
  • Bluefire's Web Reader Implementations
  • In a Project in the Meta Verse (to be named once public)
  • and a few more... :)

Contributing

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

DepShield Badge

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.

WIKI

Migration Guides

Change Log

Supporters