Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/swzzl-com/modern-essays

Modern Essays by Various. Read here ⟶
https://github.com/swzzl-com/modern-essays

Last synced: 3 days ago
JSON representation

Modern Essays by Various. Read here ⟶

Awesome Lists containing this project

README 

        
# THE BOOK



A Gutenberg classic for book-lovers on the web. Read the book 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 Book Publishing Company for The Web.



Date of publication: January 26, 2021



### NATIVE BOOK FORMAT FOR THE WEB.



The book linked above is intrinsically responsive and will work across all browsers, all viewports, all devices, and all operating systems. See the support information [here](https://bubblin.io/support) and the full list of tested devices [here](https://bubblin.io/devices).



🤙Recommendation: The most ideal surface to read this book on is the \~9" the iPad or similar tablets with a modern web browser. 



This book is also _offline-first_. Is uses a ServiceWorker under the hood to offline itself, and no artifact or a file is needed to be downloaded to the disk to read this book without an Internet connection.



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)



Superbooks are cross-platform books—but feel free to raise an issue or submit a PR if you find an issue.



---



### THE MANUSCRIPT–AKA, 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. 



Feel free to fork, tweak or republish with new art. Translations to other languages is most welcome.



→: As part of publishing vocabulary with the Superbook format, this git repository is the `manuscript` whereas the compile and consumer-ready, distribution-ready, packaged form i.e. the `book` _lives_ on the url linked at the top.



### FULLSCREEN MODE



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 the new art must be reciprocated with credit (link) on the book to the artist.



Optionally, you can also fork this manuscript and publish your own edition of the book with your own take on it. See details below:



## FIXES, TRANSLATION TO OTHER LANGUAGES AND HACKING



#### A. TO HACK FOR FUN



Follow the below-given steps to mint your own edition. 



Choose your own typesets, art or illustrations or make a new translation in another language:



1. Fork this repository on Github,

2. Clone the forked repository,

3. Install the [Bookiza](https://bookiza.io) binaries (this step requires node and npm both),

4. `cd` and `$ npm install` the dependencies

5. Start the dev server with `$ bookiza server`



Bookiza will stitch up the manuscript and serve the book on `localhost:4567`. Open the project on your favorite editor (VSC, Sublime, Atom) and hack away!



Feel free to submit a PR or 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 share it with the community.



#### B. SUBMITTING FIXES

PRs are welcome for issues pertaining to this book (or this repository) only.



#### C. TRANSLATIONS



Translation of this manuscript to another language can earn you a copyright on the translated work. 



### SOURCE:



The scroll (or a file) of this book was sourced from [Gutenberg.org](http://gutenberg.org).



### CONTACT US



Contact us by mail only **once**. If you don't hear from us immediately then it may be because we are yet to get to yours. We receive a ton of mail. Please do not follow-up!



## 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.