58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
## About
|
|
|
|
This repository contains the source code of
|
|
[al-quran.reflectslight.io](https://al-quran.reflectslight.io),
|
|
a static website for reading (and listening to) The Noble Quran.
|
|
After the website is built, the build directory consists of HTML,
|
|
CSS, JavaScript and other static assets that can be hosted by a
|
|
regular web server (eg nginx, apache, etc).
|
|
|
|
## Stack
|
|
|
|
The following languages and tools have to be installed before
|
|
the website can be built:
|
|
|
|
* Ruby 3.1, or later.
|
|
* NodeJS v18.15, or later.
|
|
* [tidy-html5](https://github.com/htacg/tidy-html5) <br>
|
|
There is a good chance there's a package available for
|
|
tidy-html5 on your operating system of choice.
|
|
|
|
## Local development
|
|
|
|
__1. Clone__
|
|
|
|
git clone https://github.com/ReflectsLight/al-quran.git
|
|
cd al-quran
|
|
|
|
__2. Install Ruby, NodeJS packages__
|
|
|
|
bundle install
|
|
npm i
|
|
|
|
__3. Build website__
|
|
|
|
# Build once
|
|
rake build
|
|
|
|
# Build whenever a change is detected
|
|
rake build:watch
|
|
|
|
__4. Start server on localhost__
|
|
|
|
rake server
|
|
|
|
## Thanks
|
|
|
|
First and foremost, Alhamdulillah.
|
|
|
|
* Thanks to the following graphic artists:
|
|
* [/src/favicon.png](/src/favicon.png)
|
|
by
|
|
[Aficons](https://freeicons.io/profile/9247).
|
|
* [RefreshIcon](/src/js/components/Icon.tsx)
|
|
by
|
|
[Muhammad Haq](https://freeicons.io/profile/823).
|
|
|
|
* Thanks to the following translators:
|
|
* English (The Clear Quran) by Dr. Mustafa Khattab
|