Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swzzl-com/a-modern-utopia
Superbook A Modern Utopia by Herbert George Wells
https://github.com/swzzl-com/a-modern-utopia
Last synced: 4 days ago
JSON representation
Superbook A Modern Utopia by Herbert George Wells
- Host: GitHub
- URL: https://github.com/swzzl-com/a-modern-utopia
- Owner: swzzl-com
- License: other
- Created: 2018-06-18T13:07:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-06-18T14:37:59.000Z (over 6 years ago)
- Last Synced: 2025-01-13T04:40:52.565Z (12 days ago)
- Language: HTML
- Homepage: https://bubblin.io/herbertwells
- Size: 11.4 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: license.txt
Awesome Lists containing this project
README
# INTRODUCTION
A nifty read for book lovers on the web. Best experienced on the iPad / Chrome.
Brought to you by web people and [Bubblin Superbooks](https://bubbl.in/about) - an online café of books.
## TABLET FIRST
First of its kind, this manuscript (repo) renders into a responsive `tablet-first` book. The manuscript has been generated programmatically using `nodejs` and `bookiza` and outputted as plain HTML, CSS and JavaScript i.e. building blocks of web. Live book (demo) is available on the url provided at the top.
Read a timeless classic on web and share it generously with your friends. It's FREE! In fact please help us spread the word by sharing this book in your network - especially among children.
## SUPPORT
Best experienced on 9" iPad but works (nearly) everywhere - iPhones, Android phones & tablets, Kindle Fire HD, desktops, TVs, laptops. See [details](https://bubbl.in/support) for more information.
:point_right: Research suggests that books (both physical and electronic) are best experienced on 9" tablets.
We hear you Steve Jobs, we hear you still!
## THE MANUSCRIPT
This repo is the manuscript while the actual compiled book is hosted and rendered live on the writer's url at the top.
## RECOMMENDED DEVICE/BROWSER:
Apple iPad + Google Chrome. You can also do the following:
- Open the on iOS Safari (or your favorite browser). Start reading…
- Tap the `Share` button at the top of the screen.
- Tap `Add to Home Screen`… if you like that sort of a thing.
### HACK IT IN YOUR OWN STYLE
Feel free to clone this manuscript and play with it. You can modify its content, layout or make fresh artwork (imagery) of your own for it and republish. If you do make something please tell us about it. We love looking at interesting work from people and might even share it with our community!
How:
```
$ git clone && cd
$ npm install
$ bookiza server
```
Bookiza server will compile the manuscript and open the book on `localhost:4567`.
Read about [node](https://nodejs.org/en/), [bookiza](http://bookiza.io) and [bubblin](https://bubbl.in) to get started.
### PROJECT
This app was created using [bookiza](https://bookiza.io) -- a "book baking" tool.
The TREE of the manuscript looks somewhat like this:
```
PROJECT/
├── README.md
├── assets
│ ├── css
│ ├── images
│ └── scripts
├── cover
│ ├── back.jpg
│ ├── cover.psd
│ ├── front.jpg
│ ├── spine.jpg
│ └── spine.psd
├── license.txt
├── manuscript
│ ├── page-1
│ │ ├── body.html
│ │ └── style.css
│ ├── page-2
│ │ ├── body.html
│ │ └── style.css
│ ├── page-3
│ │ ├── body.html
│ │ └── style.css
│ ├── page-4
│ │ ├── body.html
│ │ └── style.css
│ ├── page-5
│ │ ├── body.html
│ │ └
│ ├──
│ │
│ │
│ ├──
│ │
│ │
│ ├── page-2N-1
│ │ ├── body.html
│ │ └── style.css
│ └── page-2N
│ ├── body.html
│ └── style.css
├── templates
│ ├── head.html
│ ├── style.css
│ ├── body.html
│ └── script.js
└── trash
```
## CREDITS:
This manuscript was licensed via [Gutenberg](http://gutenberg.org)
Please read license terms of other softwares/libraries and their respective owners who have contributed directly or indirectly into this project.
## CONTRIBUTION/FIXES
Feel free to report issues or submit fixes to help improve the code.
1. Fork it using `git`.
2. Create your feature branch (`git checkout -b my-new-page`)
3. Commit your changes (`git commit -am 'Added a page on (/topic)'`)
4. Push to the branch (`git push origin my-new-page`)
5. Create a new Pull Request
6. Contact me if I/someone on my team doesn't respond within 24 hours. I get a lot of mail, so do not follow-up with a second mail before 24 hours.
## Licenses
Various! But, primarily:
[](https://www.mozilla.org/en-US/MPL/2.0/)