# قبل أن تبني قارئ مصحف — لماذا الصورة لا الخطّ

[  كلّ الوثائق ](/ar/docs) 

١٢ ربيع الأول ١٤٤٨ هـ 

# قبل أن تبني قارئ مصحف — لماذا الصورة لا الخطّ

أكثر تطبيقات المصحف المتخصّصة تعرض الصفحة صورةً لا نصًّا، وقلّ أن تجد ذلك مكتوبًا قبل أن تبدأ. هنا ما أخطأنا فيه أوّل مرّة، والطبقات الثلاث التي يقوم عليها المصحف الرقميّ، والأداة المفتوحة التي تُخرج صفحاته.

---

# قبل أن تبني قارئ مصحف — لماذا الصورة لا الخطّ

مقدّمةٌ لمن يكتب أوّل قارئ مصحف، كتبها فريقٌ سلك الطريق الأطول.

## ما جرّبناه أوّلًا

بدأنا من البديهيّ. لدينا نصّ القرآن، ولدينا خطٌّ عربيّ، فعرضنا النصّ في الشاشة وتوقّعنا أن نرى مصحفًا.

بدا الأمر سليمًا على المحاكي. ثمّ شغّلناه على جهازٍ ثانٍ فانكسرت السطور في مواضع أخرى. وجهازٌ ثالث أزاح الحركات عن مواضعها. واختلف آيفون وأندرويد على النصّ الواحد. وكلّ إصلاحٍ لكثافة شاشةٍ كان يفسد شيئًا في غيرها، ولم تطابق الصفحةُ قطّ المصحفَ المطبوع الذي نحاول نقله.

وقضينا وقتًا طويلًا نعامل هذا على أنّه خللٌ في شفرة التخطيط لدينا. ولكنّه ليس بخلل. هذا ما يحدث حين تطلب من محرّك عرض نصٍّ أن ينقل صفحةً خطّها خطّاطٌ بيده.

وما لم نتبيّنه إلّا بعد حين: **تطبيقات المصحف المتخصّصة لا تعرض الصفحة نصًّا، بل تعرض صورتها.**

## لِمَ غلبت الصورةُ الخطَّ

وهذا مختصره، وتفصيله في [لماذا تبدو تطبيقات المصحف على هذه الهيئة](/ar/docs/islamic-typography):

مصحف المدينة هو التخطيط الذي يحفظ منه أكثر الحفّاظ. خمسة عشر سطرًا في الصفحة، و٦٠٤ صفحات، ولا تنقسم آيةٌ بين صفحتين. ومن حفظ منه يعرف موضع الآية من صفحتها. فإن أعدت توزيع النصّ على الأسطر ليوافق حجم الخطّ، كسرتَ الشيء الذي يستعمل الصفحةَ من أجله.

وأنت تنافس خطّاطًا كذلك. فالصفحة المطبوعة عمل عثمان طه، ومحرّك خطٍّ يحاكيها سيقصر عنها، ويقصر بطريقةٍ مختلفة في كلّ جهاز، وهذا هو الجزء الذي كلّفنا أسابيع.

اعرض الصورة، فتذهب المشكلتان معًا. الصفحة عمل الخطّاط مصوَّرًا، وتبدو واحدةً في كلّ مكان.

## ممّ يُبنى المصحف الرقميّ

فإذا سلّمت بالصورة، اتّضح شكل التطبيق. تحتاج ثلاثة أشياء، يستقلّ بعضها عن بعض.

**صور الصفحات.** واحدةٌ لكلّ صفحة، ولكلّ طبعة، ولكلّ لون ورقٍ إن أردت وضعًا داكنًا. وهي معظم ما يحمّله المستخدم.

**خريطة الحدود.** الصورة وحدها صمّاء: لا يعرف التطبيق أوقعت النقرة على الآية الثالثة أم الرابعة. فتُرفق مع كلّ طبعة قاعدةً صغيرة بمستطيلات الحروف: لكلّ حرفٍ سورتُه وآيتُه وسطرُه وإزاحتُه وعرضُه. فإذا أردت آيةً قابلة للنقر، استعلمتَ حروفها، وجمعتَها بحسب السطور، وردَدت كلّ سطرٍ إلى مستطيل. وبها كذلك تُظلّل الآية أثناء التلاوة.

**النصّ.** تحتاج نصّ الآيات نصًّا، لأنّك لا تبحث في صورة. اجعله في قاعدةٍ صغيرة مستقلّة عن الصور.

ثلاث طبقات، وثلاثة معدّلات تغيّر. الصور لا تكاد تتغيّر. والحدود تتغيّر كلّما وُلّدت الصور. والنصّ يكاد لا يتغيّر. فاجعل لكلّ طبقةٍ رقم إصدارٍ مستقلًّا، وإلّا أعدتَ تحميل مئات الميغابايتات لتصحيح مستطيل.

## ولعلّك لا تحتاج إلى كتابة هذا بنفسك

قد سبقنا وسبقك إليه Quran.com. فمشروع [quran.com-images](https://github.com/quran/quran.com-images) يُخرج صفحات المصاحف منذ سنين، ومنه جاء منهجنا. فإن كانت الصفحات هي ما تريد، فخذه وتجاوز ما يلي.

### فلماذا بنينا واحدًا آخر؟

لأنّه يُخرج الصفحة كاملةً أو الآية وحدها، وكنّا نحتاج السطر.

صورة الصفحة رسمٌ ثابت. فعلى شاشةٍ تخالف نسبتها تحصرها بين هامشين، وعلى الهاتف يعني ذلك أنّ الخطّ يخرج أصغر ممّا تتّسع له الشاشة.

أمّا خمسة عشر سطرًا مستقلّة فيمكن أن يُفرد كلٌّ منها على العرض المتاح، فتملأ الصفحةُ الشاشة ويكبر الخطّ معها. وبهذا يصير تخطيط الهاتف وتخطيط الصفحتين على الجهاز اللوحي مسارًا واحدًا في الشفرة.

والثمن؟ عددُ ملفّاتٍ أكبر بخمس عشرة مرّة، تحمّلها وتضعها في مواضعها وتخزّنها.

وجاء مع إعادة الكتابة ثلاثة أمور.

تُخرج الأداة حدود الحروف في المرّة نفسها التي تُخرج فيها الصور. والحدود المولَّدة على حدة تنحرف عن البكسلات التي تصفها. وانتبه للترتيب. فأنت تُشغّل الأداة أكثر من مرّة، مرّتين على الأقلّ: مرّةً للصور الفاتحة، ومرّةً للداكنة. وكلّ مرّةٍ تُضيف إلى قاعدة الحدود ولا تستبدلها، فتخرج من المرّتين بنسختين من كلّ حرف. ولهذا تحذف سكربتات الإخراج لدينا القاعدةَ أوّلًا، ثمّ تدع آخر تشغيلٍ للسطور يكتبها وحده.

وتُخرج طبعات ١٤٠٥ و١٤٢٠ و١٤٣٩، وهي النسخة الأولى والثانية والرابعة من خطّ المجمّع، وتكتبها المسارات `v1` و`v2` و`v4`. وليس فيها شيءٌ مقيَّدٌ برواية حفص. فالرواية في خطوط الصفحات وقاعدة التخطيط، ورواية أخرى مسألةُ توفير هذين لا تعديلِ شفرة. وفي هذا فائدةٌ لمن يبني لمنطقةٍ تقرأ بورش أو قالون، حيث النقص في بيانات المصحف لا في الأدوات.

وتعالج الوضع الداكن بحسب الطبعة. فطبعتا ١٤٠٥ و١٤٢٠ أحاديّتا اللون، يلوّنهما التطبيق عند العرض فتكفي مجموعةُ صورٍ واحدة للوضعين.

أمّا طبعة ١٤٣٩ فتحمل ألوان التجويد، والتلوين يردّها جميعًا إلى لونٍ واحد. فنُخرجها مرّتين: مرّةً كما طُبعت، ومرّةً بحبرٍ آخر وألوان تجويدٍ مُعاد ضبطها ليبلغ تباينُ كلّ لونٍ منها ٤٫٥:١ على الأقلّ مع خلفية القراءة الداكنة. واحسب لذلك حسابه، فالطبعة الملوّنة مع وضعٍ داكن مجموعتا صورٍ لا واحدة.

في آخر كلّ آيةٍ دائرةٌ صغيرة فيها رقمها. والأداة ترسم هذه الدوائر افتراضيًّا داخل الصورة نفسها، فتصير من بكسلاتها لا تُنزع بعد ذلك.

فإن أعطيتها خيار `no-markers` أخرجت حروف النصّ وحدها وتركت الدوائر، ثمّ يرسمها التطبيق فوق الصورة عند العرض، ويضعها في مواضعها من قاعدة الحدود. وكلّ إخراجٍ لدينا يمرّ بهذا الخيار.

والفرق بين دائرةٍ في الصورة ودائرةٍ يرسمها التطبيق أربعة أمور:

* أنّها هدفٌ للمس، فنقرُ الرقم يفتح قائمة الآية.
* وأنّها تتبدّل دون إعادة إخراج الصورة، فيحلّ شريط الفاصل محلّ الرقم.
* وأنّ صورة السطر تبقى محايدةً تقبل التلوين، وتأخذ الدائرة لونها وحدها. وبهذا أمكن تلوين الطبعات أحاديّة اللون أصلًا.
* وأنّ الرقم يُرسم عند العرض، فلا يلزمك إخراجٌ جديد كلّما تغيّر شيء.

فإن كنت تُخرج للطباعة فلا حاجة بك إلى هذا كلّه: أدرِج الدوائر في الصورة.

وأداتنا هي [NedaaDevs/quran-image-generator](https://github.com/NedaaDevs/quran-image-generator)، على Bun وTypeScript وSQLite ومكتبة رسم، بدل Perl وMySQL وGD، وهو ما أتاح لنا إبقاءها في مسار البناء نفسه مع التطبيق. وهي تكتب الشكلين معًا: `pages/001..604.png`، و`lines/{page}/001..015.png` بخمسة عشر ملفًّا للصفحة.

## البحث والتشكيل

يبقى أمرٌ واحد يفاجئك بعد أن تستقيم الصور.

النصّ في قاعدتك محفوظٌ بتشكيله كاملًا، والناس يبحثون بلا تشكيل. فطلبُ «الرحمن» لا يصيب «الرَّحْمَٰنِ» بمقارنةٍ حرفية، فيعود بحثك فارغًا ويبدو معطّلًا.

والحلّ أن تفهرس نسخةً مجرّدة وتعرض النسخة الكاملة. نحن نستعمل FTS5 في SQLite، فنُسقط التشكيل والألف الخنجرية ونوحّد صور الألف في طريقها إلى الفهرس، وتبقى السلسلة المعروضة كاملة. فتبحث بالكلمة المجرّدة وترى الآية بتشكيلها.

## من أين تُستقى البيانات

كلّها متاحة، ولكلٍّ منها رخصةٌ ينبغي أن تقرأها.

* **النصّ** — [مشروع تنزيل](https://tanzil.net)، بالرسم العثماني، برخصة CC-BY 3.0، ويلزمك فيها نسب العمل إلى أصحابه.
* **الخطوط وتخطيط الصفحة** — مجمّع الملك فهد لطباعة المصحف الشريف، في طبعات ١٤٠٥ و١٤٢٠ و١٤٣٩، وهي النسخة الأولى والثانية والرابعة من خطّ QCF.
* **حدود الآيات والأجزاء والأحزاب، ومواضع السجدات، وأزواج المتشابهات** — [المكتبة القرآنية الشاملة](https://qul.tarteel.ai) من ترتيل. وأكثر ما يحتاجه القارئ من بياناتٍ بعد النصّ نفسه موجودٌ هنا.

ونحن نذكر الثلاثة في شاشة الشكر والتقدير داخل التطبيق. رخصة تنزيل تُلزم بنسب العمل إلى أصحابه، وأمّا البقيّة فلأنّ من يقرأ من عملٍ ينبغي أن يرى صاحبه.

## ثمن هذا الاختيار

ولنصارحك: صور الصفحات ملفّاتٌ كبيرة، وذاك ثمن الوفاء للمطبوع.

ووضع السطور يزيد الأمر سوءًا قبل أن يحسّنه. ٦٠٤ صفحات في خمسة عشر سطرًا تعني ٩٠٦٠ ملفًّا لكلّ طبعة، ومثلها للوضع الداكن حيث تحتاجه الطبعة.

وجلبها واحدًا واحدًا على شبكة الجوّال يكلّف من الذهاب والإياب أكثر ممّا تساويه البايتات، وإذا انقطع الاتّصال في منتصفها بقيت لك ملفّاتٌ ناقصةٌ لا تدري أيّها تمّ.

فتُوزَّع كلّ طبعةٍ في أرشيفٍ واحد: يحمّل التطبيق ملفًّا واحدًا، ويفكّه، وينقل الناتج إلى موضعه. ولهذا صار شريط التقدّم ثلاث مراحل لا مرحلة، ولهذا لا يكون الفكّ لحظيًّا على هاتفٍ قديم.

وما بقي فتجربة التحميل، وفيها تكسب المستخدم أو تخسره. إيقافٌ واستئناف، وفحصٌ للمساحة قبل البدء، وتنبيهٌ قبل تحميلٍ كبير على بيانات الجوّال. وأصعبها القراءة الأولى: شاشة التقدّم لدينا تحجب القارئ حتى يكتمل تثبيت الطبعة، فينتظر المستخدم الجديد قبل أن يرى آيةً واحدة. وبعضهم لا ينتظر. وهذه لم نحلّها.

ووضع النصّ هو ما يسدّ هذه الثغرة. لا يحتاج طبعة، فمن لا يريد الانتظار، أو يريد خطًّا أكبر ممّا تعطيه صفحةٌ مطبوعة، يجد ما يقرأ فيه من فوره.

## ابدأ من هنا

* [quran-image-generator](https://github.com/NedaaDevs/quran-image-generator) — في إخراج الصفحة وتصويرها.
* [لماذا تبدو تطبيقات المصحف على هذه الهيئة](/ar/docs/islamic-typography) — بسطُ القول في الحرف ورسمه، والسطر ونظمه.
* [github.com/NedaaDevs/nedaa](https://github.com/NedaaDevs/nedaa) — مصحفنا مفتوحُ المصدر، لمن أراد أن يرى كيف بُني ما وُصف.

---

آخر تحديث: ٢٠٢٦-٠٨-٢٥
