Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/swzzl-com/kalevala

Kalevala by Elias Lönnrot. Live Superbook:
https://github.com/swzzl-com/kalevala

Last synced: 4 days ago
JSON representation

Kalevala by Elias Lönnrot. Live Superbook:

Awesome Lists containing this project

README 

        
# THE BOOK



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



[![forthebadge](https://forthebadge.com/images/badges/built-by-hipsters.svg)](https://bubblin.io/about)

forthebadge

[](https://bubblin.io)



This book uses the [Superbook](https://bubblin.io/docs/format) format and is brought to you by [Bubblin](https://bubblin.io/about)—The Publishing Company for The Web.



Date of publication: August 24, 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](https://bubblin.io/support) and the full list of supported devices [here](https://bubblin.io/devices). 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](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://bubblin.io/cover/we-by-eugene-zamyatin#frontmatter)

[![Blueoak license](https://img.shields.io/badge/Blueoak-Council-blue.svg)](https://blueoakcouncil.org/license/1.0.0)



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](https://bookiza.io), [h2s](https://github.com/bookiza/h2s) and a few other sanitization libraries.



:point_right: 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](https://bubblin.io/blog/fullscreen-api-ipad), 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.



### CONTRIBUTIONS



Contributions are super welcome.



1. If you are good at spotting typographical errors, detect (and fix) the widows & orphans and understand how line-tracking works for texts, go ahead submit your PR.



2. This book may contain older illustrations. Feel free to replace those with new art of your own. All approved art will be reciprocated with credit (link) on the book to the artist.



Optionally, you can also fork this book and publish your own edition of the work with your own take. See details 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](https://bookiza.io) 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](http://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](https://forthebadge.com/images/badges/cc-by.svg)](https://creativecommons.org/licenses/by/4.0/)



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