مودول:Unsubst/شرح

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

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

الاستخدام

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

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

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

لتحويل قالب إلى نفس القالب، يستخدم نفس الوسائط، بمعنى آخر لمنع نسخ النص البرمجي له، استخدم:

{{ {{{|safesubst:}}}#invoke:Unsubst||$B=

النص البرمجي للقالب 

}}

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

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

{|
|-
|}

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

• {|
• |}
• |-

مثال

التاريخ: __DATE__

على سبيل المثال، لنفترض أن موضيل:مثال يحتوي على التعليمات البرمجية التالية:

{{ {{{|safesubst:}}}#invoke:Unsubst||foo=bar |تاريخ=__DATE__ |$B=

 [ ... Template code goes here ... ]

}}

النص البرمجي	النتيجة
{{subst:مثال}}	{{مثال|foo=bar|تاريخ=دجنبر 2024}}
{{subst:مثال|تج=X}}	{{مثال|تج=X|تاريخ=دجنبر 2024}}
{{subst:مثال|baz=X}}	{{مثال|foo=bar|baz=X|تاريخ=دجنبر 2024}}
{{subst:مثال|تاريخ=يناير 2001}}	{{مثال|foo=bar|تاريخ=يناير 2001}}