بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ

Tafsīr-e-Ṣiddīqī — Methodology & Digital Architecture Overview

Scholarly editorial principles, 6-step publishing pipeline, Dual-Canonical Quranic script architecture (Indo-Pak & Tanzil Uthmani HAFS), multi-script typography, and quality assurance standards governing the 32-volume digital edition.

✓ 32 Volumes Complete (Muqaddimah, Fātiḥah, Paras 1–30) ✓ Option 3 Dual-Canonical Quranic Fonts ✓ Option B Multi-Page Verse Handling ✓ Zero-Truncation Verbatim Mandate

1. Scholarly Heritage & Editorial Vision

Tafsīr-e-Ṣiddīqī is the monumental 32-volume Qur'anic commentary authored by Baḥr al-‘Ulūm Ḥaḍrat Muḥammad ‘Abd al-Qadīr Ṣiddīqī Qādrī ‘Ḥasrat’ (Rh.A) (1871–1962 CE), former Head of the Faculty of Theology (Dīniyyāt) at Osmania University, Hyderabad Deccan. Written in eloquent classical Deccani/standard literary Urdu enriched with Arabic philology, Hanafi/Shafi‘i jurisprudence, Ash‘ari/Maturidi philosophical theology, and Akbari/Qadiri spiritual metaphysics, the commentary bridges rigorous grammatical exegesis with profound spiritual insight.

32 Complete Volumes
Encompasses the 57-page Muqaddimah (16 core principles of exegesis and non-abrogation treatise), the standalone 39-page Sūrah al-Fātiḥah commentary, and all 30 Qur'anic Juz' volumes (Para 1 to Para 30) spanning 2,728 manuscript scan pages.
Zero-Truncation Mandate
Every sentence, lexical root analysis (māddah, bāb, i‘rāb), theological refutation, historical narrative, parenthetical gloss, and poetic couplet is transcribed verbatim in Urdu and translated sentence-by-sentence into Modern Standard Academic English.
160 Production Deliverables
Each of the 32 volumes is compiled from a single canonical source of truth (*_Tafseer_Siddiqi_Master.json) into 5 synchronized deliverables: Bilingual HTML, Monolingual Urdu HTML, Interactive Proofreading Workbench HTML, Bilingual Markdown, and Monolingual Urdu Markdown.

2. The 6-Step Digital Publishing Pipeline

1
Manifest & Multi-OCR Ingestion
init_para.py discovers all manuscript scans (Title.gif, 2.gif…), inspects exact pixel dimensions, cross-references primary Google DocAI and secondary UOCR files, extracts Urdu book page numbers, and partitions pages into structured batch skeletons.
2
Multi-Source Verbatim Transcription
Disambiguates OCR errors by comparing DocAI, UOCR, and the high-resolution scan image. Segments each page into typed structural blocks: surah_header, ayah, translation, commentary, heading, and poetry, stripping running page headers and catchwords.
3
Modern Academic English Translation
Translates all headings, running verse translations (ترجمہ :-), commentary paragraphs, and poetry couplets into authoritative Modern Standard Academic English using IJMES transliteration and preserving inline Arabic terms before their transliterated glosses.
4
Dual-Canonical Quranic Verification
Authenticates every ayah block against canonical databases: vocalized South Asian Indo-Pak script with classical waqf marks and Eastern numerals ﴿۱﴾ in text, and pure Tanzil Uthmani script (Medina Mushaf) with Western numerals ﴿1﴾ in text_en.
5
Automated Build & Typography Engine
build_edition.py compiles Master.json and generates all 5 deliverables with automatic inline Arabic Naskh detection (.ar-inline), superscript rumūz al-awqāf, hemistich poetry grids, cross-volume navigation, sticky themes, and bookmarking.
6
Automated QA & Live Workbench
verify_para.py enforces 100% bilingual parity, zero stray waqf letters, 100% verse numbering, and ≥85% DocAI transcription coverage. workbench_server.py provides side-by-side scan inspection, OCR diffing, and live disk saving.

3. Dual-Canonical Quranic Script & Typography Architecture

To honor both the South Asian lithographic heritage of the Hyderabad Deccan manuscript and international Qur'anic studies standards, the pipeline implements Option 3 Dual-Canonical Script Rendering with dedicated OpenType font stacks for each script tradition:

Urdu / Arabic Side — Indo-Pak Calligraphic Script
Rendered using --font-quran-indopak ('PDMS Saleem QuranFont', 'Al Qalam Quran Majeed', 'Noorehuda', 'Lateef', 'Scheherazade New', 'Noto Naskh Arabic'). Preserves South Asian Jazm (ۡ), standing alifs, classical waqf superscripts (ط, ج, ز, ص, م, قف, صلے), and Eastern Urdu verse medallions.
الٓمّٓ ۚ ﴿۱﴾ ذٰلِكَ الْكِتٰبُ لَا رَيْبَ ۚۖۛ فِيْهِ ۚۛ هُدًى لِّلْمُتَّقِيْنَ ۙ ﴿۲﴾
English / Translation Side — Tanzil Uthmanic HAFS Script
Rendered using --font-quran-uthmani ('KFGQPC Uthmanic Script HAFS', 'UthmanicHafs', 'Amiri Quran', 'Me Quran', 'Scheherazade New', 'Amiri'). Displays pure Medina Mushaf Uthmanic orthography (ٱ waṣlah, dagger alif following dotless ى, Uthmani pause signs) and Western verse medallions.
الٓمٓ ﴿1﴾ ذَٰلِكَ ٱلْكِتَٰبُ لَا رَيْبَ ۛ فِيهِ ۛ هُدًى لِّلْمُتَّقِينَ ﴿2﴾

Multi-Script Shaping & Disconnected Letter Prevention

  • Unicode Extended-A Normalization: Rare Unicode 14.0 codepoints such as U+089C (Arabic Madda Waajib) and U+08D5–U+08E2—which lack glyph shaping tables in standard macOS/Windows Nastaliq and Naskh fonts and cause letters to break apart—are normalized to standard U+0653 (ٓ Maddah Above) and canonical Arabic combining marks across all 32 volumes.
  • Urdu Nastaliq vs. Inline Arabic Naskh (.ar-inline) Separation: Unvoweled Urdu commentary words use canonical Urdu codepoints (ک U+06A9, ی U+06CC, ہ U+06C1) rendered in 'Jameel Noori Nastaleeq' / 'Noto Nastaliq Urdu'. Vocalized Arabic citations embedded inside Urdu or English prose are automatically wrapped in <span class="ar-inline"> and normalized to Arabic Naskh codepoints (ك U+0643, ي U+064A, ه U+0647, while preserving dotless Alif Maqsurah ى U+0649 after standing fatha \u0670 or fathatan \u064B).
  • Voweled Urdu Disambiguation: Common voweled Urdu words (such as اُمت, دُور, اُردو, اُتار, رحمٰن, تعاظم) are explicitly whitelisted in URDU_DISAMBIG so they remain in continuous Nastaliq flow rather than switching to Naskh mid-sentence.

4. Structural Standards: Paragraph Flows, Option B Continuations & Poetry

Option B Multi-Page Verse Continuations
When a Qur'anic verse spans across physical manuscript pages, the complete verified canonical verse is rendered on the page where it begins with its full verse medallion. On the subsequent page, the continuation block is tagged with "continues_from_prev": true and renders a clean notice ([آیت جاری ہے...] / [Verse continued...]) in the workbench, while the Continuous Reading Edition places an inline page-turn marker seamlessly without duplicating the verse box.
Strict Translation vs. Commentary Block Separation
Running verse translations (ترجمہ (آیت N) :-) are strictly isolated in type: "translation" blocks with preserved multi-line <br> breaks and explicit metadata (surah_num, verse_num, verse_num_ur). Any commentary text following a verse translation is split into a dedicated type: "commentary" block so translation callout boxes never merge with subsequent exegesis.
Classical Poetry & Hemistich Grids
All Urdu, Persian, and Arabic couplets are isolated in type: "poetry" blocks, tagged with poetry_lang ("ur", "fa", or "ar"), and formatted with hemistich dividers (÷ or triple-space) to render balanced two-column .hemistich-pair verse grids accompanied by traditional poet attributions (e.g., Ḥasrat Ṣiddīqī, Sa‘dī Shīrāzī, Ḥāfiẓ, Rūmī).
Cross-Para Navigation, Sticky Theme & Bookmarks
All 64 Reading Editions and 32 Workbenches feature unified sticky Light/Sepia/Dark theme persistence (tafseer-theme + ?theme= URL propagation), seamless Cross-Para Prev/Next Page navigation across volume boundaries (navigating past the last page of a Para opens Page 1 of the next Para, and vice versa), a 32-volume quick switcher, auto-tracked reading progress (tafseer-last-read), and a slide-out Bookmarks Drawer (tafseer-bookmarks).

۱۔ علمی و تحقیقی پسِ منظر اور منہجِ اشاعت

تفسیرِ صدیقی بتیس (۳۲) جلدوں پر مشتمل قرآنِ مجید کی وہ عظیم الشان اردو تفسیر ہے جسے بحر العلوم حضرت مولانا محمد عبد القدیر صدیقی قادری حسرت رحمۃ اللہ علیہ (۱۸۷۱ء–۱۹۶۲ء، سابق صدر شعبۂ دینیات، جامعہ عثمانیہ حیدرآباد دکن) نے تحریر فرمایا۔ اس کے ساتھ حضرت رحمۃ اللہ علیہ کے ۴۹ نادر علمی، فقہی، کلامی اور عرفانی رسائل و مخطوطات کو بھی اسی مستند ڈیجیٹل نظام میں شامل کیا گیا ہے۔

مکمل ۳۲ مجلدات و ۴۹ رسائل
تفسیرِ صدیقی کا ۵۷ صفحات پر مشتمل مقدمہ (اُصولِ تفسیر)، مستقل جلد سورۃ الفاتحہ، تمام ۳۰ پارے (۲,۷۲۸ عکسی صفحات) اور ۴۹ کلاسیکی رسائل مکمل طور پر شائع و تصدیق شدہ ہیں۔
حرف بہ حرف کامل نقل (Zero Truncation)
ہر جملہ، لغوی و نحوی بحث (مادہ، باب، اعراب)، کلامی و فقہی استدلال، تاریخی واقعہ اور فارسی و اردو اشعار اصل مخطوطے کے مطابق حرف بہ حرف اردو میں محفوظ کیے گئے ہیں اور علمی انگریزی میں ان کا مکمل ترجمہ کیا گیا ہے۔
متحدہ مصدر (Master JSON)
ہر کتاب ایک مرکزی ڈیٹابیس (Master.json) سے بیک وقت دو لسانی ایچ ٹی ایم ایل، اردو ایچ ٹی ایم ایل، پروف ریڈنگ ورک بینچ اور مارک ڈاؤن (Markdown) اشاعتوں میں مرتب ہوتی ہے۔

۲۔ چھ (۶) مراحل پر مشتمل ڈیجیٹل اشاعتی نظام

۱
عکسی اسکین اور دوہرا OCR اندراج
تمام اصل مطبوعہ اور قلمی صفحات کی ترتیب، صفحہ نمبر کی شناخت اور Google DocAI و UOCR متون کا تقابلی جائزہ۔
۲
تصحیح شدہ متن اور ساختی تقسیم
اصل صفحے کی تصویر سے حرف بہ حرف مقابلہ کر کے عبارت کو قرآنِ مجید کی آیات، ترجمہ، تفسیر، حدیث، عنوان اور اشعار کے خانوں میں تقسیم کرنا۔
۳
جدید علمی انگریزی ترجمہ
تمام تفسیری مباحث، قرآنی تراجم اور فارسی و عربی اشعار کا مستند علمی انگریزی ترجمہ مع معیاری اصطلاحات (IJMES)۔
۴
دوہری مستند قرآنی تصدیق
اردو جانب میں برصغیری نستعلیق/نaskh قرآنی رسم الخط مع رموزِ اوقاف ﴿۱﴾ اور انگریزی جانب میں مدینہ مصحف کا عثمانی رسم الخط ﴿1﴾۔
۵
خودکار خطاطی و اشاعتی انجن
عربی عبارات کے لیے خودکار نسخ ٹیگ، فارسی و اردو اشعار کے لیے دو مصری جدول، اور برصغیری و جدید دکنی املا کا تحفظ۔
۶
خودکار جانچ اور لائیو ورک بینچ
ہر صفحہ، آیت نمبر، حدیث حوالہ اور ترجمے کی ۱۰۰٪ مطابقت کی جانچ اور تین خانوں والا براہِ راست تصحیحی ورک بینچ۔

۳۔ دوہری قرآنی رسم الخط اور کثیر اللسانی معماریت

اردو / عربی حصہ — برصغیری رسم الخط (Indo-Pak)
برصغیری قرآنی خط میں جزم، کھڑا زبر، قدیم رموزِ اوقاف (ط، ج، ز، ص، م، قف، صلے) اور مشرقی آیت نمبر ﴿۱﴾ شامل ہیں۔
الٓمّٓ ۚ ﴿۱﴾ ذٰلِكَ الْكِتٰبُ لَا رَيْبَ ۚۖۛ فِيْهِ ۚۛ هُدًى لِّلْمُتَّقِيْنَ ۙ ﴿۲﴾
انگریزی / تحقیقی حصہ — عثمانی رسم الخط (HAFS)
مصحفِ مدینہ کے مستند عثمانی رسم الخط کے مطابق الفِ وصل، عثمانی وقف علامات اور عالمی نمبر ﴿1﴾ کے ساتھ پیش کیا گیا ہے۔
الٓمٓ ﴿1﴾ ذَٰلِكَ ٱلْكِتَٰبُ لَا رَيْبَ ۛ فِيهِ ۛ هُدًى لِّلْمُتَّقِينَ ﴿2﴾

۴۔ معیاراتِ ترتیب: تسلسلِ آیات، احادیث اور اشعار

دو صفحات پر پھیلی آیات (Option B)
اگر کوئی طویل آیت دو صفحات پر مشتمل ہو تو مکمل تصدیق شدہ آیت پہلے صفحہ پر اور اگلے صفحہ پر صاف تسلسل کا نشان ظاہر ہوتا ہے تاکہ قاری کو تکرار یا انقطاع نہ ملے۔
ترجمہ اور تفسیر کی علاحدہ شناخت
قرآنی ترجمہ (ترجمہ :-) اور تفسیر کے پیراگراف علیحدہ خانوں میں رکھے گئے ہیں اور احادیثِ مبارکہ کی مستند کتبِ سنّت سے توثیق کی گئی ہے۔
اردو، فارسی و عربی اشعار کی جدول بندی
تمام اشعار اور رباعیات کو دونوں مصرعوں کے متوازن خانوں (Hemistich Grid) میں مع شاعر کے نام و نسبت سجایا گیا ہے۔
دو لسانی واجهة، تھیم اور نشانات
پوری ویب سائٹ میں بیک وقت انگریزی و اردو مینو، روشن/قدیم/تاریک تھیم، محفوظ نشانات (Bookmarks) اور ۸۱ کتب کی فوری تلاش شامل ہے۔