All Projects → internetarchive → Bookreader

internetarchive / Bookreader

Licence: agpl-3.0
The Internet Archive BookReader

Programming Languages

javascript
184084 projects - #8 most used programming language

Projects that are alternatives of or similar to Bookreader

Learn Graphql
Real world GraphQL tutorials for frontend developers with deadlines!
Stars: ✭ 586 (-1.68%)
Mutual labels:  hacktoberfest
Saleor Storefront
A GraphQL-powered, PWA, single-page application storefront for Saleor.
Stars: ✭ 591 (-0.84%)
Mutual labels:  hacktoberfest
Cordova Js
Apache Cordova JavaScript Bridge
Stars: ✭ 598 (+0.34%)
Mutual labels:  hacktoberfest
Pool
🚌 A golang general network connection poolction pool
Stars: ✭ 588 (-1.34%)
Mutual labels:  hacktoberfest
Matrix React Sdk
Matrix SDK for React Javascript
Stars: ✭ 590 (-1.01%)
Mutual labels:  hacktoberfest
Sp Dev List Formatting
SharePoint List Formatting Samples
Stars: ✭ 594 (-0.34%)
Mutual labels:  hacktoberfest
Java Sdk
🥇 Java SDK to use the IBM Watson services.
Stars: ✭ 587 (-1.51%)
Mutual labels:  hacktoberfest
Xamarin.forms
Xamarin.Forms Official Home
Stars: ✭ 5,485 (+820.3%)
Mutual labels:  hacktoberfest
Badgehub
A way to quickly add a notification badge icon to any view. Make any view of a full-fledged animated notification center.
Stars: ✭ 592 (-0.67%)
Mutual labels:  hacktoberfest
Homebrewery
Create authentic looking D&D homebrews using only markdown
Stars: ✭ 598 (+0.34%)
Mutual labels:  hacktoberfest
Rustfix
Automatically apply the suggestions made by rustc
Stars: ✭ 586 (-1.68%)
Mutual labels:  hacktoberfest
Stash
An organizer for your porn, written in Go
Stars: ✭ 591 (-0.84%)
Mutual labels:  hacktoberfest
Yupe
Yupe! is an open source Yiiframework-based online e-commerce solution. Demo https://demo.yupe.ru/
Stars: ✭ 596 (+0%)
Mutual labels:  hacktoberfest
Cardview
CardsView | CarouselView | CoverflowView | CubeView for Xamarin.Forms
Stars: ✭ 587 (-1.51%)
Mutual labels:  hacktoberfest
Graphite Web
A highly scalable real-time graphing system
Stars: ✭ 5,384 (+803.36%)
Mutual labels:  hacktoberfest
Dataverse
Open source research data repository software
Stars: ✭ 586 (-1.68%)
Mutual labels:  hacktoberfest
Authpass
AuthPass - Password Manager based on Flutter for all platforms. Keepass 2.x (kdbx 3.x) compatible.
Stars: ✭ 591 (-0.84%)
Mutual labels:  hacktoberfest
Runtime
.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.
Stars: ✭ 7,742 (+1198.99%)
Mutual labels:  hacktoberfest
Core
Simple forum software for building great communities.
Stars: ✭ 5,372 (+801.34%)
Mutual labels:  hacktoberfest
Memento
Simple + Powerful interface to the Mnesia Distributed Database 💾
Stars: ✭ 597 (+0.17%)
Mutual labels:  hacktoberfest

Internet Archive BookReader

Build Status codecov

The Internet Archive BookReader is used to view books from the Internet Archive online and can also be used to view other books.

See live examples:

Demos

See BookReaderDemo directory. These can be tested by building the source files (make sure Node.js is installed):

npm run build

and starting a simple web server in the root directory:

npm run serve

And then open http://localhost:8000/BookReaderDemo/demo-simple.html.

Usage

Here is a short example.

// Create the BookReader object
var options = {
  data: [
    [
      { width: 800, height: 1200,
        uri: '//archive.org/download/BookReader/img/page001.jpg' },
    ],
    [
      { width: 800, height: 1200,
        uri: '//archive.org/download/BookReader/img/page002.jpg' },
      { width: 800, height: 1200,
        uri: '//archive.org/download/BookReader/img/page003.jpg' },
    ],
    [
      { width: 800, height: 1200,
        uri: '//archive.org/download/BookReader/img/page004.jpg' },
      { width: 800, height: 1200,
        uri: '//archive.org/download/BookReader/img/page005.jpg' },
    ]
  ],

  bookTitle: 'Simple BookReader Presentation',

  // thumbnail is optional, but it is used in the info dialog
  thumbnail: '//archive.org/download/BookReader/img/page014.jpg',

  // Metadata is optional, but it is used in the info dialog
  metadata: [
    {label: 'Title', value: 'Open Library BookReader Presentation'},
    {label: 'Author', value: 'Internet Archive'},
    {label: 'Demo Info', value: 'This demo shows how one could use BookReader with their own content.'},
  ],

  ui: 'full', // embed, full (responsive)

};
var br = new BookReader(options);

// Let's go!
br.init();

See BookReaderDemo/demo-simple.html and BookReaderDemo/BookReaderJSSimple.js for a full example. The best way to learn how to use BookReader is to view the source of the demos.

Properties

Plugins

A basic plugin system is used. See the examples in the plugins directory. The general idea is that they are mixins that augment the BookReader prototype. See the plugins directory for all the included plugins, but here are some examples:

  • plugin.autoplay.js - autoplay mode. Flips pages at set intervals.
  • plugin.chapters.js - render chapter markers
  • plugin.search.js - add search ui, and callbacks
  • plugin.tts.js - add tts (read aloud) ui, sound library, and callbacks
  • plugin.url.js - automatically updates the browser url
  • plugin.resume.js - uses cookies to remember the current page
  • plugin.mobile_nav.js - adds responsive mobile nav to BookReader
  • plugin.vendor-fullscreen.js - replaces fullscreen mode with vendor native fullscreen

Embedding

BookReader can be embedded within an <iframe>. If you use the IFrame Plugin inside the <iframe>, the reader will send notifications about changes in the state of the reader via window.postMessage(). The parent window can send messages of its own (also via window.postMessage()) and the IFrame Plugin will handle updating the reader to match.

Message Events

Fragment Change

The Fragment Change message is sent to the parent window when the embedded BookReader moves between pages/modes. When the <iframe> receives this message, it moves to the specified page/mode. The “fragment” is formatted in accordance with the BookReader URL spec.

{
  "type": "bookReaderFragmentChange",
  "fragment": "page/n1/mode/2up"
}

Development

The source JavaScript is written in ES6 (located in the src/js directory) and in ES5 (located in BookReader). npm run serve-dev starts an auto-reloading dev server, that builds js/css that has been edited at localhost:8000.

Until the next major version bump, we have to store the build files inside the repo to maintain backwards compatibility. Please DO NOT include these files in your PR. Anything in the BookReader/ directory should not be committed.

Releases

To version bump the repo and prepare a release, run npm version major|minor|patch (following semver), then (something like) git push origin HEAD --tags. It'll automatically update the version number where it appears, build the files, and ask you to update the CHANGELOG.

Tests

We would like to get to 100% test coverage and are tracking our progress in this project: BookReader Fidelity

End to end tests

We also have end to end tests using Testcafe. We write tests for the repo itself and also for our use on archive.org. You can read about them in here. These are relatively easy to do, and a fantastic way of getting introduced to the wonders of BookReader. Check the project board for open tickets to work on. And if you don't see a test for something you spotted, feel free to make an issue.

To run all local end to end tests, run command: npm run test:e2e

To keep end to end test server on while developing, run command: npm run test:e2e:dev

Unit tests

We have unit tests and use Jest to run them. For mocks, we use Jest's internal mocking mechanism and Sinon to set spies.

To run all local unit tests, run command: npm run test

Ways to contribute

We can always use a hand building BookReader. Check out the issues and see what interests you. If you have an idea for an improvement, open an issue.

More info

Developer documentation: https://openlibrary.org/dev/docs/bookreader

Hosted source code: https://github.com/internetarchive/bookreader

IIIF (http://iiif.io) See BookReaderDemo/demo-iiif.html to see an example of how to load a IIIF manifest in BookReader.

Target Devices

Note that BookReader is a core part of Archive.org's mission of Universal Access to All Knowledge. Therefore, care must be taken to support legacy browsers. It should still work and be useable on old devices.

Areas for improvement

  • Change libraries to be NPM dependencies rather than included in the source code

See CHANGELOG.md for history of the project.

License

The source code license is AGPL v3, as described in the LICENSE file.

The mobile menu is built with mmenu, which is free for personal and non-profit use. However, for commmercial use, a license must be purchased.

To use it, include the script plugins/plugin.mobile_nav.js.

Other credits

The ability to test on multiple devices is provided courtesy of Browser Stack.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].