Skip to content

Bubblin-Superbooks/metamorphosis

Repository files navigation

THE BOOK

A nifty classic for book-lovers on the web. To read the book go here.

forthebadge forthebadge

This book uses the Superbook format and is brought to you by Bubblin—The Publishing Company for The Web.

Date of publication: July 9, 2019

TABLET FIRST & OFFLINE FIRST

Superbooks are naturally responsive and work on all browsers, all viewports and devices and all operating systems. See support information here and the full list of supported devices here. In general, the most ideal surface to read these books on (recommended) are the ~9" tablets like the iPad or the Galaxy Tab or Kindle Fire HD, ala 'on-web'.

This book is offline-first. Is uses a Service Worker under the hood, so no explicit download is required to read or share the book OFFLINE.

Publication: Live PRs Welcome Maintenance Blueoak license

We try and suppport cross-platform books—feel free to raise an issue or submit a PR if you face a problem.


THE MANUSCRIPT, ala this repo.

The manuscript on this repo has been generated programmatically using Bookiza Abelone, h2s and a few other sanitization libraries.

👉 As part of the vocabulary of publishing with Bookiza, this git repo is the manuscript whereas the 'consumer-ready' distributable form i.e. book is hosted live on the url at the top.

GOING FULLSCREEN

To be able to read the book in fullscreen mode, please try the following steps:

  • Open the book on iOS (> 12.00) Safari
  • Tap the ... button at bottom right of the screen to open Superbook controls.
  • Tap ⤮ on the top right (middle button) to go fullscreen.

iPadOS Safari v12.0 and above only.

CONTRIBUTION

Contributions are super welcome.

  1. There is always some room for errors to creep in. If you are good at spotting the widows & orphans, and understand how line-tracking works on a Superbook, feel free to raise a PR to help improve this book.

  2. This book may lack illustrations. Contribution of illustrations and art into this book will be returned with credits on official release of the book upon acceptance of the PR/art.

Additionally, you can also fork this book and publish your own edition with a new take or art on it. See below.

HACKING, FIXES AND TRANSLATIONS

A. HACK THE BOOK

To mint your own edition of say Pride & Prejudice (you can re-typeset, add new art or illustrations or translate to another language), follow the below given steps:

  1. Fork this repository to your own Github Account,
  2. Clone the forked project to your local,
  3. Install Bookiza globally. This requires node and npm,
  4. cd into the repo and $ npm install to install the dependencies
  5. Start the server with $ bookiza server

Bookiza will build the manuscript on project and serve it like a book over localhost:4567. Open the project on your favorite text editor (Visual Studio, Sublime) and hack away, and feel free to republish your own new edition!

If you end up creating a new avatar of this book, please leave us a note here. We love looking at interesting new takes from people across the world and will also be super happy to help you publish it online.

B. SUBMITTING FIXES

PRs are absolutely welcome, although issues pertaining to only the book on this repository may be raised here.

C. TRANSLATIONS

Translation to other languages or new takes of English itself from the original (old) script may earn you a copyright. If you fork a new edition with a translation of your own, we might consider your work for a premium publication.

SOURCE:

The scroll (or file) of this book was sourced from Gutenberg.org.

CONTACT US

Contact us by mail once if someone on our team doesn't already respond within 24 hours. Sometimes we get a lot of mail. Do not follow-up with a second mail unless absolutely necessary.

LICENSE

The body of work on this book i.e. manuscript (text, illustrations etc.) is either in public domain or is available under a Free Culture license as indicated below:

forthebadge

The sourcecode (libraries) in use for this book have been licensed by their respective owners.