وحدة:Unsubst/شرح

مراجعة ١٣:١٨، ٢٠ نوفمبر ٢٠٢١ بواسطة Anmar (نقاش | مساهمات) (مراجعة واحدة)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

هذه صفحة توثيق لوحدة:Unsubst

هذه الوحدة مساعدة لتسهيل استبدال القوالب، أو منع نسخها.

قوالب الصيانة، مثل {{بحاجة لمصدر}} أو {{مصادر أكثر}}، وغيرها من قوالب المعلومات، التي لا ينبغي أبدا أن تكون منسوخة. ولتجنب نسخها، نستخدم هذه الوحدة.

الاستخدام

لعرض نصوص ويكي WikiText عندما لا يجب نسخها، يجب أن تعطى باسم "$B".

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

بعض القوالب تحتوي على <noinclude> ولكن لا يوجد </noinclude> في نهاية القالب، وفي مثل هذه الحالة </noinclude> يجب أن تضاف الوسوم المفقودة قبل نهاية }} وإلا فهي ستظهر مع نتيجة نسخ القالب.

لتحويل قالب إلى نفس القالب، يستخدم نفس الوسائط، بمعنى آخر لمنع نسخ النص البرمجي له، استخدم: <syntaxhighlight lang="text"> النص البرمجي للقالب </syntaxhighlight>

متى لا تعمل هذه الوحدة؟

من الممكن أن يؤدي إضافة الوحدة إلى تعطيل بعض القوالب أو إخفاء ظهورها أو إخفاء ظهور جزء من القالب، وذلك في حالة كون القالب جدول ويكي أو يحتوي على نصوص الويكي الخاصة بالجداول، مثل:

{|
|-
|}

أو بعض منها منفردة:

  • {|
  • |}
  • |-

مثال

التاريخ: __DATE__

على سبيل المثال، لنفترض أن قالب:مثال يحتوي على التعليمات البرمجية التالية: <syntaxhighlight lang="text"> [ ... Template code goes here ... ] </syntaxhighlight>

النص البرمجي النتيجة
{{subst:مثال}} {{مثال|foo=bar|تاريخ=نوفمبر ٢٠٢٤}}
{{subst:مثال|تج=X}} {{مثال|تج=X|تاريخ=نوفمبر ٢٠٢٤}}
{{subst:مثال|baz=X}} {{مثال|foo=bar|baz=X|تاريخ=نوفمبر ٢٠٢٤}}
{{subst:مثال|تاريخ=يناير 2001}} {{مثال|foo=bar|تاريخ=يناير 2001}}