2024-10-17 04:57:13 +02:00
|
|
|
## About
|
|
|
|
|
|
|
|
This repository contains a port of the
|
|
|
|
[al-quran.reflectslight.io](https://al-quran.reflectslight.io)
|
|
|
|
website for the mobile operating system
|
|
|
|
[KaiOS](https://www.kaiostech.com/).
|
|
|
|
The project is still in the early stages of development.
|
|
|
|
|
2024-10-18 04:37:56 +02:00
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
**SurahIndex.tsx**
|
|
|
|
|
2024-10-22 05:57:35 +02:00
|
|
|
![SurahIndex](/share/al-quran.reflectslight.io/screenshots/240x320_SurahIndex.png)
|
|
|
|
|
2024-10-22 06:51:37 +02:00
|
|
|
**SurahStream.tsx**
|
2024-10-22 05:57:35 +02:00
|
|
|
|
|
|
|
![SurahStream](/share/al-quran.reflectslight.io/screenshots/240x320_SurahStream.png)
|
2024-10-18 04:37:56 +02:00
|
|
|
|
2024-10-18 04:39:11 +02:00
|
|
|
## Development
|
|
|
|
|
|
|
|
### Requirements
|
2024-10-17 04:57:13 +02:00
|
|
|
|
2024-10-18 04:22:24 +02:00
|
|
|
The following languages have to be installed to build
|
|
|
|
the website from source:
|
2024-10-17 04:57:13 +02:00
|
|
|
|
|
|
|
* Ruby 3.2 (or later)
|
|
|
|
* NodeJS v18.15 (or later)
|
|
|
|
|
2024-10-18 04:39:11 +02:00
|
|
|
### Examples
|
2024-10-17 04:57:13 +02:00
|
|
|
|
|
|
|
# Clone repository
|
2024-10-20 09:26:16 +02:00
|
|
|
git clone https://github.com/ReflectsLight/al-quran_kaios
|
|
|
|
cd al-quran_kaios
|
2024-10-17 04:57:13 +02:00
|
|
|
|
|
|
|
# Setup build environment
|
|
|
|
bin/setup
|
|
|
|
|
|
|
|
# List all tasks
|
|
|
|
bundle exec rake -T
|
|
|
|
|
|
|
|
# Build website (dev build)
|
|
|
|
bundle exec rake nanoc:build
|
|
|
|
|
|
|
|
# Build website (production build)
|
|
|
|
bundle exec rake nanoc:build[production]
|
|
|
|
|
|
|
|
# Start web server
|
|
|
|
bundle exec rake server
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
* **audio.base_url** <br>
|
|
|
|
`audio.base_url` controls what web server serves
|
|
|
|
audio content.
|
2024-10-20 09:42:10 +02:00
|
|
|
[The default](https://audio.al-quran.reflectslight.io/rifai)
|
2024-10-17 04:57:13 +02:00
|
|
|
works out of the box. The URL for an audio file is
|
|
|
|
resolved by joining `audio.base_url` and
|
|
|
|
`/<surahid>/<ayahid>.mp3`. The `audio.base_url` option
|
|
|
|
makes it relatively easy to change the reciter
|
|
|
|
at build time, before deploying the website.
|
|
|
|
|
2024-10-20 09:39:51 +02:00
|
|
|
The https://audio.al-quran.reflectslight.io endpoint
|
2024-10-17 04:57:13 +02:00
|
|
|
provides the following recitations:
|
|
|
|
|
|
|
|
- Mishari bin Rashed Alafasy <br>
|
2024-10-20 09:39:51 +02:00
|
|
|
https://audio.al-quran.reflectslight.io/alafasy
|
2024-10-17 04:57:13 +02:00
|
|
|
- Ahmad bin Ali Al-Ajmi <br>
|
2024-10-20 09:39:51 +02:00
|
|
|
https://audio.al-quran.reflectslight.io/alajmi
|
2024-10-17 04:57:13 +02:00
|
|
|
- Sahl Yassin <br>
|
2024-10-20 09:39:51 +02:00
|
|
|
https://audio.al-quran.reflectslight.io/yassin
|
2024-10-17 04:57:13 +02:00
|
|
|
- Hani ar-Rifai <br>
|
2024-10-20 09:39:51 +02:00
|
|
|
https://audio.al-quran.reflectslight.io/rifai
|
2024-10-17 04:57:13 +02:00
|
|
|
|
|
|
|
**Note**<br>
|
|
|
|
Due to their overall size the audio files are the only
|
|
|
|
files **not** kept in this repository. The audio files
|
2024-10-20 09:39:51 +02:00
|
|
|
are hosted by https://audio.al-quran.reflectslight.io
|
|
|
|
instead.
|
2024-10-17 04:57:13 +02:00
|
|
|
|
|
|
|
## Thanks
|
|
|
|
|
|
|
|
الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ
|
|
|
|
|
|
|
|
* Thanks to the graphic artists:
|
|
|
|
- [RefreshIcon](/src/js/components/Icon.tsx)
|
|
|
|
by
|
|
|
|
[Muhammad Haq](https://freeicons.io/profile/823)
|
|
|
|
* Thanks to the translators:
|
|
|
|
- English (The Clear Quran) by Dr. Mustafa Khattab
|
|
|
|
- Farsi by Hussain Ansarian
|
|
|
|
* Thanks to the reciters:
|
|
|
|
- Mishari bin Rashed Alafasy
|
|
|
|
- Ahmad bin Ali Al-Ajmi
|
|
|
|
- Sahl Yassin
|
|
|
|
- Hani ar-Rifai
|
2024-10-17 05:00:14 +02:00
|
|
|
* Thanks to [@farooqkz](https://github.com/farooqkz): <br>
|
2024-10-22 06:53:01 +02:00
|
|
|
Farooq introduced me to [KaiOS](https://www.kaiostech.com/) development
|
2024-10-17 04:57:13 +02:00
|
|
|
|
2024-10-20 07:33:43 +02:00
|
|
|
## Sources
|
|
|
|
|
|
|
|
* [GitHub](https://github.com/ReflectsLight/al-quran_kaios)
|
2024-10-22 07:35:37 +02:00
|
|
|
* [GitLab](https://gitlab.com/ReflectsLight/al-quran_kaios)
|
|
|
|
* [brew.bsd.cafe/@0x1eef](https://brew.bsd.cafe/ReflectsLight/al-quran_kaios)
|
2024-10-20 07:33:43 +02:00
|
|
|
|
2024-10-17 04:57:13 +02:00
|
|
|
## License
|
|
|
|
|
|
|
|
The "source code" is released under the terms of the GPL <br>
|
|
|
|
See [LICENSE](./share/al-quran.reflectslight.io/LICENSE) for details
|