quran-json/README.md
0x1eef e0eb0a5ac8 The Great Rename
Rename the project to quran-json
2023-02-09 01:34:57 -03:00

2.1 KiB

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/quran-json/TheQuran/

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/quran-json

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, or fa (default: en)

Thanks

First and foremost, Alhamdulillah.

I'd also like to extend thanks to the following websites for providing the content that quran-json downloads:

License

Public domain.