التضمين

This page is a translated version of the page Transclusion and the translation is 100% complete.

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

كيف يعمل التضمين

لتضمين أي صفحة مصدر (ضمن مشروع ميدياويكي واحد، مثل ويكيبيديا) ضمن صفحة هدف أخرى، قم بتضمين الكود التالي: {{SOMEPAGE}}

كلما عُرضت الصفحة الهدف A، يُعرض محتوى الصفحة المصدر B بالكامل (في هذه الحالة، SOMEPAGE)، في الموقع الذي وضغعت فيه علامة التضمين.

مثلاً، تقرر وضع رسالة ترحيب على صفحة نقاش كل وافد جديد. ينشئ التضمين رابطًا مباشرًا بين صفحة القالب والصفحة (الصفحات) المستهدفة التي ينبغي أن تظهر عليها الرسالة. عند تحرير القالب، تُحرَّر جميع الصفحات المستهدفة أيضًا.

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

ترميز التضمين والتركيب

إذا كان المصدر في نطاق القوالب ( مثل Template:Welcome)، عليك باستعمال نفس الاسم، بمفرده: {{Welcome}}

إذا كان المصدر في نطاق المقالة الرئيسية (مثل VisualEditor)، عليك إضافة نقطتين (:) أمام الاسم: {{:VisualEditor}}

إذا كان المصدر في أي نطاق آخرى (مثل User:Example)، عليك استخدام الاسم الكامل، شاملاً النطاق: {{User:Example}}

إذا كان المصدر هو الصفحة الفرعية للصفحة الهدف، (مثل Transclusion/ja)، فببساطة يمكنك تحديد اسم الصفحة الفرعية بغض النظر عن النطاق : {{/ja}}

التأثيل (أصل الكلمة)

ثيودور نيلسون هو من صاغ مصطلح التضمين (Transclusion)، مع مصطلح نص ترابطي (hypermedia)، في كتابه الصادر عام 1982 بعنوان Literary Machines.

التضمين الجزئي

باستخدام ترميزات ”noinclude“ و”onlyinclude“ و”includeonly“، يمكن نقل جزء من الصفحة بدلاً من كل الصفحة. يمكن أيضًا تحقيق هذه التحويلات الجزئية عن طريق التحويل من صفحات أخرى مثل الصفحات الفرعية. غالبًا ما يكون من المرغوب فيه عدم تضمين بعض المعلومات، مثل وثائق القوالب والتصنيفات.

أمثلة عن متى تستخدم التضمين الكامل بدلاً من التضمين الجزئي

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

ترميز التضمين الجزئي

noinclude - يعني الترميز ‎<noinclude>...‎</noinclude> أن النص الموجود بين العلامات يكون مرئيًا حصريًا على الصفحة المصدر ولا يمكن نقله إلى صفحة أخرى. This is useful for template documentation and categories.
includeonly - يعني الترميز ‎<includeonly>...‎</includeonly> أن النص الموجود بين العلامات سيكون مخفيًا في الصفحة المصدر ومرئيًا فقط عند نقله إلى صفحة أخرى. يمكن أن يكون هذا مفيدًا، مثلاً، لإضافة تصنيفات إلى الصفحات التي تتضمن قالبًا، دون إضافة القالب نفسه إلى هذه التصنيفات.
onlyinclude - يعني الترميز ‎<onlyinclude>...‎</onlyinclude> أن النص الموجود بين العلامات سيكون مرئيًا في الصفحة المصدر ومرئيًا عند نقله إلى صفحة أخرى. تعد هذه أكثر علامات التضمين الجزئي دقة من علامات التضمين الجزئي لأنها غالبًا ما تبطل العلامات الأخرى. إذا كان هناك زوج واحد على الأقل من العلامات onlyinclude في إحدى الصفحات، حينها عندما تُنقل هذه الصفحة، فالمواد الموجودة ضمن العلامات onlyinclude هي المنقولة فقط. يمكن أن يكون هناك العديد من هذه الأقسام onlyinclude في الصفحة. قد يكون هذا مفيدًا، مثلاً، لتكرار جزء صغير من صفحة واحدة في صفحة ثانية: فقط عليك إحاطة الجزء الصغير بعلامات 1$، ونقله إلى الصفحة الثانية.

‎<noinclude> و‎<includeonly> و‎<onlyinclude> و‎<onlyinclude> تتصرف بشكل مختلف داخل علامات ‎<nowiki>. تُمكِّن علامات nowiki من تجنب العلامات الخاصة، كما تفعل ذلك مع علامات ‎<noinclude> و‎<includeonly>. بيد أن علامات ‎<onlyinclude> داخل علامات ‎<nowiki> تنتج فقط المحتوى الموجود داخل علامة ‎<onlyinclude>.

الترميز	المخرجات عند التضمين
`<nowiki><noinclude> My content </noinclude></nowiki>`	`<noinclude> My content </noinclude>`
`<nowiki><includeonly> My content </includeonly></nowiki>`	`<includeonly> My content </includeonly>`
`<nowiki><onlyinclude>My content</onlyinclude></nowiki>`	My content

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

صفحات فرعية

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

مثال: تريد مناقشة حذف وإعادة توجيه الهرة إلى القطة. أولاً، قم بإنشاء صفحة فرعية نقاش:الهرة/لنحذف الهرة!، واكتب تعليقك فيها، ثم قم بتحويلها إلى نقاش:الهرة ونقاش:القطة باستخدام القالب {{نقاش: الهرة/لنحذف الهرة!}}. ستظهر التعليقات المنشورة في أي من صفحتي النقاش في كلتا الصفحتين.

صفحات خاصة

انظر أيضا: w:Wikipedia:Transclusion#Special pages وManual:$wgAllowSpecialInclusion

يمكن تحويل بعض الصفحات على Special:Specialpages، مثلاً:

العينة: {{Special:Newpages/3}} يعطي 3 صفحات جديدة.

يمكن إعطاء معلمات URL مثل معلمات القالب {{Special:RecentChanges|namespace=10|limit=5}}.

بدائل التضمين حسب القالب

في بعض الأحيان، قد ترغب في استخدام قالب، ولكن لسبب أو لآخر، قد لا ترغب في استخدام التضمين. يُطلق على عملية النسخ التلقائي لمرة واحدة لكود أو نص القالب إلى موقع وسم القالب اسم الاستبدال القالبي أو التضمين الاستبدالي (الاستبدال + التضمين). لتضمين كود/نص القالب استبداليًا، يتم تعديل وسم القالب من وسم التضمين القياسي إلى وسم استبدال، وذلك ببساطة بإضافة subst:، مما ينتج وسمًا بالشكل: {{subst:اسم القالب}}.

تضمين الأقسام الموسومة

يتيح امتداد إسمه تضمين الأقسام الموسومة إمكانية نقل المقاطع النصية المميزة.

سكريبتو

يمكنك نقل محتوى الصفحة، أو حتى أجزاء منها، باستخدام لوا Lua مع الامتداد Scribunto . انظر Module:Transcluder للحصول على مثال على هذا الويكي.

ميديا ويكي الدلالي

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

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

انظر استعلامات مضمنة لمزيد من المعلومات.

الصفحات المتعلقة بتضمين ميدياويكي

القوالب

انظر أيضا

طلب تضمين القالب من العموم (القوالب بين الويكيات، إلخ)
w:Wikipedia:Substitution (عكس التضمين)
إضافة: تضمين الأقسام الموسومة
w:ar:ويكيبيديا:تضمين