bin | ||
lib/quran-json | ||
libexec/quran-json | ||
share/quran-json | ||
.gitignore | ||
.rubocop.yml | ||
.ruby-version | ||
.sqliterc | ||
Gemfile | ||
Gemfile.lock | ||
README.md | ||
VERSION |
About
quran-json is a dual purpose project where on the one hand it provides a utility for downloading the content of The Quran in multiple languages, and on the other hand it provides a copy of the content that can be downloaded. In both scenarios, the content is provided in the JSON format.
share/ directory
- share/quran-json/TheQuran/ar/ contains The Quran in its original Arabic.
- share/quran-json/TheQuran/en/ contains an English translation of The Quran.
- share/quran-json/TheQuran/fa/ contains a Farsi translation of The Quran.
- share/quran-json/TheQuran/pt/ contains a Portuguese translation of The Quran.
- share/quran-json/TheQuran/nl/ contains a Dutch translation of The Quran.
- share/quran-json/TheQuran/fr/ contains a French translation of The Quran.
- share/quran-json/TheQuran/it/ contains an Italian translation of The Quran.
JSON layout
The
share/quran-json/TheQuran
directory contains multiple sub-directories, where each sub-directory represents
a locale (eg en
for English, ar
for Arabic, and so on). Within each sub-directory,
there is a JSON file for each surah (also known as a chapter).
The structure of each JSON file can be described as an array where the first element is an object that contains information about a surah, and the rest of the array contains the content of the surah. The content is composed of two-element arrays - where the first element is the ayah number (also known as a verse number), and the second element is the content of the ayah.
See Surah Al-Fatihah (English) for an example.
bin/ directory
The bin/quran-json executable is a utility for downloading the content of The Quran in multiple languages.
Usage
Usage: quran-json pull [OPTIONS]
-l, --locale LOCALE ar, en, pt, fa, nl, fr, or it (default: en)
-o, --overwrite Overwrite existing JSON files (default: no)
Thanks
First and foremost, Alhamdulillah.
And thanks to the following websites for providing the content that quran-json downloads:
- https://searchtruth.com for the original Arabic, and the Italian translation.
- https://quran.com for the English, Farsi, Portuguese, Dutch, and French translations.
License
Public domain.