BiB/i

EPUB Reader on your website.

Summary

You can publish EPUB books on the web with a parmalink for each book, and you can embed it in other webpages (just like a YouTube video).

Spec.

• EPUB 3 and 2 compliant.
• Open source. (MIT license)
• Made with JavaScript. Works compatibly with all major web browsers on Mac/PC/smartphones:
  • Safari
  • Chrome, Opera, Vivaldi
  • Firefox
  • Microsoft Edge
  • Internet Explorer 11 (except opening zipped EPUB archive)

Table of Contents

1. How to setup & read/publish EPUB books (for users/publishers)

2. How to arrange development environment (for developers)

3. License

4. Special thanks

5. How to setup & read/publish EPUB books

---

BiB/i supports two ways to read/publish EPUB books:

• Read in browsers on your local machine, or
• Publish on the web, to have your books read by someone.

In either case,

1. Download BiB/i from GitHub repositoly page's right sidebar or BiB/i web site,
2. And unzip it at first.

Read in browsers on your local machine

1. Open bib/i/index.html in your browser (except Internet Explorer), and
2. Drag an EPUB book and drop it into the window.
3. That's all!

Publish on the web

Demo.

You can publish both unzipped folder and zipped EPUB archive. But using unzipped folder is highly recommended.

Publish unzipped folders (Recommended)

This is recommended. It accelarates reading experience of your readers, and is more compatible with many browsers.

1. Upload bib directory into some directory on your web server.
2. Unzip an EPUB book,
   1. Change the file extension from .epub to .zip (BOOKNAME.epub -> BOOKNAME.zip), and
   2. Unzip the file with some tool.
3. Upload the unzipped folder BOOKNAME into bib/bookshelf directory, and
4. Access to http://your.web.site/somewhere/bib/i/?book=BOOKNAME by your browser. (note that it has no extension)
5. Or embed code below into your blog entry or other webpages, and visit the entry.

<a href="http://your.web.site/somewhere/bib/i/?book=BOOKNAME" data-bibi="embed" data-bibi-style="[[ CSS for embeded BiB/i frame, as you like ]]">My Great Book Title</a><script src="http://your.web.site/bib/i.js"></script>

Publish zipped EPUB archives (Not recommended)

This is not recommended. It is slow and not compatible with Internet Explorer.

1. Upload bib directory into some directory on your web server.
2. Upload your EPUB book (ex. BOOKNAME.epub) to bib/bookshelf directory, and
3. Access to http://your.web.site/somewhere/bib/i/?book=BOOKNAME.epub by your browser.
4. Or embed code for it.

<a href="http://your.web.site/somewhere/bib/i/?book=BOOKNAME.epub" data-bibi="embed" data-bibi-style="[[ CSS for embeded BiB/i frame, as you like ]]">My Great Book Title</a><script src="http://your.web.site/bib/i.js"></script>

2. How to arrange development environment

---

Requirements

• Node.js + npm - guide: “Download the installer” (or “Installing Node.js via package manager”)

Arrangements

1. Clone this repository.
2. $ cd <the local repository>
3. $ npm install
   • installs modules in npm-modules and bower_components directories.

Development

1. $ npm start (or $ $(npm bin)/gulp)
   • builds distribution files,
   • launches a webserver and opens http://localhost:3000/bib/i/?book= in your browser,
   • watches/rebuilds changed files,
   • reloads/syncronizes browser(s).
2. Edit:
   • SCSS source file(s) of:
     • bib/i/res/styles/bibi.css are in dev-bib/i/res/styles/,
     • bib/i.css is dev-bib/i.scss.
   • JavaScript source file(s) of:
     • bib/i/res/scripts/bibi.js are in dev-bib/i/res/scripts/ (and bower_components/).
     • bib/i.js is dev-bib/i.js.
     • the extensions in bib/i/extensions/ are in dev-bib/i/extensions/.

• Following files are not processed by gulp tasks:
  • bib/i/index.html
  • bib/manifest.json
  • Files in bib/i/presets/
  • Files in bib/bookshelf/

3. License

---

BiB/i

• Copyright © Satoru MATSUSHIMA - http://bibi.epub.link/ or https://github.com/satorumurmur/bibi
• Licensed under the MIT license. - http://www.opensource.org/licenses/mit-license.php

BiB/i is including and powered by these open source softwares:

• The Elegant Icon Font ... Copyright © Elegant Themes, Inc. (Dual licensed under the GPL 2.0 and MIT license.)
• Font Awesome ... Copyright © Dave Gandy (Licensed under SIL Open Font License (OFL) 1.1)
• Material Icons ... Copyright © Material Design Authors / Google Inc. (Licensed under the Apache License Version 2.0)
• Native Promise Only ... Copyright © Kyle Simpson (Licensed under the MIT license.)
• Hammer.JS ... Copyright © Jorik Tangelder (Licensed under the MIT license.)
• easing.js ... Copyright © Dan Rogers (Licensed under the MIT license.)
• sML ... Copyright © Satoru MATSUSHIMA (Licensed under the MIT license.)

BiB/i Extension: Unzipper is including and powered by these open source softwares:

• JSZip ... Copyright © Stuart Knightley (Dual licensed under the MIT license or GPLv3.)
• base64.js ... Copyright © dankogai (Licensed under the MIT license.)

4. Special thanks

---

• KITAITI Makoto ... @KitaitiMakoto
• Shunsuke ITO ... @shunito