هذه ترجمة لمقال من Quran Blog. لا تُنشئ عملية الترجمة اقتباسات قرآنية أو أحكامًا شرعية.

عند تنزيل النص العربي للقرآن لاستخدامه في مشروع، ابدأ من صفحة الجهة التي توفّره، واحفظ مع الملف نوع النص وإصداره ومصدره وشروط استخدامه. احتفظ بنسخة أصلية دون تغيير قبل إجراء أي معالجة مسموح بها. تحقّق من مطابقة السور والآيات ومن نتيجة العرض، إلى جانب البيانات نفسها؛ فالخط الجميل وحده لا يثبت صحة النص الذي يعرضه.

احتفظ بسجل لمصادر المشروع

  1. التنزيل: سجّل رابط الجهة الموفّرة، ونوع النص، وإصداره، والشروط السارية بشأن نسبة المحتوى إلى مصدره أو إعادة توزيعه.
  2. الحفظ: احتفظ بالملف الأصلي دون تغيير، وميّزه عن أي نسخة عمل مشتقة يُسمح بإنشائها.
  3. التحقق: تحقّق من مطابقة الإحالات، وقارن نماذج من المقاطع المعروضة بالأصل، بما يشمل الحروف والعلامات الصغيرة.

ابدأ بالملف الأصلي من الجهة الموفّرة

دليل تحريري أصيل يستند إلى البحث. روجعت المصادر في 10 أكتوبر 2026. التمارين التطبيقية اقتراحات تحريرية؛ وتحدّد تعليمات الأدوات مصادرها لدى الجهات المقدّمة لها. الغلاف رسم توضيحي تحريري.

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

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

ابدأ من صفحة التنزيل التابعة للجهة الموفّرة

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

لا يكفي اسم ملف مثل quran.txt وحده لتوثيق مصدره. احفظ إلى جانب الملف رابط المصدر، وتاريخ التنزيل، ومعلومات الإصدار المتاحة. وإذا كان مستودع تابع لطرف ثالث يوزّع نسخة خضعت للتحويل، فافحص المصدر الأصلي والتحويل الموثّق معًا قبل أن تقرر مدى ملاءمتها لاستخدامك.

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

اقرأ شروط إعادة التوزيع الفعلية

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

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

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

احتفظ بنسخة أصلية قبل تحويل البيانات

احتفظ بالملف الذي نزّلته سليمًا في مجلد للمصادر يحمل اسمًا واضحًا. واعمل على نسخة منفصلة عند تحويل الملف إلى JSON، أو استيراده إلى قاعدة بيانات، أو إضافة حقول للفهرسة. احتفظ بسجل لعملية التحويل، حتى يمكن مقارنة الأصل بالناتج عند ظهور أي تساؤل.

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

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

تحقّق من مطابقة السور والآيات

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

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

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

تحقّق من نتيجة العرض، لا من ملف البيانات وحده

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

افحص المقطع في موضعه النهائي: صفحة الويب، أو المستند، أو معاينة الطباعة، أو شاشة التطبيق التي سيستخدمها القراء. قارنه بعرض القراءة في المصدر، واستعن بأهل الاختصاص المناسبين لفحص أي علامات مشكوك فيها. ففحص النص العادي ولقطة شاشة المتصفح يجيبان عن أسئلة مختلفة بشأن النتيجة.

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

سجل مصادر للمشروع

  • الجهة الموفّرة ورابط المصدر الدقيق.
  • اسم المورد، وطريقة تمثيل النص المختارة، والإصدار المتاح.
  • تاريخ التنزيل واسم الملف الأصلي الذي لم يُعدّل.
  • الإشعار أو الشروط السارية، محفوظة مع المورد.
  • خطوات التحويل والإحالات التي جرى التحقق منها في العرض النهائي.

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


تنزيل النص القرآني من مشروع تنزيل — جرى التحقق من خيارات النص وشروط إعادة توزيعه بالرجوع إلى توثيق مشروع تنزيل نفسه. هذا دليل للتعامل مع البيانات؛ ولا يمنح اعتمادًا لطبعة جديدة من القرآن.

قراءات ذات صلة

تابع القراءة مع كيف تنسخ النص العربي للقرآن دون فقدان علاماته أو الرسم العثماني مقابل الخط الهندي الباكستاني للمصحف: النص والخطوط والعرض.