Read and listen to The Noble Quran from your browser
Find a file
2024-01-31 07:06:17 -03:00
.bundle Add opengraph 2023-10-05 02:36:47 -03:00
.github Add Nanoc::Filters::Tidy 2023-10-07 19:29:52 -03:00
.husky Further UI improvements 2023-10-30 02:34:35 -03:00
nanoc seo-related changes 2024-01-03 15:55:21 -03:00
packages Add option to provide 'RequestInit' to items that use fetch 2023-10-08 06:31:29 -03:00
src Drop height (for iOS) 2024-01-31 07:06:17 -03:00
tasks Fix build 2023-12-14 22:14:11 -03:00
.babelrc add TypeScript / React related configuration files 2022-10-31 15:35:43 -03:00
.editorconfig .editorconfig: update 2023-03-17 00:16:43 -03:00
.env.sample Fix GitHub build 2023-03-10 06:13:49 -03:00
.eslintrc.js Disable conflicting eslint rules 2023-07-13 14:11:07 -03:00
.gitignore Update .gitignore 2023-10-05 02:43:04 -03:00
.gitmodules add ruby-related files 2022-10-31 15:36:25 -03:00
.prettierignore eslint & prettier setup 2022-11-11 16:09:33 -03:00
.prettierrc Abide by 80col limit 2023-10-28 12:14:40 -03:00
.projectile Add AudioControl 2023-10-13 00:37:16 -03:00
.rubocop.yml rubocop: add linter.rake 2023-07-25 14:19:00 -03:00
Gemfile Add lock to avoid builds running in parallel 2023-12-04 02:08:30 -03:00
Gemfile.lock Add lock to avoid builds running in parallel 2023-12-04 02:08:30 -03:00
LICENSE License = GPL 2023-03-11 11:42:30 -03:00
nanoc.yaml Move "lib/" to "nanoc/lib/" 2023-07-21 13:26:26 -03:00
package-lock.json Add 'url' to package.json 2023-10-13 00:37:16 -03:00
package.json Add 'url' to package.json 2023-10-13 00:37:16 -03:00
Rakefile.rb Fix "rake server" 2023-07-27 11:34:15 -03:00
README.md favicon.png has changed 2023-11-20 16:20:53 -03:00
Rules Replace filters/tidy.rb with nanoc-tidy.rb (rubygem) 2023-11-07 01:59:45 -03:00
tsconfig.json WebPackage -> Packet 2023-06-21 19:58:31 -03:00
VERSION v0.7.9 2023-12-14 22:14:11 -03:00
webpack.config.js WebPackage -> Packet 2023-06-21 19:58:31 -03:00

About

This repository contains the source code of 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
    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:

  • Thanks to the following translators:

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