وحدة:Unsubst/شرح

من موسوعة المزرعة
اذهب إلى التنقل اذهب إلى البحث

هذه صفحة توثيق لوحدة: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}}