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.
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.
*_Tafseer_Siddiqi_Master.json) into 5 synchronized deliverables: Bilingual HTML, Monolingual Urdu HTML, Interactive Proofreading Workbench HTML, Bilingual Markdown, and Monolingual Urdu Markdown.
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.
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.
ترجمہ :-), commentary paragraphs, and poetry couplets into authoritative Modern Standard Academic English using IJMES transliteration and preserving inline Arabic terms before their transliterated glosses.
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.
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.
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.
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:
--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.
--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.
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..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).اُمت, دُور, اُردو, اُتار, رحمٰن, تعاظم) are explicitly whitelisted in URDU_DISAMBIG so they remain in continuous Nastaliq flow rather than switching to Naskh mid-sentence."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.
ترجمہ (آیت 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.
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ī).
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).
تفسیرِ صدیقی بتیس (۳۲) جلدوں پر مشتمل قرآنِ مجید کی وہ عظیم الشان اردو تفسیر ہے جسے بحر العلوم حضرت مولانا محمد عبد القدیر صدیقی قادری حسرت رحمۃ اللہ علیہ (۱۸۷۱ء–۱۹۶۲ء، سابق صدر شعبۂ دینیات، جامعہ عثمانیہ حیدرآباد دکن) نے تحریر فرمایا۔ اس کے ساتھ حضرت رحمۃ اللہ علیہ کے ۴۹ نادر علمی، فقہی، کلامی اور عرفانی رسائل و مخطوطات کو بھی اسی مستند ڈیجیٹل نظام میں شامل کیا گیا ہے۔
Master.json) سے بیک وقت دو لسانی ایچ ٹی ایم ایل، اردو ایچ ٹی ایم ایل، پروف ریڈنگ ورک بینچ اور مارک ڈاؤن (Markdown) اشاعتوں میں مرتب ہوتی ہے۔﴿۱﴾ اور انگریزی جانب میں مدینہ مصحف کا عثمانی رسم الخط ﴿1﴾۔ط، ج، ز، ص، م، قف، صلے) اور مشرقی آیت نمبر ﴿۱﴾ شامل ہیں۔ترجمہ :-) اور تفسیر کے پیراگراف علیحدہ خانوں میں رکھے گئے ہیں اور احادیثِ مبارکہ کی مستند کتبِ سنّت سے توثیق کی گئی ہے۔