معيار تسمية المفردات القرآنية

قواعد أسماء المفاهيم القرآنية وتهجئتها وتركيبها والتمييز بينها.

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

يسمي المعيار المفاهيم التي لا يمكن تعريفها دون الرجوع إلى القرآن أو المصحف. أما أسماء المستخدمين والاشتراكات والملفات وغيرها من المفاهيم العامة في التطبيق فتبقى خارج قاموسه. وتنطبق إرشادات التسمية البرمجية هنا عند استخدام مفرداته.

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

الفكرة الأساسية مستوحاة من مبدأ convention over configuration، أي أن الاصطلاح يغني عن الإعداد:

عندما يعرف المطور قواعد المعيار، يستطيع توقع أسماء المفاهيم والعلاقات والحقول وطريقة استخدامها دون الرجوع إلى التوثيق في كل مرة.

القواعد باختصار

كل قواعد المعيار في جدول واحد وبترتيبها. الملخص هو الجملة الأولى من القاعدة، واختر القاعدة لتقرأها كاملة مع أمثلتها.

رقم	القاعدة	باختصار
نحدد المفهوم قبل أن نسميهنحدد المفهوم أولًا ثم نختار اسمه.
اسم معتمد واحد لكل مفهوم
001	اسم برمجي واحد لكل مفهوم	بعد تحديد المفهوم، يُختار له اسم برمجي واحد وفق قواعد هذا المعيار ويُسجَّل في قاموس المصطلحات.
الترجمة والأسماء المركبة
002	نقل المصطلح المتخصص	يُحتفظ بالمصطلح العربي إذا كان يدل على مفهوم خاص بالقرآن أو علومه، ويُكتب بحروف لاتينية وفق قواعد التهجئة.
003	ترجمة المفهوم العام	يُستخدم الاسم التقني الإنجليزي المستقر للمفهوم العام، ولو ورد في تطبيق قرآني.
004	تكوين الاسم المركب	في الاسم المركب، يُنقل المصطلح الذي له أصل في القرآن أو علومه كاملًا بحروف لاتينية، وتُترجم الكلمات العامة المضافة إليه إلى الإنجليزية.
005	ترتيب الصفة المترجمة	تسبق الصفة المترجمة إلى الإنجليزية الاسم الذي تصفه.
006	ترتيب المضافات المترجمة	يأتي الاسم العام المضاف في نهاية التركيب الإنجليزي، ويُعكس ترتيب المضافات المترجمة المتتابعة.
007	المعنى الاصطلاحي داخل المركب	هذه القاعدة تطبيق للقاعدة 004، وليست استثناءً منها.
التهجئة البرمجية المعتمدةبعد اختيار المصطلح العربي، نحدد طريقة كتابته في الكود.
التهجئة: صيغة الاسم
008	صيغة الاسم البرمجي	تُكتب الصورة المعتمدة للاسم البرمجي بحروف لاتينية صغيرة، وتُفصل كلمات الاسم المركب بشرطة سفلية: `snake_case`.
التهجئة: الحروف والحركات
009	محارف التهجئة البرمجية	يُكتب الاسم البرمجي بمحارف `ASCII`، من دون علامات النقل العلمي أو علامة اقتباس لتمثيل الهمزة والعين.
010	أصل اشتقاق التهجئة	تُشتق تهجئة المصطلح العربي من اسمه المشكول وفق قواعد هذا المعيار.
011	ضبط الاسم العربي بالحركات	يُعتمد الاسم العربي بالحركات عند اشتقاق تهجئته، وتُكتب همزة الوصل ألفًا عليها حركتها، ولا تُفترض حركة غير مذكورة.
012	استعادة الاسم العربي	لا يُعتمد على الاسم البرمجي لاستعادة حروف الاسم العربي الأصلية.
013	مقابلات الحروف الصامتة	تُنقل الحروف الصامتة وفق المقابلات الموضحة في المثال.
014	الحركات القصيرة	تُمثَّل الحركات القصيرة بالفتحة `a` والكسرة `i` والضمة `u`.
015	صور الألف الطويلة	تُعامل الألف المقصورة والألف الخنجرية والمدة معاملة الألف الطويلة.
016	حروف اللين	تُكتب الواو الساكنة بعد الفتحة `aw`، والياء الساكنة بعدها `ay`.
017	الحرف المشدد	يُضاعف الحرف الذي يحمل شدة في التهجئة البرمجية.
018	التنوين وحركة الإعراب	تُحفظ حركة التنوين القصيرة وحدها، وتُسقط حركة الإعراب في آخر الكلمة.
التهجئة: التاء المربوطة
019	التاء المربوطة خارج الإضافة	تُكتب التاء المربوطة `h` في آخر الاسم أو قبل الصفة، إذا لم تكن الكلمة مضافة إلى ما بعدها.
020	التاء المربوطة في الإضافة	تُكتب التاء المربوطة `t` إذا كانت الكلمة مضافة إلى ما بعدها.
التهجئة: المد وأسماء الحروف
021	حروف المد	تُكتب حروف المد بحرف لاتيني واحد: `a` أو `i` أو `u`.
022	ياء النسب	تُكتب ياء النسب المشددة في نهاية الاسم `i` واحدة.
023	تهجئات أسماء الحروف	تُستخدم تهجئات أسماء الحروف المسجلة في جدول أسماء الحروف، سواء ورد اسم الحرف وحده أو داخل مركب.
024	التهجئة الشائعة والصورة المشتقة	إذا خالفت التهجئة الشائعة الصورة المشتقة، تُستخدم الشائعة للعرض وللبحث، وتبقى الصورة المشتقة اسمًا برمجيًا.
التهجئة: الهمزة والعين والاستثناءات
025	الهمزة والعين	يُحذف الحرف المقابل للهمزة والعين وعلاماتهما الخاصة، وتبقى حركتهما في وسط الكلمة.
026	الهمزة والعين بعد ساكن في آخر الكلمة	تُكرَّر الحركة السابقة إذا انتهت الكلمة بهمزة أو عين يسبقهما حرف ساكن.
027	استثناء التهجئة المستقرة	عند وجود استثناء موثق للمصطلح في جدول التهجئات المستقرة، تُستخدم التهجئة المستقرة المسجلة بدل الناتج المشتق.
028	اسم سورة آل عمران	يُكتب اسم سورة آل عمران `aal_imran` لتمييز آل عن أداة التعريف `al`.
029	السور المسماة بحروفها الأولى	تُستخدم الأسماء المسجلة لسور طه ويس وص وق، وهي السور المسماة بالحروف التي تفتتح بها.
التهجئة: التعريف والروابط
030	أداة التعريف والحروف الشمسية	عندما تبقى أداة التعريف داخل المركب، تُكتب `al` بصورة ثابتة، ولا تتغير بسبب الحروف الشمسية.
031	أداة التعريف في أول الاسم	تُحذف أداة التعريف الواقعة في أول الاسم البرمجي.
032	أداة التعريف في الصفة	تُحذف أداة التعريف من الصفة التي تتبع موصوفًا معرفًا.
033	أداة التعريف في المضاف إليه	تبقى `al` في المضاف إليه، وتُحدَّد علاقة الإضافة أو الوصف بين كل كلمتين متجاورتين.
034	أداة التعريف بعد ترجمة المضاف	يُستبعد المضاف المترجم عند تحديد بقاء أداة التعريف في بقية الاسم.
035	حروف الجر المتصلة	عندما يتصل بِ أو لِ بالاسم داخل المصطلح، يُفصل حرف الجر في جزء مستقل من الاسم البرمجي، وتبقى أداة التعريف في الاسم المجرور.
036	كلمات الربط	تُحذف مَعَ وكَوْن وبِحَيْثُ وجَوَازًا من الاسم البرمجي عندما تكون روابط بين أجزائه، ويبقى الاسم العربي كاملًا.
صور الاسم
037	ثبات الاسم البرمجي	يُستخدم الاسم البرمجي المعتمد كما هو، ولا يتغير لمجرد ظهور تهجئة أكثر شيوعًا.
038	اختيار اسم العرض	تُختار للعرض أمام القارئ التهجئة الإنجليزية الأكثر شيوعًا، ويُوثَّق دليل اختيارها في `names.display_evidence` قبل وسم المدخل بـ`adopted`.
039	الاسم العربي المشكول	يُحتفظ بالاسم العربي المشكول للمصطلح القرآني أو العلمي العربي، ويُستخدم للاشتقاق وللعرض العربي.
040	تسمية المصدر والاسم المعياري	يُميَّز الاسم المعياري عن الاسم أو وصف الشكل الذي ورد في المصدر، وتُنقل تسمية المصدر كما وردت مع نسبتها إليه.
041	تغيير الاسم العربي	لا يُغيَّر الاسم العربي المشكول إلا لسبب لغوي يوضح المفهوم، ولا يُغيَّر للوصول إلى اسم برمجي مرغوب.
042	تعريف الاسم العربي بأل	يُكتب الاسم العربي المفرد معرفًا بأل، وتُكتب قيمة التصنيف التي هي صفة دون أل.
043	اسم محرف يونيكود	يُنقل الاسم الرسمي لمحرف يونيكود كما هو، ولا يُستخدم اسمًا برمجيًا للمفهوم الذي يمثله المحرف.
044	التهجئات البديلة	تُميَّز التهجئات البديلة للاسم عن صور البحث التي تختلف فقط في حالة الحروف أو الفاصل.
العلاقة بين الأسماء
045	العلاقات بين الأسماء	يُميَّز الاسم المعتمد والتهجئة البديلة والمقابل الإنجليزي والاسم المتروك؛ فهذه علاقات مختلفة بين الأسماء.
الأسماء المتروكة
046	الاسم المتروك	يُميَّز الاسم الصحيح الذي توقفت التوصية به في المشاريع الجديدة عن التهجئة البديلة، ويُبيَّن أنه اسم متروك يعود إلى المفهوم نفسه.
047	الإحالة من الأسماء القديمة	إذا تغير اسم مفهوم أو دُمجت أسماء للمفهوم نفسه، تُحفظ الأسماء القديمة وإحالتها إلى الاسم الباقي مع تاريخ التغيير وسببه.
المفرد والجمع
048	المفرد والجمع	يُستخدم المفرد لعنصر واحد والجمع لمجموعة عناصر.
049	تكوين الجمع البرمجي	يُكوَّن الجمع البرمجي بإضافة `s` إلى الاسم البرمجي كاملًا، بما في ذلك الأسماء المركبة.
أسماء التصنيفات وقيمها
050	اسم التصنيف واللاحقة `_type`	يُسمَّى التصنيف بحسب ما يصنفه، وتقتصر اللاحقة `_type` على تصنيف نوع العلامة.
051	العلامة ودلالتها وحكم الوقف	يُستخدم `waqf_mark` للعلامة المرسومة، و`waqf_mark_type` لتصنيف ما تدل عليه علامات الوقف، و`waqf_ruling` لتصنيف حكم الوقف في الموضع.
052	تسمية قيم التصنيف وتعريفها	يُحدَّد لكل نوع أو قيمة تصنيف ذات معنى اسم برمجي وتعريف، ولا يُكتفى باسم التصنيف العام.
053	تمييز اسم قيمة التصنيف	يُضاف إلى اسم قيمة التصنيف اسم المفهوم الذي يميزها عند الحاجة، وتبقى الكلمات التي تفرقها عن القيم الأخرى.
054	تفرّد الاسم داخل التصنيف	يجوز تكرار اسم قيمة في تصنيفين مختلفين إذا كان التصنيف معلومًا، ويجب أن يتفرد الاسم داخل التصنيف نفسه.
055	أسماء أنظمة عد الآي	يُستخدم اسم المدرسة اسمًا برمجيًا لقيم أنظمة عد الآي، بدل اشتقاق الاسم العربي الكامل.
أسماء السور والأشخاص
056	أسماء الأشخاص	تُكتب أسماء المقرئين والرواة وغيرهم من الأشخاص المرتبطين بالمفردات القرآنية بالصيغة العلمية الإنجليزية بعد إزالة علامات النقل، مع شاهد على الصيغة.
057	اشتقاق أسماء السور	تُشتق أسماء السور من أسمائها العربية وفق قواعد التهجئة العامة.
058	اشتراك المفهوم والفرد في الاسم	يجوز أن يشترك مفهوم وفرد في الاسم إذا كان نوع الفرد معلومًا ولا يلتبس بالمفهوم؛ ويشير الاسم المجرد إلى المفهوم.
تمييز المفاهيم
059	تمييز المفاهيم المتقاربة	لا يُعد تشابه الأسماء أو الترجمات سببًا لتوحيد مفاهيم مختلفة، ولا يُنسب اسم مفهوم إلى مفهوم آخر.
060	اسم العلامة واسم مدلولها	يكون للعلامة المرسومة في المصحف اسم يميزها عن المفهوم الذي تدل عليه.
061	السجدة وعلامتها	يُستخدم `sajdah` لموضع سجدة التلاوة وللسجود عنده، ويُستخدم `sajdah_mark` للعلامة المرسومة.
062	اسم العلامة بحسب موضعها	يُحدَّد اسم العلامة القرآنية بحسب معناها في موضعها، ولا تكفي نقطة ترميزها وحدها لتحديد الاسم.
063	الكلمة ووحدات تحليلها	يُستخدم `word` للكلمة في النص، و`token` لوحدة التقطيع، وأسماء التحليل الصرفي لما يُستخرج من الكلمة؛ ولا تُستخدم هذه الأسماء مترادفات.
064	وحدات النص وتمثيله	يُختار اسم وحدة النص بحسب المقصود: الحرف اللغوي، أو المحرف، أو نقطة الترميز، أو الوحدة الكتابية، أو الشكل المرسوم.
065	القرآن والمصحف	يُستخدم `quran` للقرآن، و`mushaf` للمصحف الذي كُتب فيه؛ ولا يُستخدم أحد الاسمين بدل الآخر.
066	المحتوى والعرض	تُستخدم أسماء وحدات المحتوى لما يحمله النص، وأسماء العرض لما يتعلق بظهوره على الصفحة.
الأرقام والإحالات والتوقيت
067	المعرّف الداخلي	يُستخدم `id` لمعرّف داخلي لربط السجلات، ولا يُعرض للقارئ ولا تُبنى عليه إحالة خارجية.
068	الرقم المرجعي	يُستخدم `number` للرقم المعتمد للعنصر داخل مجاله، الذي يُعرض للقارئ ويُستشهد به.
069	الموضع في التسلسل	يُستخدم `position` لموضع عنصر داخل أب أو تسلسل، ولا يُعد إحالة ثابتة إذا تغيّر التسلسل.
070	الترتيب الدلالي	يُستخدم `order` للترتيب المقصود دلاليًا حين يختلف عن موضع العنصر في التسلسل.
071	الإحالة المركبة	يُستخدم `key` للإحالة المركبة المقروءة: `ayah_key` لرقم السورة والآية، و`word_key` لمفتاح الآية وموضع الكلمة.
072	نظام عد الآي في الإحالة	يرتبط معنى `ayah_key` و`word_key` بنظام عد الآي المستخدم؛ ويُعد `kufi` النظام المعتمد عند غياب البيان وفق قرار هذا المعيار.
073	تسمية التوقيت الصوتي	داخل تسجيل تلاوة معين، يُسمَّى المدى الصوتي باسم وحدة النص التي يقابلها: `ayah_timing` للآية و`word_timing` للكلمة، دون إدخال القارئ أو الرواية أو النمط في الاسم.
استخدام الأسماء في البرمجيات
	الأسماء الواضحة	استخدم الاسم الكامل المعروف، مثل `surah` و`ayah` و`word`، وتجنب اختصارات مثل `srh` و`ay` و`wrd`.
	أسماء العلاقات	سمِّ العلاقة باسم المفهوم المرتبط، واستخدم المفرد لعلاقة الواحد والجمع لعلاقة المتعدد: `ayah.surah` و`surah.ayahs` و`ayah.words`.
	أسماء العمليات	استخدم الفعل نفسه للعملية نفسها: `normalize` و`parse` و`tokenize` و`segment` و`transliterate` و`annotate` و`render` و`validate` و`compare` و`convert`.
	أسماء القيم المنطقية	اجعل اسم الحقل المنطقي سؤالًا إجابته نعم أو لا، مثل `has_sajdah` و`is_active`.
	المفردات نفسها في طبقات النظام	احتفظ بالمفردات المعتمدة في النماذج وقاعدة البيانات وواجهات `API`، مع تغيير حالة الأحرف بحسب الطبقة.
	الأسماء التي يملكها مصدر خارجي	انقل اسم الحزمة أو الملف أو العمود الخارجي كما كتبه صاحبه، لأن تغييره يقطع الإحالة.
	ربط التوقيت بالتسجيل	يحمل `ayah_timing` الحقول `recitation_id` و`ayah_key` و`start_ms` و`end_ms`، ويحمل `word_timing` مفتاح `word_key` بدل مفتاح الآية.

نحدد المفهوم قبل أن نسميه

نحدد المفهوم أولًا ثم نختار اسمه.

قبل اعتماد أي مصطلح يجب تحديد:

ما الذي يمثله؟
ما حدوده؟
ما الذي لا يشمله؟
هل يختلف عن مفهوم قريب منه؟
ما الغرض من تمثيله برمجيًا؟

ثم نختار الاسم الأنسب له وفق قواعد التسمية الآتية.

اسم معتمد واحد لكل مفهوم

تهجئات متعددة تشير إلى المفهوم نفسه. استخدم surah في الكود.

001. اسم برمجي واحد لكل مفهوم

بعد تحديد المفهوم، يُختار له اسم برمجي واحد وفق قواعد هذا المعيار ويُسجَّل في قاموس المصطلحات. وتُستخدم مفرداته نفسها في المواضع التي تتبع المعيار قدر الإمكان.

أمثلة

المفهوم	الاسم المعتمد	أسماء لا تحل محله
السورة	`surah`	`chapter`، `quran_section`

الترجمة والأسماء المركبة

002. نقل المصطلح المتخصص

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

أمثلة

الاسم العربي	الصيغة البرمجية
سورة	`surah`
آية	`ayah`
تجويد	`tajwid`

003. ترجمة المفهوم العام

يُستخدم الاسم التقني الإنجليزي المستقر للمفهوم العام، ولو ورد في تطبيق قرآني. وجود اسم عربي للكلمة لا يجعلها مصطلحًا قرآنيًا متخصصًا؛ وإذا لم يتضح المقابل الإنجليزي، يُراجع تعريف المفهوم قبل اختيار الاسم.

أمثلة

الاسم العربي	الصيغة البرمجية
كلمة	`word`
صفحة	`page`
حرف	`letter`

004. تكوين الاسم المركب

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

أمثلة

الاسم العربي	الصيغة المعتمدة
الرَّسْم الإِمْلَائِيّ	`rasm_imlai`
النُّون السَّاكِنَة	`noon_sakinah`
الوَقْف اللَّازِم	`waqf_lazim`
المِيم الصَّغِيرَة	`small_meem`

صيغة «المِيم الصَّغِيرَة» هي small_meem، وليست meem_saghirah.

005. ترتيب الصفة المترجمة

تسبق الصفة المترجمة إلى الإنجليزية الاسم الذي تصفه.

أمثلة

الاسم العربي	الصيغة البرمجية
الأَلِف المَحْذُوفَة	`omitted_alif`

006. ترتيب المضافات المترجمة

يأتي الاسم العام المضاف في نهاية التركيب الإنجليزي، ويُعكس ترتيب المضافات المترجمة المتتابعة.

أمثلة

الاسم العربي	الصيغة البرمجية
عَلَامَة الوَقْف	`waqf_mark`
نَوْع عَلَامَة الوَقْف	`waqf_mark_type`

007. المعنى الاصطلاحي داخل المركب

هذه القاعدة تطبيق للقاعدة 004، وليست استثناءً منها. تتحدد طريقة كتابة الكلمة بحسب معناها الاصطلاحي في التركيب: تُترجم «إملائية» مع «علامة»، وتُنقل بحروفها مع «رسم». بقي رقمها مستقلًا لتسهيل الإحالة إلى هذا المثال.

أمثلة

الاسم العربي	الصيغة المعتمدة
العَلَامَة الإِمْلَائِيَّة	`orthographic_mark`
الرَّسْم الإِمْلَائِيّ	`rasm_imlai`

التهجئة البرمجية المعتمدة

بعد اختيار المصطلح العربي، نحدد طريقة كتابته في الكود. وتُسمّى هذه الصورة «التهجئة البرمجية المعتمدة» (Canonical Code Spelling). نشتقها من الاسم العربي المشكول وفق القواعد الآتية، حتى يصل المطورون إلى التهجئة نفسها بدل أن يختار كل مشروع تهجئة مختلفة.

الهدف تهجئة بسيطة وثابتة يمكن توقعها، وليست نقلًا علميًا دقيقًا للنطق. لذلك تُستخدم محارف ASCII من دون علامات النقل العلمي، وقد يشترك حرفان عربيان في مقابل لاتيني واحد، مثل س وص اللذين يُكتبان s. وتُحفظ العربية الأصلية مستقلة، إذ لا يمكن استعادتها من التهجئة البرمجية وحدها.

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

التهجئة: صيغة الاسم

008. صيغة الاسم البرمجي

تُكتب الصورة المعتمدة للاسم البرمجي بحروف لاتينية صغيرة، وتُفصل كلمات الاسم المركب بشرطة سفلية: snake_case.

أمثلة

الاسم العربي	الصيغة البرمجية
نظام عد الآي	`ayah_numbering_system`
الوقف اللازم	`waqf_lazim`

التهجئة: الحروف والحركات

009. محارف التهجئة البرمجية

يُكتب الاسم البرمجي بمحارف ASCII، من دون علامات النقل العلمي أو علامة اقتباس لتمثيل الهمزة والعين.

أمثلة

الصيغة البرمجية المعتمدة	صيغة لا تُستخدم برمجيًا
`qiraah`	`qirāʾah`
`irab`	`i'rab`

010. أصل اشتقاق التهجئة

تُشتق تهجئة المصطلح العربي من اسمه المشكول وفق قواعد هذا المعيار.

أمثلة

الاسم العربي	الصيغة البرمجية
سُورَة	`surah`

011. ضبط الاسم العربي بالحركات

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

أمثلة

الاسم العربي بالحركات	الصيغة المشتقة
اِسْتِعَاذَة	`istiadhah`

«استعاذة» بلا حركات لا تكفي لتحديد التهجئة. تكتب اِ بدل ٱ.

012. استعادة الاسم العربي

لا يُعتمد على الاسم البرمجي لاستعادة حروف الاسم العربي الأصلية.

أمثلة

الحرف العربي	المقابل اللاتيني
ص	`s`
س	`s`

تُحفظ العربية الأصلية مستقلة؛ لا يحدد s وحده أي الحرفين كان في الاسم.

013. مقابلات الحروف الصامتة

تُنقل الحروف الصامتة وفق المقابلات الموضحة في المثال.

أمثلة

الحرف العربي	المقابل اللاتيني
ب	`b`
ت	`t`
ث	`th`
ج	`j`
ح	`h`
خ	`kh`
د	`d`
ذ	`dh`
ر	`r`
ز	`z`
س	`s`
ش	`sh`
ص	`s`
ض	`d`
ط	`t`
ظ	`z`
غ	`gh`
ف	`f`
ق	`q`
ك	`k`
ل	`l`
م	`m`
ن	`n`
ه	`h`
و	`w`
ي	`y`
ة	`h`

014. الحركات القصيرة

تُمثَّل الحركات القصيرة بالفتحة a والكسرة i والضمة u.

أمثلة

الحركة	المقابل اللاتيني
الفتحة (َ)	`a`
الكسرة (ِ)	`i`
الضمة (ُ)	`u`

015. صور الألف الطويلة

تُعامل الألف المقصورة والألف الخنجرية والمدة معاملة الألف الطويلة.

أمثلة

الصورة العربية	المقابل اللاتيني
ا / ى / الألف الخنجرية / المدة	`a`

016. حروف اللين

تُكتب الواو الساكنة بعد الفتحة aw، والياء الساكنة بعدها ay.

أمثلة

الاسم العربي	الصيغة البرمجية
مَوْضِع	`mawdi`
أَوْلَى	`awla`
طَرَفَيْن	`tarafayn`

مثال mawdi يوضح نقل حروف «مَوْضِع» وحده، ولا يختار الاسم النهائي للمفهوم. عندما تعني الكلمة الموضع العام، تسجلها قائمة الكلمات العامة باسم place وفق القاعدة 003.

017. الحرف المشدد

يُضاعف الحرف الذي يحمل شدة في التهجئة البرمجية. وترد صيغة ياء النسب في القاعدة 022.

أمثلة

الاسم العربي	الصيغة البرمجية
شَدَّة	`shaddah`
مُقَطَّع	`muqatta`

018. التنوين وحركة الإعراب

تُحفظ حركة التنوين القصيرة وحدها، وتُسقط حركة الإعراب في آخر الكلمة.

أمثلة

الاسم العربي	الصيغة البرمجية
هُدًى	`huda`

التهجئة: التاء المربوطة

019. التاء المربوطة خارج الإضافة

تُكتب التاء المربوطة h في آخر الاسم أو قبل الصفة، إذا لم تكن الكلمة مضافة إلى ما بعدها.

أمثلة

الاسم العربي	الصيغة البرمجية
سُورَة	`surah`
القَلْقَلَة الصُّغْرَى	`qalqalah_sughra`

وجود كلمة بعد التاء المربوطة لا يكفي لتحويلها إلى t؛ فـ«الصغرى» صفة، لذلك نكتب qalqalah_sughra، لا qalqalat_sughra.

020. التاء المربوطة في الإضافة

تُكتب التاء المربوطة t إذا كانت الكلمة مضافة إلى ما بعدها.

أمثلة

الاسم العربي	الصيغة البرمجية
هَمْزَة الوَصْل	`hamzat_al_wasl`
سَجْدَة التِّلَاوَة	`sajdat_al_tilawah`

تُنطق التاء المربوطة تاءً في الإضافة، لذلك نكتب hamzat_al_wasl، لا hamzah_al_wasl.

التهجئة: المد وأسماء الحروف

021. حروف المد

تُكتب حروف المد بحرف لاتيني واحد: a أو i أو u. ولأسماء الحروف تهجئات معتمدة في القاعدة 023.

أمثلة

الاسم العربي	الصيغة البرمجية
تَجْوِيد	`tajwid`
تَفْسِير	`tafsir`
نُزُول	`nuzul`

لا نضاعف الحروف لتمثيل طول المد؛ فنكتب tajwid وnuzul، لا tajweed وnuzool. وقد تُستخدم الصور الأخرى للعرض أو البحث، كما توضح القاعدة 024.

022. ياء النسب

تُكتب ياء النسب المشددة في نهاية الاسم i واحدة.

أمثلة

الاسم العربي	الصيغة البرمجية
مَكِّيّ	`makki`
مَدَنِيّ	`madani`
عُثْمَانِيّ	`uthmani`

هذا حكم خاص بياء النسب في نهاية الاسم: نكتب makki، لا makkiyy ولا makkee. وتبقى الكاف المشددة kk وفق القاعدة 017.

023. تهجئات أسماء الحروف

تُستخدم تهجئات أسماء الحروف المسجلة في جدول أسماء الحروف، سواء ورد اسم الحرف وحده أو داخل مركب.

أمثلة

الاسم العربي	الصيغة البرمجية
نُون	`noon`
مِيم	`meem`
سِين	`seen`
جِيم	`jeem`
يَاء	`yaa`
صَاد	`saad`
المِيم الصَّغِيرَة	`small_meem`
سِين القِرَاءَة	`seen_al_qiraah`

أسماء الحروف استثناء من اختصار المد في القاعدة 021؛ فنكتب noon وmeem، لا nun وmim. ويخص الاستثناء اسم الحرف حتى داخل المركب، ولا يمتد إلى مصطلحات مثل tajwid.

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

الحرف	نقطة الترميز	الاسم المكتوب
ت	`U+062A`	`taa`
ط	`U+0637`	`taa`
ح	`U+062D`	`haa`
ه	`U+0647`	`haa`

024. التهجئة الشائعة والصورة المشتقة

إذا خالفت التهجئة الشائعة الصورة المشتقة، تُستخدم الشائعة للعرض وللبحث، وتبقى الصورة المشتقة اسمًا برمجيًا.

أمثلة

صورة الاسم	التهجئة
الاسم البرمجي	`tajwid`
اسم العرض	`Tajweed`
تهجئة بديلة للبحث	`tajweed`

في القاموس، يحمل الحقل code الصورة المشتقة tajwid، ويحمل display اسم العرض Tajweed، وتُسجَّل tajweed في alternative_spellings ليجدها البحث. بذلك تبقى التهجئة البرمجية قابلة للتوقع دون إهمال الاستعمال الشائع.

التهجئة: الهمزة والعين والاستثناءات

025. الهمزة والعين

يُحذف الحرف المقابل للهمزة والعين وعلاماتهما الخاصة، وتبقى حركتهما في وسط الكلمة.

أمثلة

الاسم العربي	الصيغة البرمجية
قِرَاءَة	`qiraah`
مُعَلِّم	`muallim`

نحذف العلامة التي تمثل الحرف، لا حركته؛ لذلك نكتب qiraah، لا qira'ah، وتبقى الفتحة في muallim. وعند الحاجة إلى نقل علمي دقيق، يُحفظ في الحقل names.transliteration للعرض أو المحتوى العلمي، دون تغيير الاسم البرمجي.

026. الهمزة والعين بعد ساكن في آخر الكلمة

تُكرَّر الحركة السابقة إذا انتهت الكلمة بهمزة أو عين يسبقهما حرف ساكن.

أمثلة

الاسم العربي	الصيغة البرمجية
رُبْع	`rubu`
جَمْع	`jama`
قَطْع	`qata`

تكرار الحركة يمنع اختزال نهاية الكلمة إلى صيغ مثل rub وjam، وهما كلمتان إنجليزيتان بمعنيين آخرين. أما إذا سبقت الهمزة أو العينَ حركةُ مد، فلا نضيف حركة أخرى؛ فنكتب رُكُوع ← ruku ومَمْنُوع ← mamnu، لأن التهجئة تنتهي بحركة أصلًا.

027. استثناء التهجئة المستقرة

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

أمثلة

الاسم العربي	التهجئة المستقرة المعتمدة	الناتج المشتق المستبدل
الجزء	`juz`	`juzu`

لا تكفي أفضلية التهجئة في الشيوع وحدها لإقرار الاستثناء؛ وإلا استُبدلت tajwid بـtajweed. المقصود استثناء مبرر لهذا المصطلح في نطاق القياس المعلن. وتُسجَّل الاستثناءات وقياساتها في جدول التهجئات المستقرة.

028. اسم سورة آل عمران

يُكتب اسم سورة آل عمران aal_imran لتمييز آل عن أداة التعريف al.

أمثلة

الاسم العربي	الصيغة البرمجية
آل عِمْرَان	`aal_imran`

029. السور المسماة بحروفها الأولى

تُستخدم الأسماء المسجلة لسور طه ويس وص وق، وهي السور المسماة بالحروف التي تفتتح بها.

أمثلة

الاسم العربي	الصيغة البرمجية
طه	`taha`
يس	`yasin`
ص	`saad`
ق	`qaaf`

التهجئة: التعريف والروابط

030. أداة التعريف والحروف الشمسية

عندما تبقى أداة التعريف داخل المركب، تُكتب al بصورة ثابتة، ولا تتغير بسبب الحروف الشمسية.

أمثلة

الاسم العربي	الاسم البرمجي	اسم العرض
أسباب النزول	`asbab_al_nuzul`	`Asbab al-Nuzul`

031. أداة التعريف في أول الاسم

تُحذف أداة التعريف الواقعة في أول الاسم البرمجي.

أمثلة

الاسم العربي	الصيغة البرمجية
الفَتْحَة	`fathah`
السُّكُون	`sukun`

032. أداة التعريف في الصفة

تُحذف أداة التعريف من الصفة التي تتبع موصوفًا معرفًا.

أمثلة

الاسم العربي	الصيغة البرمجية
الرَّسْم العُثْمَانِيّ	`rasm_uthmani`
الوَقْف اللَّازِم	`waqf_lazim`

033. أداة التعريف في المضاف إليه

تبقى al في المضاف إليه، وتُحدَّد علاقة الإضافة أو الوصف بين كل كلمتين متجاورتين.

أمثلة

الاسم العربي	الصيغة البرمجية
رُبْع الحِزْب	`rubu_al_hizb`
الوَقْف الجَائِز مُسْتَوِي الطَّرَفَيْن	`waqf_jaiz_mustawi_al_tarafayn`

034. أداة التعريف بعد ترجمة المضاف

يُستبعد المضاف المترجم عند تحديد بقاء أداة التعريف في بقية الاسم.

أمثلة

الاسم العربي	الصيغة المعتمدة	صيغة تخالف القاعدة
عَلَامَة الوَقْف اللَّازِم	`waqf_lazim_mark`	`al_waqf_lazim_mark`

035. حروف الجر المتصلة

عندما يتصل بِ أو لِ بالاسم داخل المصطلح، يُفصل حرف الجر في جزء مستقل من الاسم البرمجي، وتبقى أداة التعريف في الاسم المجرور.

أمثلة

الاسم العربي	الصيغة البرمجية
تَفْسِير بِالرَّأْي	`tafsir_bi_al_ray`
المَدّ العَارِض لِلسُّكُون	`madd_arid_li_al_sukun`

036. كلمات الربط

تُحذف مَعَ وكَوْن وبِحَيْثُ وجَوَازًا من الاسم البرمجي عندما تكون روابط بين أجزائه، ويبقى الاسم العربي كاملًا.

أمثلة

الاسم العربي	الصيغة البرمجية
الوَقْف الجَائِز مَعَ كَوْنِ الوَصْل أَوْلَى	`waqf_jaiz_wasl_awla`

صور الاسم

قد تكون للمفهوم نفسه صور مختلفة للاسم، لأن كل صورة تخدم استخدامًا مختلفًا: اسم ثابت للكود، واسم يقرؤه المستخدم، واسم عربي مشكول، وتسميات محفوظة من المصادر. اختلاف هذه الصور لا يعني اختلاف المفهوم.

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

037. ثبات الاسم البرمجي

يُستخدم الاسم البرمجي المعتمد كما هو، ولا يتغير لمجرد ظهور تهجئة أكثر شيوعًا.

أمثلة

الاستخدام	الاسم
الاسم البرمجي الثابت	`tajwid`
التهجئة الشائعة في العرض	`Tajweed`

يبقى tajwid اسمًا برمجيًا مع شيوع Tajweed في العرض.

038. اختيار اسم العرض

تُختار للعرض أمام القارئ التهجئة الإنجليزية الأكثر شيوعًا، ويُوثَّق دليل اختيارها في names.display_evidence قبل وسم المدخل بـadopted. أما المدخل الموسوم بـdraft فيجوز أن يحمل اسم عرض دون دليل مكتمل. اسم العرض هو الاسم المقروء في الواجهات والتوثيق، وقد يختلف عن الاسم البرمجي.

أمثلة

صورة الاسم	التهجئة
الاسم البرمجي	`tajwid`
اسم العرض	`Tajweed`

تُوثَّق المصادر وطريقة المقارنة والنتيجة وفق سياسة أدلة الاستعمال. وتعني «الأكثر شيوعًا» الأكثر بين المصادر المعلنة ذات الصلة، ولا تعني إثبات الشيوع في كل استعمال ممكن.

039. الاسم العربي المشكول

يُحتفظ بالاسم العربي المشكول للمصطلح القرآني أو العلمي العربي، ويُستخدم للاشتقاق وللعرض العربي.

أمثلة

الاسم العربي	الاسم البرمجي
الهَمْزَة	`hamzah`

040. تسمية المصدر والاسم المعياري

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

أمثلة

نوع التسمية	المثال
اسم من علم الضبط	المِيم — عَلَامَة الوَقْف اللَّازِم
وصف شكل من المصدر	رَأْس عَيْن
تصنيف المصدر	`imlaiyyah`
اسم المعيار	`orthographic_mark`

041. تغيير الاسم العربي

لا يُغيَّر الاسم العربي المشكول إلا لسبب لغوي يوضح المفهوم، ولا يُغيَّر للوصول إلى اسم برمجي مرغوب.

أمثلة

الحالة	الاسم العربي
الاسم الكامل في المثال	الوَقْف الجَائِز مَعَ كَوْنِ الوَصْل أَوْلَى
اختصار مقترح لمجرد تقصير الاسم البرمجي	الوَقْف الجَائِز

لا يُختصر الاسم العربي لقيمة الوقف لمجرد تقصير اسمها البرمجي. في هذا المثال، يحذف الاختصار بيان أن الوصل أولى.

الاختصار هنا مثال توضيحي مقترح لبيان ما يضيع من المعنى، وليس اسمًا منقولًا عن مصدر.

042. تعريف الاسم العربي بأل

يُكتب الاسم العربي المفرد معرفًا بأل، وتُكتب قيمة التصنيف التي هي صفة دون أل.

أمثلة

نوع الاسم	الصورة العربية
اسم مفرد معرف بأل	السُّورَة
اسم مفرد معرف بأل	التَّجْوِيد
قيمة تصنيف بصيغة الصفة	مَكِّيّ
قيمة تصنيف بصيغة الصفة	مُرَتَّل

043. اسم محرف يونيكود

يُنقل الاسم الرسمي لمحرف يونيكود كما هو، ولا يُستخدم اسمًا برمجيًا للمفهوم الذي يمثله المحرف.

أمثلة

نوع الاسم	الصيغة
اسم محرف يونيكود	`ARABIC LETTER HAMZA`
الاسم البرمجي للمفهوم	`hamzah`

044. التهجئات البديلة

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

أمثلة

الصورة المعتمدة	الصورة الأخرى	العلاقة
`hamzah`	`hamza`	تهجئة بديلة
`waqf_lazim`	`waqf-lazim`	صورة بحث بتغيير الفاصل؛ يجوز تسجيلها للإحالة

العلاقة بين الأسماء

045. العلاقات بين الأسماء

يُميَّز الاسم المعتمد والتهجئة البديلة والمقابل الإنجليزي والاسم المتروك؛ فهذه علاقات مختلفة بين الأسماء.

أمثلة

الاسم	علاقته بالاسم المعتمد
`ayah`	الاسم المعتمد
`aya`	تهجئة بديلة لـ`ayah`
`Verse`	مقابل إنجليزي لـ`ayah`
`alamat_mawdi_al_sajdah`	اسم متروك لـ`sajdah_mark`

الأسماء المتروكة

046. الاسم المتروك

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

أمثلة

الاسم المتروك	الاسم المعتمد للمفهوم نفسه
`alamat_mawdi_al_sajdah`	`sajdah_mark`

047. الإحالة من الأسماء القديمة

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

أمثلة

الاسم القديم	الاسم الذي يحيل إليه
`alamat_mawdi_al_sajdah`	`sajdah_mark`

يُبيَّن سبب الدمج مع هذه الإحالة.

المفرد والجمع

048. المفرد والجمع

يُستخدم المفرد لعنصر واحد والجمع لمجموعة عناصر.

أمثلة

المقصود	الصيغة
آية واحدة	`ayah`
مجموعة آيات	`ayahs`

049. تكوين الجمع البرمجي

يُكوَّن الجمع البرمجي بإضافة s إلى الاسم البرمجي كاملًا، بما في ذلك الأسماء المركبة.

أمثلة

ayahs
juzs
hizbs
mushafs

لا يُستخدم الجمع العربي مثل ayat وsuwar اسمًا برمجيًا للمجموعة؛ نكتب ayahs وsurahs. ويُحفظ الجمع العربي للمعلومة اللغوية في القاموس.

أسماء التصنيفات وقيمها

050. اسم التصنيف واللاحقة `_type`

يُسمَّى التصنيف بحسب ما يصنفه، وتقتصر اللاحقة _type على تصنيف نوع العلامة.

أمثلة

المقصود	الاسم المعتمد	اسم لا يُستخدم لهذا التصنيف
نوع علامة الوقف	`waqf_mark_type`	—
حكم الوقف	`waqf_ruling`	`waqf_type`
نمط التلاوة	`recitation_style`	`recitation_type`

051. العلامة ودلالتها وحكم الوقف

يُستخدم waqf_mark للعلامة المرسومة، وwaqf_mark_type لتصنيف ما تدل عليه علامات الوقف، وwaqf_ruling لتصنيف حكم الوقف في الموضع.

أمثلة

المقصود	أمثلة القيم
دلالة علامة	`waqf_lazim` أو `waqf_mamnu`
حكم الوقف في الموضع	`waqf_tamm` أو `waqf_kafi`

052. تسمية قيم التصنيف وتعريفها

يُحدَّد لكل نوع أو قيمة تصنيف ذات معنى اسم برمجي وتعريف، ولا يُكتفى باسم التصنيف العام.

أمثلة

التصنيف	أمثلة القيم
`recitation_style`	`murattal`، `mujawwad`، `muallim`
`recitation_pace`	`tahqiq`، `tadwir`، `hadr`
`revelation_classification`	`makki`، `madani`، `disputed`

053. تمييز اسم قيمة التصنيف

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

أمثلة

waqf_lazim
waqf_jaiz_wasl_awla

054. تفرّد الاسم داخل التصنيف

يجوز تكرار اسم قيمة في تصنيفين مختلفين إذا كان التصنيف معلومًا، ويجب أن يتفرد الاسم داخل التصنيف نفسه.

أمثلة

التصنيف	اسم القيمة
تصنيف النزول	`makki`
أنظمة عد الآي	`makki`

055. أسماء أنظمة عد الآي

يُستخدم اسم المدرسة اسمًا برمجيًا لقيم أنظمة عد الآي، بدل اشتقاق الاسم العربي الكامل.

أمثلة

kufi
basri
dimashqi
makki
madani_first
madani_last

أسماء السور والأشخاص

056. أسماء الأشخاص

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

أمثلة

hafs
warsh
qalun
ibn_dhakwan

057. اشتقاق أسماء السور

تُشتق أسماء السور من أسمائها العربية وفق قواعد التهجئة العامة.

أمثلة

fatihah
baqarah
nisa

058. اشتراك المفهوم والفرد في الاسم

يجوز أن يشترك مفهوم وفرد في الاسم إذا كان نوع الفرد معلومًا ولا يلتبس بالمفهوم؛ ويشير الاسم المجرد إلى المفهوم. ينطبق ذلك عند اشتراك اسم قارئ أو سورة مع اسم مفهوم قرآني.

أمثلة

المقصود	الاسم مع سياقه
علامة الهمزة	`hamzah`
المقرئ حمزة	`qiraah:hamzah`
درجة النقل	`tariq`
سورة الطارق	`surah:tariq`

تمييز المفاهيم

059. تمييز المفاهيم المتقاربة

لا يُعد تشابه الأسماء أو الترجمات سببًا لتوحيد مفاهيم مختلفة، ولا يُنسب اسم مفهوم إلى مفهوم آخر.

أمثلة

الاسم	المعنى
`word`	الكلمة في النص
`token`	وحدة ينتجها التقطيع

قد يتطابقان في مثال، لكن الاسمين لا يصبحان مترادفين.

060. اسم العلامة واسم مدلولها

يكون للعلامة المرسومة في المصحف اسم يميزها عن المفهوم الذي تدل عليه.

أمثلة

العلامة المرسومة	ما تدل عليه
علامة السكتة: `saktah_mark`	السكتة: `saktah`
علامة السجدة: `sajdah_mark`	السجدة وموضعها: `sajdah`
علامة الآية: `ayah_mark`	خاتمة الآية: `ayah_ending`

061. السجدة وعلامتها

يُستخدم sajdah لموضع سجدة التلاوة وللسجود عنده، ويُستخدم sajdah_mark للعلامة المرسومة.

أمثلة

المقصود	الاسم
الموضع والسجود عنده	`sajdah`
العلامة المرسومة	`sajdah_mark`

062. اسم العلامة بحسب موضعها

يُحدَّد اسم العلامة القرآنية بحسب معناها في موضعها، ولا تكفي نقطة ترميزها وحدها لتحديد الاسم.

أمثلة

نقطة الترميز	الاسم بحسب المعنى
`U+06DC`	`saktah_mark` أو `seen_al_qiraah` بحسب الموضع
`U+0652` و`U+06E1`	`sukun`

063. الكلمة ووحدات تحليلها

يُستخدم word للكلمة في النص، وtoken لوحدة التقطيع، وأسماء التحليل الصرفي لما يُستخرج من الكلمة؛ ولا تُستخدم هذه الأسماء مترادفات.

أمثلة

الاسم	المعنى
`word`	الكلمة التي يعرفها القارئ
`token`	وحدة ينتجها منهج تقطيع
`morpheme`	وحدة تحمل معنى أو وظيفة صرفية
`lemma`	الصيغة المعجمية
`root`	الجذر
`morphology`	التحليل الصرفي
`irab`	الإعراب

064. وحدات النص وتمثيله

يُختار اسم وحدة النص بحسب المقصود: الحرف اللغوي، أو المحرف، أو نقطة الترميز، أو الوحدة الكتابية، أو الشكل المرسوم.

أمثلة

الاسم	المعنى
`letter`	الحرف اللغوي
`character`	المحرف، وحدة نصية مجردة
`codepoint`	قيمة رقمية في نظام الترميز
`grapheme`	وحدة كتابية يدركها القارئ وحدة واحدة
`glyph`	الشكل الذي يرسمه الخط

065. القرآن والمصحف

يُستخدم quran للقرآن، وmushaf للمصحف الذي كُتب فيه؛ ولا يُستخدم أحد الاسمين بدل الآخر.

أمثلة

المقصود	الاسم
القرآن	`quran`
المصحف	`mushaf`

066. المحتوى والعرض

تُستخدم أسماء وحدات المحتوى لما يحمله النص، وأسماء العرض لما يتعلق بظهوره على الصفحة.

أمثلة

المجال	أمثلة الأسماء
المحتوى	`surah`، `ayah`، `word`
العرض	`page`، `line`، `layout`، `font`، `glyph`

الأرقام والإحالات والتوقيت

067. المعرّف الداخلي

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

أمثلة

الاسم	المعنى
`ayah_id`	معرف داخلي
`ayah_number`	رقم الآية داخل السورة

068. الرقم المرجعي

يُستخدم number للرقم المعتمد للعنصر داخل مجاله، الذي يُعرض للقارئ ويُستشهد به.

أمثلة

surah_number
ayah_number
page_number

069. الموضع في التسلسل

يُستخدم position لموضع عنصر داخل أب أو تسلسل، ولا يُعد إحالة ثابتة إذا تغيّر التسلسل.

أمثلة

word_position
token_position
line_position

070. الترتيب الدلالي

يُستخدم order للترتيب المقصود دلاليًا حين يختلف عن موضع العنصر في التسلسل.

أمثلة

revelation_order
display_order

071. الإحالة المركبة

يُستخدم key للإحالة المركبة المقروءة: ayah_key لرقم السورة والآية، وword_key لمفتاح الآية وموضع الكلمة.

أمثلة

ayah_key = surah_number:ayah_number
2:255

word_key = ayah_key:word_position
2:255:3

072. نظام عد الآي في الإحالة

يرتبط معنى ayah_key وword_key بنظام عد الآي المستخدم؛ ويُعد kufi النظام المعتمد عند غياب البيان وفق قرار هذا المعيار.

أمثلة

ayah_key: 2:255

تُفسَّر الإحالة ضمن نظام العد المصرح به؛ الافتراضي kufi. أما الفهرس المتتابع للآيات في المصحف كله فهو position، ويتبع نظام العد أيضًا. ولا يكفي نظام العد وحده لتثبيت word_key عند اختلاف النص أو طريقة تقسيمه؛ يجب بيان النص ومنهج التقسيم عند تبادل إحالات الكلمات.

073. تسمية التوقيت الصوتي

داخل تسجيل تلاوة معين، يُسمَّى المدى الصوتي باسم وحدة النص التي يقابلها: ayah_timing للآية وword_timing للكلمة، دون إدخال القارئ أو الرواية أو النمط في الاسم.

أمثلة

الاسم	المعنى
`ayah_timing`	مدى آية في تسجيل واحد
`word_timing`	مدى كلمة في تسجيل واحد

استخدام الأسماء في البرمجيات

هذه الإرشادات تكمل قواعد المصطلحات عند استخدامها في نموذج أو قاعدة بيانات أو واجهة برمجية.

الأسماء الواضحة

استخدم الاسم الكامل المعروف، مثل surah وayah وword، وتجنب اختصارات مثل srh وay وwrd. واختر الاسم الذي يوضح المقصود بدل data أو item عندما تعرف نوع البيانات.

أسماء العلاقات

سمِّ العلاقة باسم المفهوم المرتبط، واستخدم المفرد لعلاقة الواحد والجمع لعلاقة المتعدد: ayah.surah وsurah.ayahs وayah.words. إذا كان الحقل علاقة بيانات، يكفي الاسم ayahs؛ أما getAyahList() فيصف عملية لجلبها.

أسماء العمليات

استخدم الفعل نفسه للعملية نفسها: normalize وparse وtokenize وsegment وtransliterate وannotate وrender وvalidate وcompare وconvert. فاسم tokenizeText() يوضح العمل أكثر من processText()، وrenderAyah() أدق من handleAyah() عندما تكون العملية عرض الآية. هذه أسماء عمليات، ولا تحتاج إلى مداخل مستقلة في القاموس.

أسماء القيم المنطقية

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

المفردات نفسها في طبقات النظام

احتفظ بالمفردات المعتمدة في النماذج وقاعدة البيانات وواجهات API، مع تغيير حالة الأحرف بحسب الطبقة. مثلًا، يقابل النموذج Surah جدول surahs وحقل الربط surah_id؛ لا يتحول الاسم إلى chapter في طبقة أخرى. ويمكن للواجهة عرض ترجمة مناسبة للقارئ.

الصيغة	الاستخدام	المثال
`snake_case`	الجداول والأعمدة ومفاتيح `JSON` وقيم `enum` وأسماء الملفات	`ayah_numbering_system`
`PascalCase`	الأصناف والأنواع	`AyahNumberingSystem`
`camelCase`	الحقول والدوال حيث تفرضها اللغة	`ayahNumber`
`kebab-case`	مسارات `URL`	`/waqf-marks/waqf-lazim`

تغيير حالة الأحرف أو الفاصل لا ينشئ تهجئة لغوية مستقلة، ويجوز تسجيل صورته للبحث وفق القاعدة 044.

الأسماء التي يملكها مصدر خارجي

انقل اسم الحزمة أو الملف أو العمود الخارجي كما كتبه صاحبه، لأن تغييره يقطع الإحالة. مثلًا، يبقى row["aya_text_emlaey"] كما هو عند قراءة ملف الناشر. أما الحقل الذي تنشئه داخل مشروعك بعد القراءة فيتبع المعيار. ويمكن تعريف المدقق بهذه الأسماء في external_names داخل .terminology.json.

ربط التوقيت بالتسجيل

يحمل ayah_timing الحقول recitation_id وayah_key وstart_ms وend_ms، ويحمل word_timing مفتاح word_key بدل مفتاح الآية. ويحدد recitation_id التسجيل الذي تخصه الأزمنة؛ تُحفظ معلومات القارئ والرواية والنمط في التلاوة، ولا تُضاف إلى اسم المدى الصوتي.

معيار تسمية المفردات القرآنية

في هذه الصفحة