Whoever intended to do a good deed or a bad deed.
Narrated Ibn ‘Abbâs رضي الله عنهما: The Prophet صلى الله عليه وسلم narrating about his Lord عز وجل said, "Allâh ordered (the angels appointed over you) that the good and the bad deeds be written, and He then showed (the way) how (to write). If somebody intends to do a good deed and he does not do it, then Allâh will write for him a full good deed (in his account with Him); and if he intends to do a good deed and actually does it, then Allâh will write for him (in his account) with Him (its reward equal) from ten to seven hundred times, to many more times; and if somebody intends to do a bad deed and he does not do it, then Allâh will write a full good deed (in his account) with Him, and if he intends to do it (a bad deed) and actually does it, then Allâh will write one bad deed (in his account)." (Sahih Al-Bukhari, Vol.8, Hadith No.498).
Translations are available in both JSON and SQLite database formats.
Some translation has footnotes as well, footnotes are embedded in the translation text using
sup HTML tag.
To support a wide range of applications, including websites, mobile apps, and desktop tools, we provide
multiple export formats for translations.
Translations are grouped by Surah. Each Surah is an array containing translations for each Ayah in order. This format export translations as simple text, no formatting, no footnotes.
[
["translation of 1:1", "translation of 1:2"], ...
["translation of 2:1", "translation of 2:2"]
]
Each translation is stored with the Ayah reference (e.g. 1:1) as the key and the translated
text as the value.
This format also exports translations as simple text, no formatting, no footnotes etc.
{
"1:1": "translation of 1:1",
"1:2": "translation of 1:2",
...
"114:6": "translation of 114:6"
}Translations with footnotes are available in three more formats:
Footnotes are embedded using a <sup> tag with a foot_note attribute.
Footnote contents are stored separately under f key.
{
"88:17": {
"t": "Do the disbelievers not see how rain clouds are formed <sup foot_note=\"77646\">1</sup>",
"f": {
"77646": "The word ibl can mean 'camel' as well as 'rain cloud'..."
}
}
}Footnotes are inserted directly using double square brackets e.g([[this is footnote]])
{
"88:17": "Do the disbelievers not see how rain clouds are formed [[The word ibl can mean 'camel' as well as 'rain cloud'...]]"
}In chunks export format, text is divided into chunks. Each chunk could be a simple text or an object. Object can be either footnote or a formatting tag. This format is useful for applications can't directly render the HTML tags. Here is an example of Bridges` translation for Surah An-Nas , Ayah 6:
Above translation will be exported in chunks as:
<i class="s">(from the whisperers)</i>among the race of unseen beings<sup foot_note="81506">1</sup>and mankind.”
[
{"type":"i","text":"(from the whisperers)"}, // first chunk, should be formatted as italic
"among the race of unseen beings", //second chunk in simple text
{"type":"f","f":"81506","text":"1"}, // third chunk is a footnote,
"and mankind.”"
]