Skip to content

Add docs/phrases.html — Common Phrases, Dhikr, Essential Verses/Surahs, Duʿās & Salawat reference page#22

Draft
Copilot wants to merge 3 commits into
cairofrom
copilot/create-translations-page-docs
Draft

Add docs/phrases.html — Common Phrases, Dhikr, Essential Verses/Surahs, Duʿās & Salawat reference page#22
Copilot wants to merge 3 commits into
cairofrom
copilot/create-translations-page-docs

Conversation

Copilot AI commented Feb 24, 2026

Copy link
Copy Markdown
Contributor

Adds a new reference page to the /docs website covering commonly needed Islamic phrases, Quranic verses, short surahs, duʿās, and salawat — all rendered in the same table-based style as the existing surah pages with full multi-translation support.

New page: docs/phrases.html

Five sections, each as a styled table with the same CSS and translation row structure as surah pages:

  • Common Phrases & Dhikr — Shahada, Basmala (from 1:1), Tasbih, Tahmid, Takbir, Tahlil, Hawqala, Istighfar, Inshāʾ Allāh, Māshāʾ Allāh, Salawat
  • Essential Ayah — Āyat al-Kursī (2:255), Āmanar-Rasūlu (2:285–286), Rabbanā Ātinā (2:201)
  • Essential Surahs — Al-Fātiḥah (1), Al-Ikhlāṣ (112), Al-Falaq (113), An-Nās (114), Al-Kāfirūn (109), Al-ʿAṣr (103) — full verse-by-verse with all translations
  • Common Duʿās — Meals, bathroom entry/exit, distress (21:87), parents (17:24), janazah, traveler (43:13–14)
  • Special Salawat — Durood-e-Ibrahim (complete Arabic + transliteration + English)

Quranic entries pull all nine existing translation layers (Pickthall, Yusuf Ali, Sahih Intl, Qarai, Abridged Expl., Hindi Farooq/Suhail/Mokhtasar, Gujarati) plus both transliterations directly from the already-loaded data dictionaries.

Generator changes: src/gendocshtml.py

Added three helper functions and a generation block at the end of the existing script so make generate-docs keeps the page in sync:

_phrase_rows(title, ar, tl_unicode, en_meaning, ...)  # non-Quranic entries
_ayah_rows(sura, ayah, title='')                       # full multi-translation Quranic rows
_section_table(h2_title, rows_html)                    # wraps rows in a labelled table

Navigation

  • docs/index.html header and surah grid card both link to phrases.html
  • phrases.html header includes the surah dropdown navigator and search link

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

…hs, Duas & Salawat

Co-authored-by: druvx13 <131332414+druvx13@users.noreply.github.com>
Copilot AI changed the title [WIP] Add translations page with Quranic texts to docs Add docs/phrases.html — Common Phrases, Dhikr, Essential Verses/Surahs, Duʿās & Salawat reference page Feb 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants