al-quran.reflectslight.io/README.md

2.5 KiB

https://al-quran.reflectslight.io

This git repository contains the source code of a statically compiled website for reading The Quran. After the website is compiled, it consists of HTML, CSS, JavaScript and other static assets that can be hosted on a regular web server. The repository is optimized for nginx, and (Free|Open)BSD as a deployment target. The source code is a mixture of Ruby, TypeScript, and JavaScript with React being the driving force on the frontend.

Open Source

The source code is released under the terms of the GNU Public License (GPL). No restrictions are placed on the right to modify, copy, redistribute or host the website on a web server / domain of your own as long as it is done in accordance with the GPL. See LICENSE for a copy of the license, and see TLDRLegal for a short summary of the GPL.

Local install

1. Clone repository

git clone https://github.com/ReflectsLight/al-quran.git
cd al-quran

2. Check dependencies

The bin/check-dependencies script will check that the required dependencies are available: Ruby, NodeJS, nginx, et cetera.

$ ./bin/check-dependencies

Assuming it was a success:

found: ruby
found: bundle
found: node
found: npm
found: nginx
found: doas

Otherwise, the dependencies that are missing will be listed. All dependencies should be found before proceeding to the next step.

3. Install packages

At this step we're ready to install Ruby, and NodeJS packages:

$ npm install
$ bundle install --path=.bundle/

Credits

Credit is due to a number of graphic artists whose work is used by this project, and with thanks I credit the following graphic files to their respective authors:

Credit is due to the people who translated The Quran from Arabic to other languages, and with thanks I credit the following translations to their respective authors:

  • English (The Clear Quran) by Dr. Mustafa Khattab