add README.md

This commit is contained in:
0x1eef 2022-11-01 22:46:02 -03:00 committed by Robert
parent 34c5ee2efe
commit 3bf2354243

50
README.md Normal file
View file

@ -0,0 +1,50 @@
## About
This repository contains a statically compiled website for reading The Qur'an. <br>
The website can be seen live at
[https://al-quran.reflectslight.io](https://al-quran.reflectslight.io).
## Build the website
The main components of the website's stack are:
- Ruby v3.1.2+
- NodeJS v16.16.0+
- TypeScript
- React
Both Ruby, and NodeJS are left to the reader to install. <br>
After installing Ruby, and NodeJS the website's dependencies can be installed:
```
$ ruby -S gem install bundler --no-document
$ ruby -S bundle install
$ npm i
```
The website can then be built by running:
```
$ ruby -S rake build
```
The above command will generate the static website in `./build/al-quran`.
## View the website
The website can be viewed on localhost by running:
```
$ ruby -S rake server
```
The above command will call `rake build`, and afterwards start a web server running
on `http://localhost:3000`.
## License
This software is released into the Public Domain.