The quran Package∗

Seiied Mohammad Javad Razavian<javadr@gmail.com>

2021/02/02, version 1.81†

Abstract

The quran package1 has been prepared for typesetting the Holy Quran. It pro-vides several macros for typesetting not only the whole or any parts of theHoly Quran based on its popular divisions, but also any chunks of an ayah.Four translations of the Holy Quran in German, English, French, and Persianin addition to its transliteration are also supported.2 Please, report any is-sues including bugs, typos in the documentation or feature requests on https://github.com/javadr/quran/issues.

∗To one having devoted his life to the Holy Quran†First release: June 1st, 2015

1This work has been inspired by lipsum and ptext packages and released for the first time in June2015 (Sha’ban 1436 AH).

2There are three packages, quran-de, quran-ur, and quran-bn in companion with, which provideseveral other translations in Deutsch, Urdu and Bengali, respectively.

1

Contents1 Loading Package 4

2 Typesetting The HolyQuran 42.1 Surah/Sovar . . . . . . . . 42.2 Ayah/Ayat . . . . . . . . 52.3 Page/Pages . . . . . . . . 72.4 Juz/Ajza . . . . . . . . . 82.5 Hizb/Ahzab . . . . . . . . 82.6 Quarter/Quarters . . . . . 82.7 Ruku/Rukus . . . . . . . 92.8 Manzil/Manazil . . . . . . 102.9 Text of Quran . . . . . . . 112.10 Whole of The Holy Quran 112.11 Chunks of an Ayah . . . . 12

3 Miscellaneous 133.1 Name of Surah . . . . . . 133.2 Basmalah . . . . . . . . . 133.3 Index Converting . . . . . 13

4 Options to The Package 15

5 Frequently Asked Questions 185.1 What is the best font for

typesetting quran text? . 185.2 How to use quran package? 185.3 How to set a default font

for text of quran? . . . . . 205.4 How to typeset a por-

tion of the Holy Quranin one paragraph with noayah number without us-ing nopar option? . . . . . 20

5.5 Why do I get the “! TeXcapacity exceeded” er-ror? . . . . . . . . . . . . 20

6 History 21[2015/06/01 v0.1] . . . . . . . . 21[2015/06/02 v0.2] . . . . . . . . 21[2015/06/02 v0.3] . . . . . . . . 21[2015/06/04 v0.4] . . . . . . . . 21

[2015/06/24 v0.5] . . . . . . . . 21[2015/06/28 v0.6] . . . . . . . . 21[2015/06/30 v0.7] . . . . . . . . 21[2015/07/02 v0.71] . . . . . . . 21[2015/07/02 v0.72] . . . . . . . 22[2015/07/04 v0.8] . . . . . . . . 22[2015/07/07 v0.9] . . . . . . . . 22[2015/07/10 v0.91] . . . . . . . 22[2015/07/11 v0.94] . . . . . . . 22[2015/07/11 v0.941] . . . . . . 22[2016/02/05 v1.0] . . . . . . . . 22[2016/02/09 v1.05] . . . . . . . 22[2016/04/21 v1.1] . . . . . . . . 22[2016/05/15 v1.14] . . . . . . . 22[2016/10/05 v1.2] . . . . . . . . 22[2016/11/07 v1.21] . . . . . . . 23[2016/11/08 v1.22] . . . . . . . 23[2016/11/12 v1.24] . . . . . . . 23[2016/11/15 v1.241] . . . . . . 23[2016/12/25 v1.25] . . . . . . . 23[2016/12/25 v1.251] . . . . . . 23[2017/02/28 v1.252] . . . . . . 23[2017/08/22 v1.26] . . . . . . . 23[2016/08/22 v1.261] . . . . . . 23[2017/10/22 v1.3] . . . . . . . . 23[2017/10/28 v1.4] . . . . . . . . 23[2017/12/22 v1.41] . . . . . . . 24[2017/12/22 v1.42] . . . . . . . 24[2017/12/22 v1.42a] . . . . . . 24[2018/11/29 v1.42b] . . . . . . 24[2018/12/01] . . . . . . . . . . 24[2018/12/31 v1.5] . . . . . . . . 24[2019/05/03] . . . . . . . . . . 24[2019/05/04 v1.51] . . . . . . . 24[2020/03/07 v1.6] . . . . . . . . 24[2020/03/09 v1.61] . . . . . . . 24[2020/03/12 v1.62] . . . . . . . 24[2020/03/14 v1.63] . . . . . . . 25[2020/06/10 v1.7] . . . . . . . . 25[2020/06/12 v1.7a] . . . . . . . 25[2020/10/14 v1.8] . . . . . . . . 25[2021/02/01] . . . . . . . . . . 25[2021/02/02 v1.81] . . . . . . . 25

2

AcknowledgmentsI would like to express my very great appreciation to:

1. Vafa Khaligi who paved the way for typesetting right-to-left in X ETEX.2. Hamid Zarrabi-Zadeh, the creator of the invaluable website of Tanzil for

providing the text of the Holy Quran and some of its translations.3. ParsiLATEX group that tested and commented on the package in advance.4. Those who have donated to the quran package–arranged in chronological

order:(a) Atiyah Elsheikh, Feburary 2020.

1 Loading PackageThe package can be loaded in the ordinary way \usepackage[option]{quran}.All options are explained in the section 4. After loading the package, it writessome information about itself to the log file. The information is something like:

Package: quran 2021/02/02 v1.81An easy way to typeset the whole or any parts of the Holy Quran

2 Typesetting The Holy QuranFor typesetting any parts or whole of the Holy Quran, several macros are providedin the package. These commands are responsible for typesetting all popular divi-sions of the Holy Quran based on Uthmani script, including Surah, Ayah, Page,Juz, Hizb, Quarter, Ruku, and Manzil as well as any chunks of an a yah.

2.1 Surah/Sovar

\quransurah[⟨surah range⟩]\quransurah*[⟨surah range⟩]

This macro can typeset any surah of Quran. A ⟨range⟩ consists either of asingle ⟨number⟩ or two numbers separated by a dash (-), as in ⟨number1⟩-⟨number2⟩. In \quransurah and similar commands, if ⟨range⟩ does not satisfy⟨number1⟩ < ⟨number2⟩ in addition to its domain, this might fail or make someundesired results. As you know there are 114 surahs, so ⟨range⟩ could be an integerbetween 1 to 114.\quransurah terminates typesetting of every ayah using \par (depending on thepackage option) while \quransurah* uses a blank space for each ayah. As asimplified rule of thumb, \quransurah prints ayahs as multiple paragraphs while\quransurah* prints them as a single paragraph. All starred macros in the pack-age act similar in this manner; see page 15 for more details.The macro also could accept the anglicized title of the surah’s name, e.g. both of\quransurah[19] and \quransurah[Maryam] have the same effect. See table 1\quransurah[19]

\quransurah[Maryam] how to use the anglicized title of a surah instead of its order. As some anglicizedtitles include a dash (-), therefore ⟨range⟩ has to be separated by two dashes (--),e.g.\quransurah[An-Nasr--An-Nas].\quransurah without its optional argument outputs the package’s default surah,Al-Ikhlas, (as long as the default has not been overwritten, see below).

الرحيم الرحمن الله بسم﴾١﴿ صدرك لك نشرح الم

﴾٢﴿ وزرك عنك ووضعنا﴾٣﴿ ظهرك انقض الذي﴾٤﴿ ذكرك لك ورفعنا

﴾٥﴿ يسرا العسر مع فان﴾٦﴿ يسرا العسر مع ان﴾٧﴿ فانصب فرغت فاذا﴾٨﴿ فارغب ربك الى و

\quransurah[94]

الرحيم الرحمن الله بسم﴾١﴿ والزيتون والتين

﴾٢﴿ سينين وطور﴾٣﴿ الامين البلد وهذا

﴾٤﴿ تقويم احسن في نسان الا خلقنا لقد﴾٥﴿ سافلين اسفل رددناه ثم

﴾٦﴿ ممنون غير اجر فلهم الصالحات وعملوا امنوا الذين الا﴾٧﴿ بالدين بعد بك يكذ فما

﴾٨﴿ الحاكمين باحكم الله اليس

\quransurah[At-Tin]

4

شر ومن ﴾٤﴿ العقد في النفاثات شر ومن ﴾٣﴿ وقب اذا غاسق شر ومن ﴾٢﴿ خلق ما شر من ﴾١﴿ الفلق برب اعوذ قل الرحيم الرحمن الله بسمالذي ﴾٤﴿ الخناس الوسواس شر من ﴾٣﴿ الناس اله ﴾٢﴿ الناس ملك ﴾١﴿ الناس برب اعوذ قل الرحيم الرحمن الله بسم ﴾٥﴿ حسد اذا حاسد

﴾٦﴿ والناس الجنة من ﴾٥﴿ الناس صدور في يوسوس

\quransurah*[113-114]

الرحيم الرحمن الله بسم﴾١﴿ الكافرون ايها يا قل﴾٢﴿ تعبدون ما اعبد لا

﴾٣﴿ اعبد ما عابدون انتم ولا﴾٤﴿ عبدتم ما عابد انا ولا

﴾٥﴿ اعبد ما عابدون انتم ولا﴾٦﴿ دين ولي دينكم لكم

الرحيم الرحمن الله بسم﴾١﴿ والفتح الله نصر جاء اذا

﴾٢﴿ افواجا الله دين في يدخلون الناس ورايت﴾٣﴿ توابا كان انه واستغفره ربك بحمد فسبح

\quransurah[109-110]

الرحيم الرحمن الله بسم﴾١﴿ وتب لهب ابي يدا تبت

﴾٢﴿ كسب وما ماله عنه اغنى ما﴾٣﴿ لهب ذات نارا سيصلى﴾٤﴿ الحطب حمالة وامراته

﴾٥﴿ مسد من حبل جيدها فيالرحيم الرحمن الله بسم

﴾١﴿ احد الله هو قل﴾٢﴿ مد الص الله

﴾٣﴿ يولد ولم يلد لم﴾٤﴿ احد كفوا له يكن ولم

\quransurah[Al-Masadd--Al-Ikhlas]

لم ﴾٢﴿ مد الص الله ﴾١﴿ احد الله هو قل الرحيم الرحمن الله بسم﴾٤﴿ احد كفوا له يكن ولم ﴾٣﴿ يولد ولم يلد

\quransurah*الرحيم الرحمن الله بسم

﴾١﴿ احد الله هو قل﴾٢﴿ مد الص الله

﴾٣﴿ يولد ولم يلد لم﴾٤﴿ احد كفوا له يكن ولم

\quransurah

In order to change the default surah, apply \setsurahdefault{m}. As you’venoticed the package’s default is 112. After changing package’s default surah to\setsurahdefault107 by \setsurahdefault{107}, the output would be like below:

﴾٤﴿ للمصلين فويل ﴾٣﴿ المسكين طعام على يحض ولا ﴾٢﴿ اليتيم يدع الذي فذلك ﴾١﴿ بالدين ب يكذ الذي ارايت الرحيم الرحمن الله بسم﴾٧﴿ الماعون ويمنعون ﴾٦﴿ يراءون هم الذين ﴾٥﴿ ساهون صلاتهم عن هم الذين

\quransurah*

2.2 Ayah/Ayat

\quranayah[⟨surah range⟩][⟨ayah range⟩]\quranayah*[⟨surah range⟩][⟨ayah range⟩]

⟨range⟩ is similar the one explained for \quransurah and this pattern is similar toall commands defined in the package. Therefore, this command typesets the nth

ayah of a surah or mth to nth ayahs of a s urah.

5

Order Anglicized Title Order Anglicized Title Order Anglicized Title1 Al-Fatiha 39 Az-Zumar 77 Al-Mursalat2 Al-Baqara 40 Ghafir 78 An-Naba3 Aal-e-Imran 41 Fussilat 79 An-Naziat4 An-Nisa 42 Ash-Shura 80 Abasa5 Al-Maeda 43 Az-Zukhruf 81 At-Takwir6 Al-Anaam 44 Ad-Dukhan 82 AL-Infitar7 Al-Araf 45 Al-Jathiya 83 Al-Mutaffifin8 Al-Anfal 46 Al-Ahqaf 84 Al-Inshiqaq9 At-Taubah 47 Muhammad 85 Al-Burooj10 Yunus 48 Al-Fath 86 At-Tariq11 Hud 49 Al-Hujraat 87 Al-Ala12 Yusuf 50 Qaf 88 Al-Ghashiya13 Ar-Rad 51 Adh-Dhariyat 89 Al-Fajr14 Ibrahim 52 At-tur 90 Al-Balad15 Al-Hijr 53 An-Najm 91 Ash-Shams16 An-Nahl 54 Al-Qamar 92 Al-Lail17 Al-Isra 55 Al-Rahman 93 Ad-Dhuha18 Al-Kahf 56 Al-Waqia 94 Al-Inshirah19 Maryam 57 Al-Hadid 95 At-Tin20 Taha 58 Al-Mujadila 96 Al-Alaq21 Al-Anbiya 59 Al-Hashr 97 Al-Qadr22 Al-Hajj 60 Al-Mumtahina 98 Al-Bayyina23 Al-Mumenoon 61 As-Saff 99 Al-Zalzala24 An-Noor 62 Al-Jumua 100 Al-Adiyat25 Al-Furqan 63 Al-Munafiqoon 101 Al-Qaria26 Ash-Shuara 64 At-Taghabun 102 At-Takathur27 An-Naml 65 At-Talaq 103 Al-Asr28 Al-Qasas 66 At-Tahrim 104 Al-Humaza29 Al-Ankaboot 67 Al-Mulk 105 Al-Fil30 Ar-Room 68 Al-Qalam 106 Quraish31 Luqman 69 Al-Haaqqa 107 Al-Maun32 As-Sajda 70 Al-Maarij 108 Al-Kauther33 Al-Ahzab 71 Nooh 109 Al-Kafiroon34 Saba 72 Al-Jinn 110 An-Nasr35 Fatir 73 Al-Muzzammil 111 Al-Masadd36 Ya-Seen 74 Al-Muddathir 112 Al-Ikhlas37 As-Saaffat 75 Al-Qiyama 113 Al-Falaq38 Sad 76 Al-Insan 114 An-Nas

Table 1: Anglicized Title of Surahs’ Names

لاة الص واقمن الاولى الجاهلية تبرج تبرجن ولا بيوتكن في وقرنالرجس عنكم ليذهب الله يريد انما ورسوله الله واطعن الزكاة واتين

﴾٣٣﴿ تطهيرا ركم ويطه البيت اهل

\quranayah[33][33]

لاة الص واقمن الاولى الجاهلية تبرج تبرجن ولا بيوتكن في وقرنالرجس عنكم ليذهب الله يريد انما ورسوله الله واطعن الزكاة واتين

﴾٣٣﴿ تطهيرا ركم ويطه البيت اهل

\quranayah[Al-Ahzab][33]

The basmalah will not be printed if you want to typeset the first ayah of any surahper se. Using \basmalah macro prior to the ayah will solve this issue. See page 13for more information.\basmalah

6

باذن النور الى الظلمات من الناس لتخرج اليك انزلناه كتاب الر﴾١﴿ الحميد العزيز صراط الى ربهم

\quranayah[Ibrahim][1]الرحيم الرحمن الله بسم

باذن النور الى الظلمات من الناس لتخرج اليك انزلناه كتاب الر﴾١﴿ الحميد العزيز صراط الى ربهم

\basmalah\quranayah[14][1]

وعملوا امنوا والذين بهم واقع وهو كسبوا مما مشفقين الظالمين ترىذلك ربهم عند يشاءون ما لهم الجنات روضات في الصالحاتامنوا الذين عباده الله ر يبش الذي ذلك ﴾٢٢﴿ الكبير الفضل هو القربى في ة المود الا اجرا عليه اسالكم لا قل الصالحات وعملواام ﴾٢٣﴿ شكور غفور الله ان حسنا فيها له نزد حسنة يقترف ومنويمح قلبك على يختم الله يشا فان كذبا الله على افترى يقولون﴾٢٤﴿ دور الص بذات عليم انه بكلماته الحق ويحق الباطل اللهتفعلون ما ويعلم يئات الس عن ويعفو عباده عن التوبة يقبل الذي وهوفضله من ويزيدهم الصالحات وعملوا امنوا الذين ويستجيب ﴾٢٥﴿

﴾٢٦﴿ شديد عذاب لهم والكافرون

\quranayah*[Ash-Shura][22-26]

وعملوا امنوا والذين بهم واقع وهو كسبوا مما مشفقين الظالمين ترىذلك ربهم عند يشاءون ما لهم الجنات روضات في الصالحاتامنوا الذين عباده الله ر يبش الذي ذلك ﴾٢٢﴿ الكبير الفضل هو القربى في ة المود الا اجرا عليه اسالكم لا قل الصالحات وعملواام ﴾٢٣﴿ شكور غفور الله ان حسنا فيها له نزد حسنة يقترف ومنويمح قلبك على يختم الله يشا فان كذبا الله على افترى يقولون﴾٢٤﴿ دور الص بذات عليم انه بكلماته الحق ويحق الباطل اللهتفعلون ما ويعلم يئات الس عن ويعفو عباده عن التوبة يقبل الذي وهوفضله من ويزيدهم الصالحات وعملوا امنوا الذين ويستجيب ﴾٢٥﴿

﴾٢٦﴿ شديد عذاب لهم والكافرون

\quranayah*[42][22-26]

Both \quransurah and \quranayah are case-insensitive to the anglicized title ofsurah, i.e. there are, for example, no differences among Al-Fatiha, al-fatiha, orany other possible combinations of lowercase and uppercase letters.

الرحمن ﴾٢﴿ العالمين رب لله الحمد ﴾١﴿ الرحيم الرحمن الله بسم﴾٥﴿ نستعين اياك و نعبد اياك ﴾٤﴿ الدين يوم مالك ﴾٣﴿ الرحيمغير عليهم انعمت الذين صراط ﴾٦﴿ المستقيم راط الص اهدنا

﴾٧﴿ الضالين ولا عليهم المغضوب

\quransurah*[Al-Fatiha]

الرحمن ﴾٢﴿ العالمين رب لله الحمد ﴾١﴿ الرحيم الرحمن الله بسم﴾٥﴿ نستعين اياك و نعبد اياك ﴾٤﴿ الدين يوم مالك ﴾٣﴿ الرحيمغير عليهم انعمت الذين صراط ﴾٦﴿ المستقيم راط الص اهدنا

﴾٧﴿ الضالين ولا عليهم المغضوب

\quransurah*[aL-fAtIhA]

2.3 Page/Pages

\quranpage[⟨page range⟩]\quranpage*[⟨page range⟩]

Typesets the specified ⟨range⟩ of page(s) of the Holy Quran. The numbers in⟨range⟩ have to be between 1 to 604, based on the Medina Mushaf.

7

ان و المثلات قبلهم من خلت وقد الحسنة قبل يئة بالس ويستعجلونك﴾٦﴿ العقاب لشديد ربك ان و ظلمهم على للناس مغفرة لذو ربكولكل منذر انت انما ربه من اية عليه انزل لولا كفروا الذين ويقولتزداد وما الارحام تغيض وما انثى كل تحمل ما يعلم الله ﴾٧﴿ هاد قومالمتعال الكبير هادة والش الغيب عالم ﴾٨﴿ بمقدار عنده شيء وكل مستخف هو ومن به جهر ومن القول اسر من منكم سواء ﴾٩﴿خلفه ومن يديه بين من بات معق له ﴾١٠﴿ بالنهار وسارب بالليل بانفسهم ما يغيروا حتى بقوم ما يغير لا الله ان الله امر من يحفظونه﴾١١﴿ وال من دونه من لهم وما له مرد فلا سوءا بقوم الله اراد اذا و﴾١٢﴿ الثقال حاب الس وينشئ وطمعا خوفا البرق يريكم الذي هوفيصيب واعق الص ويرسل خيفته من والملائكة بحمده الرعد ويسبح

﴾١٣﴿ المحال شديد وهو الله في يجادلون وهم يشاء من بها

\quranpage*[250]

اليك انزل والذي الكتاب ايات تلك المر الرحيم الرحمن الله بسمرفع الذي الله ﴾١﴿ يؤمنون لا الناس اكثر ولكن الحق ربك منمس الش ر وسخ العرش على استوى ثم ترونها عمد بغير ماوات السلعلكم الايات ل يفص الامر يدبر ى مسم لاجل يجري كل والقمررواسي فيها وجعل الارض مد الذي وهو ﴾٢﴿ توقنون ربكم بلقاءالليل يغشي اثنين زوجين فيها جعل الثمرات كل ومن وانهاراقطع الارض وفي ﴾٣﴿ يتفكرون لقوم لايات ذلك في ان النهاريسقى صنوان وغير صنوان ونخيل وزرع اعناب من وجنات متجاوراتلايات ذلك في ان الاكل في بعض على بعضها ل ونفض واحد بماءاانا ترابا كنا ااذا قولهم فعجب تعجب ان و ۞ ﴾٤﴿ يعقلون لقومفي الاغلال واولئك بربهم كفروا الذين اولئك جديد خلق لفي

﴾٥﴿ خالدون فيها هم النار اصحاب واولئك اعناقهم

\quranpage*[249]

انتم ولا ﴾٤﴿ عبدتم ما عابد انا ولا ﴾٣﴿ اعبد ما عابدون انتم ولا ﴾٢﴿ تعبدون ما اعبد لا ﴾١﴿ الكافرون ايها يا قل الرحيم الرحمن الله بسمافواجا الله دين في يدخلون الناس ورايت ﴾١﴿ والفتح الله نصر جاء اذا الرحيم الرحمن الله بسم ﴾٦﴿ دين ولي دينكم لكم ﴾٥﴿ اعبد ما عابدون﴾٢﴿ كسب وما ماله عنه اغنى ما ﴾١﴿ وتب لهب ابي يدا تبت الرحيم الرحمن الله بسم ﴾٣﴿ توابا كان انه واستغفره ربك بحمد فسبح ﴾٢﴿الله ﴾١﴿ احد الله هو قل الرحيم الرحمن الله بسم ﴾٥﴿ مسد من حبل جيدها في ﴾٤﴿ الحطب حمالة وامراته ﴾٣﴿ لهب ذات نارا سيصلىشر ومن ﴾٢﴿ خلق ما شر من ﴾١﴿ الفلق برب اعوذ قل الرحيم الرحمن الله بسم ﴾٤﴿ احد كفوا له يكن ولم ﴾٣﴿ يولد ولم يلد لم ﴾٢﴿ مد الصملك ﴾١﴿ الناس برب اعوذ قل الرحيم الرحمن الله بسم ﴾٥﴿ حسد اذا حاسد شر ومن ﴾٤﴿ العقد في النفاثات شر ومن ﴾٣﴿ وقب اذا غاسق

﴾٦﴿ والناس الجنة من ﴾٥﴿ الناس صدور في يوسوس الذي ﴾٤﴿ الخناس الوسواس شر من ﴾٣﴿ الناس اله ﴾٢﴿ الناس

\quranpage*[603-604]

2.4 Juz/Ajza

\quranjuz[⟨juz range⟩]\quranjuz*[⟨juz range⟩]

This macro typesets the specified ⟨range⟩ of juz(zes) of the Holy Quran, rangingfrom 1 to 30.

2.5 Hizb/AhzabEach juz of the Holy Quran is devided into two ahzab (groups), thus there are 60hizbs (ahzab). Following macro typesets hizb/ahzab of the Holy Quran.

\quranhizb[⟨hizb range⟩]\quranhizb*[⟨hizb range⟩]

2.6 Quarter/QuartersEash hizb of the Holy Quran is devided into four quarters, making eight quartersper juz, called maqra. There are 240 of these quarters (of hizb) in the Holy Quran.

8

These maqras are often used as sections for revision when memorizing the HolyQuran.3

\quranquarter[⟨quarter range⟩]\quranquarter*[⟨quarter range⟩]

لا اكثرهم بل لله الحمد يستوون هل وجهرا ا سر منه ينفق فهو حسنا رزقا منا رزقناه ومن شيء على يقدر لا مملوكا عبدا مثلا الله ضرب ۞يامر ومن هو يستوي هل بخير يات لا هه يوج اينما مولاه على كل وهو شيء على يقدر لا ابكم احدهما رجلين مثلا الله وضرب ﴾٧٥﴿ يعلمونقدير شيء كل على الله ان اقرب هو او البصر كلمح الا الساعة امر وما والارض ماوات الس غيب لله و ﴾٧٦﴿ مستقيم صراط على وهو بالعدلرات مسخ الطير الى يروا الم ﴾٧٨﴿ تشكرون لعلكم والافئدة والابصار مع الس لكم وجعل شيئا تعلمون لا امهاتكم بطون من اخرجكم والله ﴾٧٧﴿بيوتا الانعام جلود من لكم وجعل سكنا بيوتكم من لكم جعل والله ﴾٧٩﴿ يؤمنون لقوم لايات ذلك في ان الله الا يمسكهن ما ماء الس جو فيمن لكم وجعل ظلالا خلق مما لكم جعل والله ﴾٨٠﴿ حين الى ومتاعا اثاثا واشعارها واوبارها اصوافها ومن اقامتكم ويوم ظعنكم يوم تستخفونهاالبلاغ عليك فانما تولوا فان ﴾٨١﴿ تسلمون لعلكم عليكم نعمته يتم كذلك باسكم تقيكم وسرابيل الحر تقيكم سرابيل لكم وجعل اكنانا الجباليستعتبون هم ولا كفروا للذين يؤذن لا ثم شهيدا ة ام كل من نبعث ويوم ﴾٨٣﴿ الكافرون واكثرهم ينكرونها ثم الله نعمت يعرفون ﴾٨٢﴿ المبينالذين شركاؤنا هؤلاء ربنا قالوا شركاءهم اشركوا الذين راى اذا و ﴾٨٥﴿ ينظرون هم ولا عنهم ف يخف فلا العذاب ظلموا الذين راى اذا و ﴾٨٤﴿وصدوا كفروا الذين ﴾٨٧﴿ يفترون كانوا ما عنهم وضل لم الس يومئذ الله الى والقوا ﴾٨٦﴿ لكاذبون انكم القول اليهم فالقوا دونك من ندعو كناهؤلاء على شهيدا بك وجئنا انفسهم من عليهم شهيدا ة ام كل في نبعث ويوم ﴾٨٨﴿ يفسدون كانوا بما العذاب فوق عذابا زدناهم الله سبيل عن

﴾٨٩﴿ للمسلمين وبشرى ورحمة وهدى شيء لكل تبيانا الكتاب عليك ونزلنا

\quranquarter*[110]

2.7 Ruku/Rukus“The term rukū — roughly translated to “passage”, “pericope” or “stanza” — isalso used to denote a group of thematically related verses in the Qur’an. Longersuras (chapters) in the Qur’an are usually divided into several rukūs, so that thereciters could identify when to make rukū in Salat without breaking an ongoingtopic in the Quranic text.”4 There are 556 rukus.

\quranruku[⟨ruku range⟩]\quranruku*[⟨ruku range⟩]

الله وعدنا ما هذا قالوا الاحزاب المؤمنون راى ولما ﴾٢١﴿ كثيرا الله وذكر الاخر واليوم الله يرجو كان لمن حسنة اسوة الله رسول في لكم كان لقدمن ومنهم نحبه قضى من فمنهم عليه الله عاهدوا ما صدقوا رجال المؤمنين من ﴾٢٢﴿ وتسليما ايمانا الا زادهم وما ورسوله الله وصدق ورسولهالله ورد ﴾٢٤﴿ رحيما غفورا كان الله ان عليهم يتوب او شاء ان المنافقين ب ويعذ بصدقهم الصادقين الله ليجزي ﴾٢٣﴿ تبديلا لوا بد وما ينتظرصياصيهم من الكتاب اهل من ظاهروهم الذين وانزل ﴾٢٥﴿ عزيزا قويا الله وكان القتال المؤمنين الله وكفى خيرا ينالوا لم بغيظهم كفروا الذينقديرا شيء كل على الله وكان تطئوها لم وارضا واموالهم وديارهم ارضهم واورثكم ﴾٢٦﴿ فريقا وتاسرون تقتلون فريقا الرعب قلوبهم في وقذف

﴾٢٧﴿

\quranruku*[363]

3https://en.wikipedia.org/wiki/Juz'4https://en.wikipedia.org/wiki/Ruku

9

حسرة ذلك الله ليجعل قتلوا وما ماتوا ما عندنا كانوا لو غزى كانوا او الارض في ضربوا اذا لاخوانهم وقالوا كفروا كالذين تكونوا لا امنوا الذين ايها يا﴾١٥٧﴿ يجمعون مما خير ورحمة الله من لمغفرة متم او الله سبيل في قتلتم ولئن ﴾١٥٦﴿ بصير تعملون بما والله ويميت يحيي والله قلوبهم فيواستغفر عنهم فاعف حولك من لانفضوا القلب غليظ فظا كنت ولو لهم لنت الله من رحمة فبما ﴾١٥٨﴿ تحشرون الله لى لا قتلتم او متم ولئنالذي ذا فمن يخذلكم ان و لكم غالب فلا الله ينصركم ان ﴾١٥٩﴿ المتوكلين يحب الله ان الله على فتوكل عزمت فاذا الامر في وشاورهم لهمكسبت ما نفس كل توفى ثم القيامة يوم غل بما يات يغلل ومن يغل ان لنبي كان وما ﴾١٦٠﴿ المؤمنون فليتوكل الله وعلى بعده من ينصركمبصير والله الله عند درجات هم ﴾١٦٢﴿ المصير وبئس جهنم وماواه الله من بسخط باء كمن الله رضوان اتبع افمن ﴾١٦١﴿ يظلمون لا وهمكانوا ان و والحكمة الكتاب ويعلمهم ويزكيهم اياته عليهم يتلو انفسهم من رسولا فيهم بعث اذ المؤمنين على الله من لقد ﴾١٦٣﴿ يعملون بماقدير شيء كل على الله ان انفسكم عند من هو قل هذا انى قلتم مثليها اصبتم قد مصيبة اصابتكم اولما ﴾١٦٤﴿ مبين ضلال لفي قبل من ادفعوا او الله سبيل في قاتلوا تعالوا لهم وقيل نافقوا الذين ليعلم و ﴾١٦٦﴿ المؤمنين ليعلم و الله فباذن الجمعان التقى يوم اصابكم وما ﴾١٦٥﴿قالوا الذين ﴾١٦٧﴿ يكتمون بما اعلم والله قلوبهم في ليس ما بافواههم يقولون للايمان منهم اقرب يومئذ للكفر هم لاتبعناكم قتالا نعلم لو قالوااحياء بل امواتا الله سبيل في قتلوا الذين تحسبن ولا ﴾١٦٨﴿ صادقين كنتم ان الموت انفسكم عن فادرءوا قل قتلوا ما اطاعونا لو وقعدوا لاخوانهم﴾١٧٠﴿ يحزنون هم ولا عليهم خوف الا خلفهم من بهم يلحقوا لم بالذين ويستبشرون فضله من الله اتاهم بما فرحين ﴾١٦٩﴿ يرزقون ربهم عنداحسنوا للذين القرح اصابهم ما بعد من والرسول لله استجابوا الذين ﴾١٧١﴿ المؤمنين اجر يضيع لا الله وان وفضل الله من بنعمة يستبشرون ۞﴾١٧٣﴿ الوكيل ونعم الله حسبنا وقالوا ايمانا فزادهم فاخشوهم لكم جمعوا قد الناس ان الناس لهم قال الذين ﴾١٧٢﴿ عظيم اجر واتقوا منهمتخافوهم فلا اولياءه يخوف يطان الش ذلكم انما ﴾١٧٤﴿ عظيم فضل ذو والله الله رضوان واتبعوا سوء يمسسهم لم وفضل الله من بنعمة فانقلبواولهم الاخرة في حظا لهم يجعل الا الله يريد شيئا الله يضروا لن انهم الكفر في يسارعون الذين يحزنك ولا ﴾١٧٥﴿ مؤمنين كنتم ان وخافونخير لهم نملي انما كفروا الذين يحسبن ولا ﴾١٧٧﴿ اليم عذاب ولهم شيئا الله يضروا لن بالايمان الكفر اشتروا الذين ان ﴾١٧٦﴿ عظيم عذابوما الطيب من الخبيث يميز حتى عليه انتم ما على المؤمنين ليذر الله كان ما ﴾١٧٨﴿ مهين عذاب ولهم اثما ليزدادوا لهم نملي انما لانفسهميحسبن ولا ﴾١٧٩﴿ عظيم اجر فلكم وتتقوا تؤمنوا ان و ورسله بالله فامنوا يشاء من رسله من يجتبي الله ولكن الغيب على ليطلعكم الله كانبما والله والارض ماوات الس ميراث لله و القيامة يوم به بخلوا ما سيطوقون لهم شر هو بل لهم خيرا هو فضله من الله اتاهم بما يبخلون الذين

﴾١٨٠﴿ خبير تعملون

\quranruku*[58-59]

2.8 Manzil/Manazil“For the convenience of people who wish to read the Qur’an in a week the textmay be divided into 7 portions, each portion is known as Manzil.The following division to 7 equal portions is by Hamza Al-Zayyat (d.156/772):

1. Al-Fatihah (chapter 1) through An-Nisa’ (chapter 4) consisting of 4 surahs.

2. Al-Ma’ida (chapter 5) through At-Tawba (chapter 9) consisting of 5 surahs.

3. Yunus (chapter 10) through An-Nahl (chapter 16) consisting of 7 surahs.

4. Al Isra’ (chapter 17) through Al-Furqan (chapter 25) consisting of 9 surahs.

5. Ash-Shuara’ (chapter 26) through Ya-Seen (chapter 36) consisting of 11surahs.

6. As-Saaffat (chapter 37) through Al-Hujarat (chapter 49) consisting of 13surahs.

7. Qaf (chapter 50) through An-Nass (chapter 114) consisting of 65 surahs.”5

\quranmanzil[⟨manzil range⟩]\quranmanzil*[⟨manzil range⟩]

The above macro typesets manzil/manazil of the Holy Quran.5https://en.wikipedia.org/wiki/Manzil

10

2.9 Text of QuranThe next macro is the heart of all macros in the package typesetting any range ofQuran. As you know, there are 6236 ayahs in the Holy Quran. This macro cantypeset a specific ayah or any range of ayahs.

\qurantext[⟨index range⟩]\qurantext*[⟨index range⟩]

الاء فاذكروا بسطة الخلق في وزادكم نوح قوم بعد من خلفاء جعلكم اذ واذكروا لينذركم منكم رجل على ربكم من ذكر جاءكم ان اوعجبتم﴾٦٩﴿ تفلحون لعلكم الله

\qurantext[1023]

ربكم الى وانيبوا ﴾٥٣﴿ الرحيم الغفور هو انه جميعا نوب الذ يغفر الله ان الله رحمة من تقنطوا لا انفسهم على اسرفوا الذين عبادي يا قل ۞تشعرون لا وانتم بغتة العذاب ياتيكم ان قبل من ربكم من اليكم انزل ما احسن واتبعوا ﴾٥٤﴿ تنصرون لا ثم العذاب ياتيكم ان قبل من له واسلموا﴾٥٧﴿ المتقين من لكنت هداني الله ان لو تقول او ﴾٥٦﴿ الساخرين لمن كنت ان و الله جنب في فرطت ما على حسرتا يا نفس تقول ان ﴾٥٥﴿﴾٥٩﴿ الكافرين من وكنت واستكبرت بها بت فكذ اياتي جاءتك قد بلى ﴾٥٨﴿ المحسنين من فاكون ة كر لي ان لو العذاب ترى حين تقول او

\qurantext*[4111-4117]

Using \qurantext without its optional argument uses [1-7] at its default argument–surah Al-Hamd. To change the default text use \setqurantextdefault{m-n}\qurantext

اهدنا ﴾٥﴿ نستعين اياك و نعبد اياك ﴾٤﴿ الدين يوم مالك ﴾٣﴿ الرحيم الرحمن ﴾٢﴿ العالمين رب لله الحمد ﴾١﴿ الرحيم الرحمن الله بسم﴾٧﴿ الضالين ولا عليهم المغضوب غير عليهم انعمت الذين صراط ﴾٦﴿ المستقيم راط الص

\qurantext*

In the following example, \setqurantextdefault{4128-4137} has changed thedefault to index 4128 to 4137.\setqurantextdefault{m-n}

الم خزنتها لهم وقال ابوابها فتحت جاءوها اذا حتى زمرا جهنم الى كفروا الذين وسيق ﴾٧٠﴿ يفعلون بما اعلم وهو عملت ما نفس كل ووفيتابواب ادخلوا قيل ﴾٧١﴿ الكافرين على العذاب كلمة ت حق ولكن بلى قالوا هذا يومكم لقاء وينذرونكم ربكم ايات عليكم يتلون منكم رسل ياتكمسلام خزنتها لهم وقال ابوابها وفتحت جاءوها اذا حتى زمرا الجنة الى ربهم اتقوا الذين وسيق ﴾٧٢﴿ المتكبرين مثوى فبئس فيها خالدين جهنم﴾٧٤﴿ العاملين اجر فنعم نشاء حيث الجنة من ا نتبو الارض واورثنا وعده صدقنا الذي لله الحمد وقالوا ﴾٧٣﴿ خالدين فادخلوها طبتم عليكمالرحيم الرحمن الله بسم ﴾٧٥﴿ العالمين رب لله الحمد وقيل بالحق بينهم وقضي ربهم بحمد يسبحون العرش حول من حافين الملائكة وترىيجادل ما ﴾٣﴿ المصير اليه هو الا اله لا الطول ذي العقاب شديد التوب وقابل نب الذ غافر ﴾٢﴿ العليم العزيز الله من الكتاب تنزيل ﴾١﴿ حم

﴾٤﴿ البلاد في تقلبهم يغررك فلا كفروا الذين الا الله ايات في

\qurantext*

2.10 Whole of The Holy QuranThe following macros with the specified parameters can typeset whole of the HolyQuran:

11

• \quransurah[1-114]

• \quranjuz[1-30]

• \quranpage[1-604]

• \qurantext[1-6236]

• \quranhizb[1-60]

• \quranquarter[1-240]

• \quranruku[1-556]

• \quranmanzil[1-7]

• \quransurah*[1-114]

• \quranjuz*[1-30]

• \quranpage*[1-604]

• \qurantext*[1-6236]

• \quranhizb*[1-60]

• \quranquarter*[1-240]

• \quranruku*[1-556]

• \quranmanzil*[1-7]

2.11 Chunks of an AyahFrom ver 1.6 onward, the package is capable of typesetting not only a whole ayahbut also any chunks of an ayah if the wordwise option has been loaded.6 In thiswordwisecase, \quranayah and \qurantext macros have some other optional parametersto do that.

\quranayah[⟨surah range⟩][⟨ayah range⟩][⟨chunk range⟩]\quranayah[⟨surah range⟩][⟨ayah range⟩][⟨chunk range⟩]+

\qurantext[⟨index range⟩][⟨chunk range⟩]\qurantext[⟨index range⟩][⟨chunk range⟩]+

These commands separate words included in ⟨ayah range⟩/⟨index range⟩ by whitespaces and then output specified ⟨chunk range⟩. If ⟨chunk range⟩ includes just onenumber, the output will be from the ⟨number⟩th word to the end of ⟨ayah range⟩.

﴾١٥٦﴿ راجعون اليه انا و لله انا

\quranayah[2][156][6]

وارحمنا لنا واغفر عنا واعف به لنا طاقة لا ما لنا تحم ولا ربنا

\quranayah[2][286][31-43]

The way the package enumerates the words of a specified ⟨range⟩ could be shownin the footnote if these commands followed by +.

a﴾٢٤﴿ الدار عقبى فنعم صبرتم بما عليكم سلام ﴾٢٣﴿ باب كل من عليهم يدخلون والملائكة

فنعم21

صبرتم20

بما19

عليكم18

سلام17

﴾٢٣﴿16

باب15

كل14

من13

عليهم12

يدخلون11

والملائكة10

ياتهم وذر9وازواجهم

8ابائهم

7من

6صلح

5ومن

4يدخلونها

3عدن

2جنات

1

a

﴾٢٤﴿24

الدار23

عقبى22

\quranayah[Ar-Rad][23-24][10]+

6This new practical feature has been suggested and supported financially by Atiyah Elsheikh inFeburary 2020.

12

Fetching just one word from an ayah needs the ⟨chunck range⟩ to have both⟨number⟩s as the same.

وليتلطف

\quranayah[18][19][34-34]

3 Miscellaneous3.1 Name of Surah

\surahname[⟨index⟩]\surahname*[⟨index⟩]

These commands return the anglicized/arabic title of indexth surah of the HolyQuran, as depicted in table 1 and table 2

Maryam

\surahname[19]

مريم

\surahname*[19]

3.2 Basmalah

\basmalah\Basmalah

It provides Basmalah الرحيم) الرحمن الله (بسم in arabic text. There is a subtle differencebetween \Basmalah and \basmalah – the latter is sometimes followed by a \par(depending on the package option).

الرحيم الرحمن الله بسمباذن النور الى الظلمات من الناس لتخرج اليك انزلناه كتاب الر

﴾١﴿ الحميد العزيز صراط الى ربهم

\basmalah\quranayah*[14][1]

من الناس لتخرج اليك انزلناه كتاب الر الرحيم الرحمن الله بسم﴾١﴿ الحميد العزيز صراط الى ربهم باذن النور الى الظلمات

\Basmalah\space\quranayah*[14][1

3.3 Index Converting

\indexconvert{⟨index⟩}{⟨surah macro⟩}{⟨ayah macro⟩}

It converts an index number between 1 to 6236 to its exact surah’s index andayah’s index. The index must be either a number or a TEX counter, and the surahmacro and ayah would be defined as a TEX counters if they are undefined. Theywill be set to the numbers representing the surah and ayah of the given index intext of the Holy Quran.

13

Title Order Title Order Title Order Title Orderالأعلى 87 الحشر 59 الروم 30 الفاتحة 1الغاشية 88 الممتحنة 60 لقمان 31 البقرة 2الفجر 89 الصف 61 السجدة 32 عمران آل 3البلد 90 الجمعة 62 الأحزاب 33 النساء 4

الشمس 91 المنافقون 63 سبأ 34 المائدة 5الليل 92 التغابن 64 فاطر 35 الأنعام 6

الضحى 93 الطلاق 65 يس 36 الأعراف 7الشرح 94 التحريم 66 الصافات 37 الأنفال 8التين 95 الملك 67 ص 38 التوبة 9العلق 96 القلم 68 الزمر 39 يونس 10القدر 97 الحاقة 69 غافر 40 هود 11البينة 98 المعارج 70 فصلت 41 يوسف 12الزلزلة 99 نوح 71 الشورى 42 الرعد 13

العاديات 100 الجن 72 الزخرف 43 براهيم إ 14القارعة 101 المزمل 73 الدخان 44 الحجر 15التكاثر 102 المدثر 74 الجاثية 45 النحل 16العصر 103 القيامة 75 الأحقاف 46 الإسراء 17الهمزة 104 الإنسان 76 محمد 47 الـكهف 18الفيل 105 المرسلات 77 الفتح 48 مريم 19قريش 106 النبأ 78 الحجرات 49 طه 20الماعون 107 النازعات 79 ق 50 الأنبياء 21الـكوثر 108 عبس 80 يات الذار 51 الحج 22

الكافرون 109 التكوير 81 الطور 52 المؤمنون 23النصر 110 الإنفطار 82 النجم 53 النور 24المسد 111 المطففين 83 القمر 54 الفرقان 25

الإخلاص 112 الانشقاق 84 الرحمن 55 الشعراء 26الفلق 113 البروج 85 الواقعة 56 النمل 27الناس 114 الطارق 86 الحديد 57 القصص 28

المجادلة 58 العنكبوت 29

Table 2: Arabic Titles of Surahs

\newcount\index \index=5678

\indexconvert{\index}{\surahcount}{\ayahcount}

Index \the\index\ belongs to ayah number \the\ayahcount\of surah number \the\surahcount\ (=\surahname[\the\surahcount]).

Index 5678 belongs to ayah number 6 of surah number 78 (=An-Naba).

indexconvert

14

4 Options to The PackageAll macros of the package, by default, will separate ayahs with \par. The noparnoparoption is available to change this default behaviour. In this case, ayahs will beseparated with space instead \par. Another way for achieving this, is using thestarred version of macros. All macros of the package have starred versions thatstarred macrosomit the \par in typesetting ayahs of the Holy Quran. With nopar option, starrednoparmacros act as if this option was not loaded.

All surahs of the Holy Quran are divided by ayahs which have their own indexes.By default, these numbers are typeset with text of each ayah. The nonumbernonumberoption causes none of these numbers will be printed with ayahs.

\ToggleAyahNumber

This macro change the default behaviour of the package in typesetting of theindex of ayahs whereever it called. It means that the macro can enable/disablethe ayahs’ index in output text.

العماد ذات ارم بعاد ربك فعل كيف تر الم حجر لذي قسم ذلك في هل يسر اذا والليل والوتر فع والش عشر وليال والفجر الرحيم الرحمن الله بسمربك عليهم فصب الفساد فيها فاكثروا البلاد في طغوا الذين الاوتاد ذي وفرعون بالواد خر الص جابوا الذين وثمود البلاد في مثلها يخلق لم التياهانن ربي فيقول رزقه عليه فقدر ابتلاه ما اذا واما اكرمن ربي فيقول مه ونع فاكرمه ربه ابتلاه ما اذا نسان الا ا فام لبالمرصاد ربك ان عذاب سوطوجاء دكا دكا الارض دكت اذا كلا ا جم حبا المال وتحبون ا لم اكلا التراث وتاكلون المسكين طعام على تحاضون ولا اليتيم تكرمون لا بل كلاولا احد عذابه ب يعذ لا فيومئذ لحياتي مت قد ليتني يا يقول كرى الذ له وانى نسان الا ر يتذك يومئذ بجهنم يومئذ وجيء ا صف ا صف والملك ربك

جنتي وادخلي عبادي في فادخلي مرضية راضية ربك الى ارجعي المطمئنة النفس ايتها يا احد وثاقه يوثق

\ToggleAyahNumber\quransurah*[89]

Version 1.6 comes wtih the wordwise option which makes the package capable ofwordwiseoutputing any chunks of an ayah. See section 2.11 for more details.

يقاتلون الجنة لهم بان واموالهم انفسهم المؤمنين من اشترى الله اننجيل والا التوراة في ا حق عليه وعدا ويقتلون فيقتلون الله سبيل في

والقران

\quranayah[9][111][1-23]

سبحانه واحد اله الله انما لكم خيرا انتهوا ثلاثة تقولوا ولا ورسله بالله فامنوا منه وروح مريم الى القاها وكلمته الله رسول مريم ابن عيسى المسيح انماالمقربون الملائكة ولا لله عبدا يكون ان المسيح يستنكف لن وكيلا بالله وكفى الارض في وما ماوات الس في ما له ولد له يكون ان

\ToggleAyahNumber\quranayah[An-Nisa][171-172][14-64]

The package, by default, typesets the text of the Holy Quran in simple script,but uthmani and uthmani-min change the default to Uthmani script. Compare theuthmaniuthmani-min following texts to figure out the differences between “default”, “uthmani”, and“uthmani-min” scripts.

15

رات مسخ والنجوم والقمر مس والش حثيثا يطلبه النهار الليل يغشي العرش على استوى ثم ايام ستة في والارض ماوات الس خلق الذي الله ربكم انبعد الارض في تفسدوا ولا ﴾٥٥﴿ المعتدين يحب لا انه وخفية تضرعا ربكم ادعوا ﴾٥٤﴿ العالمين رب الله تبارك والامر الخلق له الا بامره

﴾٥٦﴿ المحسنين من قريب الله رحمت ان وطمعا خوفا وادعوه اصلاحها

(default) \quranayah*[Al-Araf][54-56]

رت مسخ وٱلنجوم وٱلقمر مس وٱلش حثيثا يطلبهۥ ٱلنهار ٱليل يغشى ٱلعرش على ٱستوى ثم ايام ستة فى وٱلارض وت م ٱلس خلق ٱلذى ٱلله ربكم اناصلحها بعد ٱلارض فى تفسدوا ولا ﴾٥٥﴿ ٱلمعتدين يحب لا انهۥ وخفية تضرعا ربكم ٱدعوا ﴾٥٤﴿ ٱلعلمين رب ٱلله تبارك وٱلامر ٱلخلق له الا بامرهۦ

﴾٥٦﴿ ٱلمحسنين من قريب ٱلله رحمت ان وطمعا خوفا وٱدعوه

(uthmani) \quranayah*[Al-Araf][54-56]

رت مسخ والنجوم والقمر مس والش حثيثا يطلبه النهار اليل يغشى العرش على استوى ثم ايام ستة فى والارض موت الس خلق الذى الله ربكم اناصلحها بعد الارض فى تفسدوا ولا ﴾٥٥﴿ المعتدين يحب لا انه وخفية تضرعا ربكم ادعوا ﴾٥٤﴿ العلمين رب الله تبارك والامر الخلق له الا بامره

﴾٥٦﴿ المحسنين من قريب الله رحمت ان وطمعا خوفا وادعوه

(uthmani-min) \quranayah*[Al-Araf][54-56]

By version 1.3, the package can typeset the transliteration of the Holy Quran.This option will be useful for whom doesn’t really know how to read the arabictext. By loading translt option all macros defined in section 2 will have an “lt”transltversion. In other words, the following macros are added by this option:

• \quransurahlt

• \quranayahlt

• \quranpagelt

• \quranjuzlt

• \quranhizblt

• \quranquarterlt

• \quranrukult

• \quranmanzillt

• \qurantextlt

Bismi Allahi alrrahmani alrraheemiInna aAAtaynaka alkawthara (1)Fasalli lirabbika wainhar (2)Inna shaniaka huwa alabtaru (3)

\quransurahlt[108]

الرحيم الرحمن الله بسم﴾١﴿ الكوثر اعطيناك انا﴾٢﴿ وانحر لربك فصل

﴾٣﴿ الابتر هو شانئك ان

\quransurah[108]

The package can typeset some translations of the Holy Quran in other languages.These options were added because of some requests from users who had requiredthe translation of the Holy Quran in their languages. Loading transde, transen,transdetransen transfr, or transfa brings some other macros for typesetting the translation intransfrtransfa German, English, French, and Persian, respectively.By loading each of these options, all macros defined in section 2 will have a“de”/“en”/“fr”/“fa” version. In other words, these options will add the followingmacros:

16

transde option:

• \quransurahde

• \quranayahde

• \quranpagede

• \quranjuzde

• \quranhizbde

• \quranquarterde

• \quranrukude

• \quranmanzilde

• \qurantextde

transen option:

• \quransurahen

• \quranayahen

• \quranpageen

• \quranjuzen

• \quranhizben

• \quranquarteren

• \quranrukuen

• \quranmanzilen

• \qurantexten

transfr option:

• \quransurahfr

• \quranayahfr

• \quranpagefr

• \quranjuzfr

• \quranhizbfr

• \quranquarterfr

• \quranrukufr

• \quranmanzilfr

• \qurantextfr

transfa option:

• \quransurahfa

• \quranayahfa

• \quranpagefa

• \quranjuzfa

• \quranhizbfa

• \quranquarterfa

• \quranrukufa

• \quranmanzilfa

• \qurantextfa

All translations are from tanzil.net. For Germen, English, French, and Persianlanguages the “Abu Rida Muhammad ibn Ahmad ibn Rassoul”, “Ahmed Ali”,“Muhammad Hamidullah”, and “Mohammad Mahdi Fooladvand” have been cho-sen respectively, by suggestion of the package’s users.

The trans option has been prepared to simplify the usage of mutiple translationstranssimultaneously. This option accepts any permutation of “lt”, “de”, “en”, “fr”,and “fa”, e.g. “trans={de, en, lt}”.�There is no way to load all of the translations together. It is out of TEX memorycapacity. For more details, see Why do I get the “! TeX capacity exceeded” error?on page 20.

﴾٣﴿ الابتر هو شانئك ان ﴾٢﴿ وانحر لربك فصل ﴾١﴿ الكوثر اعطيناك انا الرحيم الرحمن الله بسم

\quransurah*[108]

17

In the name of Allah, most benevolent, ever-merciful.HAVE SURELY given you pre-eminence (in numbers andfollowing); (1)So serve your Lord with full dedication and sacrifice. (2)It is surely your opponents whose line will come to end.(3)

\quransurahen[108]

Im Namen Allahs, des Allerbarmers, des Barmherzigen!Wir haben dir die Überfülle gegeben. (1)Darum bete zu deinem Herrn und schlachte (Opfertiere).(2)Wahrlich, der dich haßt, ist es, der (vom Segen derNachkommenschaft) abgeschnitten ist. (3)

\quransurahde[108]

Au nom d'Allah, le Tout Miséricordieux, le Très Miséri-cordieux.Nous t'avons certes, accordé l'Abondance. (1)Accomplis la Salât pour ton Seigneur et sacrifie. (2)Celui qui te hait sera certes, sans postérité. (3)

\quransurahfr[108]

مهربان رحمتگر خداوند نام به(1) داديم، كوثر [چشمه ] را تو ما

(2) كن. قربانى و گزار نماز پروردگارت براى پس(3) بود. خواهد بى تبار خود دشمنت

\quransurahfa[108]

5 Frequently Asked Questions5.1 What is the best font for typesetting quran text?“Scheherazade”7 or “Amiri”8 fonts are strongly recommend.

Scheherazade is released under the SIL Open Font License (OFL), ver-sion 1.1. Copyright (c) 2004-2015, SIL International (http://scripts.sil.org/)with Reserved Font Names ”Scheherazade” and ”SIL”. Therefore youcan freely download it. All examples in this document use this font.

Amiri is a classical Arabic typeface in Naskh style for typesetting booksand other running text. Amiri is a revival of the beautiful typefacepioneered in early 20th century by Bulaq Press in Cairo, also knownas Amiria Press, after which the font is named. Amiri is a free, opensource project that everyone is encouraged to use and modify.

5.2 How to use quran package?As you’ve noticed, for typesetting quran text you need a package that can typesettext in RTL mode in additon to using UTF8 fonts, because quran draws its textfrom a unicoded databases. The polyglossia, fontspec, and bidi will do that foryou. You can also use xepersian that relies on fontspec, too. Another choices arearabxetex and arabluatex that the latter just works with LuaLATEX while formerways work with X ELATEX. The arabxetex and arabluatex use Amiri font by default.The following demonstrates some examples for all four approaches:

“example: with polyglossia, fontspec, and bidi”\documentclass{article}

\usepackage{quran}

7http://software.sil.org/scheherazade/8http://www.amirifont.org/

18

%%% for typesetting arabic text\usepackage{polyglossia}\setotherlanguage{arabic}

\usepackage{fontspec}\setmainfont{Scheherazade}

%%% for typesetting in Rigth−To−Left direction\usepackage{bidi}

\begin{document}

\setRTL % tell bidi to typeset the text in Rigth−To−Left direction\textarabic{\quransurah}

\end{document}

“example: with xepersian”\documentclass{article}

\usepackage{quran}

%%% for typesetting Persian/Arabic text in Rigth−To−Left direction\usepackage{xepersian}\settextfont{Scheherazade}

\begin{document}

\quransurah

\end{document}

“example: with arabxetex”\documentclass{article}

\usepackage{arabxetex} % for typesetting Arabic text in Rigth−To−Left direction\usepackage{quran}

\begin{document}

\begin{arab}[utf]\quransurah

\end{arab}

\end{document}

“example: with arabluatex”\documentclass{article}

\usepackage{arabluatex} % for typesetting Arabic text in Rigth−To−Left direction\usepackage{quran}

\begin{document}

\begin{txarab}\quransurah

\end{txarab}

\end{document}

19

5.3 How to set a default font for text of quran?If you want to automatically change the font of quran text in your document,precede the \qurantext with your willing font like below:

With fontspec, put the commands below in the preamble:\newfontfamily\quran{Scheherazade}\makeatletter\bidi@preto\qurantext{\quran}\makeatother

With xepersian, put the following commands in the preamble:\defpersianfont\quran{Scheherazade}\makeatletter\bidi@preto\qurantext{\quran}\makeatother

By setting default font the way mentioned above, if you want to use \qurantext,you have to enclose it in curly braces. If you don’t, it will affect the font of thefollowing texts.

{\qurantext[x−y]}

5.4 How to typeset a portion of the Holy Quran in oneparagraph with no ayah number without using noparoption?

Just put the code that was describled on page 15 in a group like below:

{\ToggleAyahNumber\quransurah∗}

الرحيم الرحمن الله «بسم ﴾٤﴿ احد كفوا له يكن ولم ﴾٣﴿ يولد ولم يلد لم ﴾٢﴿ مد الص الله ﴾١﴿ احد الله هو قل الرحيم الرحمن الله بسمولم يلد لم ﴾٢﴿ مد الص الله ﴾١﴿ احد الله هو قل الرحيم الرحمن الله بسم احد» كفوا له يكن ولم يولد ولم يلد لم مد الص الله احد الله هو قل

﴾٤﴿ احد كفوا له يكن ولم ﴾٣﴿ يولد

\quransurah* «{\ToggleAyahNumber\quransurah*}» \quransurah*

5.5 Why do I get the “! TeX capacity exceeded” error?Invention of TEX dates back to many years ago. Although we have great hardwarenowadays, TEX engine has been designed so that to use a very small amountof computer hardware due to the limitation of the computer at the time of itsinvention. The quran makes a plenty of macros which deplete the TEX’s memoryand therefore, sometimes lead to compile error. To solve this issue, you can expandTEX’s memory; see the section “Memory Limitations” in the pgfplots manual.However, that does not mean that expanding TeX’s memory is the best solution.Instead, I would recommend redesigning your document. For exmaple, if you usewordwise, most of starred version of macros which output a large portion of qurantext will cause “! TeX capacity exceeded”. In this case, make a similar outputwith using some smaller chunks. For instance, you want to typseset 10 first juzzeswith \quranjuz*[1-10] command and you may get

20

! TeX capacity exceeded, sorry [main memory size=5000000]or! TeX capacity exceeded, sorry [parameter stack size=10000]

errors. It would be better to typeset ecah juz separately, or even each page of thisrange – \quranjuz*[1] \quranjuz*[2] · · · \quranjuz*[10] or \quranpage*[1]\quranpage*[2] · · · \quranpage*[201].

6 History[2015/06/01 v0.1]

• Initial release in ParsiLATEX group under the name of qurantext.

• \qurantext added.

[2015/06/02 v0.2]• Redefinition of \do@qt in a nonrecursive style. The old recursive version

sometimes led to TEX stack overflow. Thanks to Masoud Yazdani for sug-gesting a solution to this issue.

[2015/06/02 v0.3]• Ayah’s number has been added to the end of each verse of the output. Thanks

to Mahmood AminToosi for suggesting this feature.

[2015/06/04 v0.4]• \surahname added. It outputs the arabic/anglicized title of a surah based

on text direction.

• The package renamed to quran.

[2015/06/24 v0.5]• Package renamed from qurantext to quran

• \quranayah added. It outputs a ⟨range⟩ of ayahs from a surah.

• \quransurah added. It outputs a ⟨range⟩ of surahs. Thanks to MahmoodAminToosi for suggesting this new feature.

[2015/06/28 v0.6]• \quranjuz added outputing a juz’s range of the Holy Quran.

[2015/06/30 v0.7]• \quranpage added outputing one or more pages of the Holy Quran,

[2015/07/02 v0.71]• A \par was appended to the basmalah. Thanks to Mahmood AminToosi for

suggesting this feature.

21

[2015/07/02 v0.72]• \basmalah added which typesets basmalah – الرحيم الرحمن الله .بسم

[2015/07/04 v0.8]• \quranquarter and \quranruku added.

[2015/07/07 v0.9]• \quranhizb and \quranmanzil added.

• The package was uploaded to CTAN.

[2015/07/10 v0.91]• “Al-Ikhlas” was set as default option for \quransurah.

[2015/07/11 v0.94]• \ChangeAyahNumber and\ChangeBasmalah added. These macros change the

way ayah’s number and basmalah will appear.

• A minor bug in extra white spaces around one ayah is solved now. ThanksMasoud Yazdani for reporting this issue.

[2015/07/11 v0.941]• Reducing the size of quran text file by moving \qt@par from the file to

\qurantext.

[2016/02/05 v1.0]• Support for using anglicized title of surah instead its index in \quransurah

and \quranayah.

[2016/02/09 v1.05]• \ChangeBasmalah and \ChangeAyahNumber renamed to \ToggleBasmalah

and \ToggleAyahNumber respectively.

• A minor bug in \quransurah* fixed – unwanted extra spaces in the output.Thanks Hosein Behboody for reporting this issue.

[2016/04/21 v1.1]• \indexconvert macro converts a number between 1 to 6236 to its exact

surah and ayah number in the whole text of Quran.

[2016/05/15 v1.14]• Documentation updates.

[2016/10/05 v1.2]• Supports Uthmani script via uthmani option. This option asked by one of

the package’s user.

22

[2016/11/07 v1.21]• Some minor bugs in uploading to CTAN

[2016/11/08 v1.22]• Sources of two pdf files used in the documentation appended to the bundle.

[2016/11/12 v1.24]• Documentation updates.

• Pause marks (waqf symbols) were missed from the penultimate version ofuthmani script.

[2016/11/15 v1.241]• Documentation updates.

[2016/12/25 v1.25]• Documentation updates.

[2016/12/25 v1.251]• Documentation updates.

[2017/02/28 v1.252]• Minor improvements.

[2017/08/22 v1.26]• Minor improvements

• Bug in \quranayah[x][y]; fixed by enclosing in a group. Thanks to SayyedSaieed Mosavi Nadooshani for reporting this issue.

• Documentation updates.

[2016/08/22 v1.261]• Documentation updates–a typo in version number.

[2017/10/22 v1.3]• Transliteration supported., now all macros have an “lt” version for typeset-

ting transliteration of the original macros. Thanks to Hamidreza Ahmadianfor suggesting this new feature.

[2017/10/28 v1.4]• Persian, English, and Deutsch translations added and “fa”, “en”, and “de”

version of macros defined for them. Three new options, the ‘transfa‘,‘transen‘, ‘transde‘ are defined.

• There is also a new option, ‘trans’ which can get the ‘lt’, ‘en’, ‘de’, and ‘fa’as its value seperated by comma.

23

[2017/12/22 v1.41]• in previous versions, \quransurah and \quranayah macros were case-

sensitive in case of using surah names, but by this version both macros arecase-insensitive, i.e. there in no diffirences between Al-Fatihda, al-fatiha,al-Fatiha, and the other possible combinations of lower-uppercase letters.

[2017/12/22 v1.42]• \quransurahX and \quranayahX macros also act case-insensitive with an-

glicized title of surahs. X stands for ‘en’, ‘de’, ‘fa’, or ‘lt’.

[2017/12/22 v1.42a]• Documentation update–a typo fixed.

• Some files were missed in the last update to CTAN.

[2018/11/29 v1.42b]• A typo in quran-transde.def.

[2018/12/01]• quran-de package is released adding 3 more translations of the German lan-

guage.

[2018/12/31 v1.5]• Minor bugs in \ToggleBasmalah and \quransurah.

[2019/05/03]• quran-ur package is released adding 8 translations of the Urdu language.

[2019/05/04 v1.51]• A typo in quran-transde.def.

[2020/03/07 v1.6]• support for getting any chunks of an ayah with two extra optional argu-

ments for \qurantext and \quranayah. This feature has been suggestedand supported financially by Atiyah Elsheikh. May God bless him.

• \Basmalah outputs basmalah without any surrounding whitespaces.

• Documentation revision.

[2020/03/09 v1.61]• Applying current font in footnote by \qt@doqt when \quranayah/\qurantext

is called by its “+” optional argument. In the last version it used Amiri font.

[2020/03/12 v1.62]• License update to LPPL Version 1.3c from LPPL Version 1.3

24

[2020/03/14 v1.63]• Pause marks (waqf symbols) have been removed from \quranayah and

\qurantext whenever [⟨chunk range⟩] optional parameter is used.

[2020/06/10 v1.7]• French translation added and “fr” version of macros defined for it. New

option, transfr, is defined for this translation.

• There is also a new value ‘fr’ for trans option.

• Documentation updates.

[2020/06/12 v1.7a]• Some of missed files (the French part) uploaded to CTAN.

[2020/10/14 v1.8]• New option ‘uthmani-min’; same behavior like ‘uthmani’ option prior to this

release.

• Now, the ‘uthmani’ option typesets the text of the Holy Quran with morediacritical marks; requested on this issue.

[2021/02/01]• quran-bn package is released adding 2 translations of the Bengali language;

requested on this issue.

[2021/02/02 v1.81]• Documentation update in compliance with the first release of the quran-bn

package.

Date Ver. Feature

2015/06/01 0.1 • Initial release in ParsiLATEX, named qurantext• \qurantext

2015/06/02 0.2 • Implementation of \do@qt in a nonrecursive style2015/06/02 0.3 • Provision of ayah’s number.2015/06/04 0.4 • \surahname outputing the arabic/anglicized title of a surah

• package renamed to quran2015/06/24 0.5 • \quranayah and \quransurah2015/06/28 0.6 • \quranjuz2015/06/30 0.7 • \quranpage2015/07/02 0.71 • Basmalah was followed by \par2015/07/02 0.72 • \basmalah – الرحيم الرحمن الله بسم2015/07/04 0.8 • \quranquarter and \quranruku2015/07/07 0.9 • \quranhizb and \quranmanzil

• The package was uploaded to CTAN.2015/07/10 0.91 • “Al-Ikhlas” as a default parameter for \quransurah2015/07/11 0.94 • \ChangeAyahNumber and\ChangeBasmalah

Resolving a minor bug2015/07/11 0.941 • Improvement in \qurantext

continued on next page

25

Date Ver. Feature

2016/02/05 1.0 • \quransurah and \quranayah support anglicized title of surahs2016/02/09 1.05 • \ChangeBasmalah and \ChangeAyahNumber renamed to

\ToggleBasmalah and \ToggleAyahNumber• A minor bug in \quransurah* fixed

2016/04/21 1.1 • \indexconvert2016/05/15 1.14 • Documentation updates2016/10/05 1.2 • uthmani option supporting Uthmani script2016/11/07 1.21 • Some minor bugs2016/11/08 1.22 • Documentation updates2016/11/12 1.24 • Documentation updates

• Pause marks (waqf symbols) were missed from uthmani script2016/11/15 1.241 • Documentation updates2016/12/25 1.25 • Documentation updates2016/12/25 1.251 • Documentation updates2017/02/28 1.252 • Minor improvements2017/08/22 1.26 • Minor improvements

• Bug fix in \quranayah[x][y]• Documentation updates

2016/08/22 1.261 • Documentation updates2017/10/22 1.3 • Transliteration supported via translt option2017/10/28 1.4 • Persian, English, and Deutsch translations via transfa, transen,

and transde options• trans option with ‘lt’, ‘en’, ‘de’, and ‘fa’ values

2017/12/22 1.41 • case-insensitive \quransurah and \quranayah2017/12/22 1.42 • case-insensitive \quransurahX and \quranayahX

X ∈ {‘en’, ‘de’, ‘fa’, ‘lt’}2017/12/22 1.42a • Documentation updates2018/11/29 1.42b • A typo in quran-transde.def2018/12/01 First release of the quran-de package2018/12/31 1.5 • Bug fix in \ToggleBasmalah and \quransurah2019/05/03 First release of the quran-ur package2019/05/04 1.51 • A typo in quran-transde.def2020/03/07 1.6 • \qurantext and \quranayah support any chunks of an ayah

• \Basmalah • Documentation revision2020/03/09 1.61 • Minor update in \quranayah and \qurantext2020/03/12 1.62 • License update to LPPL Version 1.3c2020/03/14 1.63 • Removing pause marks with ⟨chunk range⟩ optional parameter2020/06/10 1.7 • French translation available via transfr option, or trans option

with ‘fr’ value2020/06/12 1.7a • CTAN upload correction.2020/10/14 1.8 • ‘uthmani’ is renamed to ‘uthmani-min’

• ‘uthmani’ typesets text of the Holy Quran with more diacriticalmarks.

2021/02/01 First release of the quran-bn package2021/02/02 1.81 • Documentation updates

Table 3: Brief History of the quran Development

26