قالب:رمز وصلة قالب/شرح

هذه الصفحة توثيق لقالب {{Tlc}} وأيضاً {{tld}} و{{tlf}} والتي تقوم بنفس العمل تقريبا.

الغرض والتسمية

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

تعمل هذه القوالب بشكل مشابه لقالب {{قا}} وقالب {{tlx}}، لكنها لا تضع وصلة للقالب في الكود عند كتابة التوثيق قد ترغب في تجنب الكثير من الروابط غير ضرورية لأنها تقلل من سهولة القراءة، لذلك ينصح باستخدام قالب {{قا}} أو {{tlx}} في أول ظهور لاسم القالب في التوثيق، ثم استخدم {{tlc}} أو {{tld}} أو {{tlf}}.

العملية الأساسية

هنا توضيح كيف تبدو هذه القوالب، الرمز إلى اليسار والفعل الفعلي إلى اليمين:

{{tlc|اسم القالب|الوسائط}} يساوي {{اسم القالب|الوسائط}}

{{tld|اسم القالب|الوسائط}} يساوي {{اسم القالب|الوسائط}}

{{tlf|اسم القالب|الوسائط}} يساوي {{اسم القالب|الوسائط}}

التوثيق

التفاصيل الوظيفية

مميزات قوالب {{tlc}} و{{tld}} و{{tlf}}:

• تظهر اسم القالب، ويمكن إظهار ثمان معلمات/وسائط بعده.
• كما أنها تظهر المعلمات فارغة. (انظر الأمثلة أدناه).
• أنها تمنع التفاف الخط في الناتج.

الاستخدام

{{Tlc|Template|first_parameter|second|third|...|eighth}} ينتج {{Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth}}

{{Tld|Template|first_parameter|second|third|...|tenth}} ينتج {{قا|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth}}

أمثلة

تجعل الجداول وسوم <code></code> شفافة، لهذا السبب "تلوين الرمز" غير موجود في هذه الأمثلة.

الكود	النتيجة	ملاحظة
{{tlc}}		يظهر بناء الجملة الخاص به.
{{tlc|name}}	{{name}}
{{tlc|name|one}}	{{name|one}}
{{tlc|name|one|two}}	{{name|one|two}}
{{tlc|name|a|b|c|d|e|f|g|h|i|j}}	{{name|a|b|c|d|e|f|g|h|i}}	يظهر ثمانية وسائط/معلمات، والبقية يتم تجاهلها.
{{tlc|name|three|four}}	{{name|three|four}}	يظهر أيضا المعلمات فارغة.
{{tlc|name|three}}	{{name|three}}	حتى يظهر المعلمات الفارغة التي تأتي في النهاية.
{{tlc|name|one=a|two=b}}	{{name}}	علامات يساوي مشكلة، ولكن هناك حل.
{{tlc|name|2=one=a|3=two=b}}	{{name|one=a|two=b}}	استخدم المعلمات المرقمة لإصلاحها، وتذكر أن تبدأ من 2 لأن "الاسم" هو الرقم 1.

إذا كان لديك علامات يساوي في معلمات القالب الخاص بك، فمن المحتمل أنه من الأسهل والأكثر وضوحًا ترميزه باستخدام <nowiki> الخ. هنا رموز لمحاكاة قالب {{tlf}} وقالب {{tld}} وقالب {{tlc}} على التوالي.

<nowiki>{{اسم|one=a|two=b}}</nowiki> يساوي {{اسم|one=a|two=b}}

<tt><nowiki>{{اسم|one=a|two=b}}</nowiki></tt> يساوي {{اسم|one=a|two=b}}

<code><nowiki>{{اسم|one=a|two=b}}</nowiki></code> يساوي {{اسم|one=a|two=b}}

المحددات

As documented at مساعدة:Template#Problems and workarounds, template arguments starting with one of the four MediaWiki magic characters : ; * or # are interpreted as if they were at the beginning of a line, and are formatted as HTML lists. To avoid this, references to {{*}} or {{#expr}} must have the first character escaped. You can either use <nowiki></nowiki> or an escape like #.

General-purpose formatting

Comparison of template-linking templates according to the styles of generated text and link produced

Text style ↓	{{tlg}} options to achieve text style	Link style
		Linked	Unlinked	Linked with subst	Unlinked with subst	Linked including braces	Linked with alternative text
{{tlg}} options to achieve link style	—	DEFAULT	nolink=yes	subst=yes	nolink=yes|subst=yes	braceinside=yes	alttext=Foo 2=Foo
normal	DEFAULT	{{tlg}} {{وصلة قالب}} {{قاو|1}} {{Template:tlu}}	{{وصلة قالب بوصلة موقوفة}} <template link>	{{نسخ:نقا}} {{نسخ:Template:tlsu}}	قالب:Tlsf <template link ‏>	{{tn}}	{{tla}}
code	code=yes	{{tl2}} {{tlx}} {{Template:tlxu}}	{{tlc}} <template link> {{tnull}}<template link>	{{نسخ:tlxs}}	{{نسخ:tlsc}} <template link>	—
monospace	plaincode=yes	—		{{subst:tltss}}	—
kbd	kbd=yes
bold	bold=yes	{{tlb}}	—
bold+code	bold=yes|code=yes	{{tlxb}}
italic+code	italic=yes|code=yes	{{tlxi}}

Other formatting templates

Templates producing specialised formatting effects for given templates, modules or parameters

Code example	Effect	Notes
{{Template journal|Hatnote|Some text|selfref: yes|category: no|lang: fr}}	{{Hatnote | Some text | selfref = yes | category = no | lang = fr }}	Supports colors, placeholder texts, named and unnamed parameters
<syntaxhighlight lang="wikitext"> {{ملاحظة علوية | Some text | selfref = yes | category = no | lang = fr }} </syntaxhighlight>	{{ملاحظة علوية | Some text | selfref = yes | category = no | lang = fr }}	Same as above
{{Tji|Hatnote|Some text|selfref: yes|category: no|lang: fr}}	{{Hatnote|Some text|selfref=yes|category=no|lang=fr}}	Supports colors, placeholder texts, named and unnamed parameters
<syntaxhighlight lang="wikitext" inline>{{ملاحظة علوية|Some text|selfref=yes|category=no|lang=fr}}</syntaxhighlight>	{{ملاحظة علوية|Some text|selfref=yes|category=no|lang=fr}}	Same as above
{{tl2|Hatnote|lang=fr}}	{{hatnote}}	Supports linking to sister projects (e.g., fr:Hatnote)
{{demo|<nowiki>{{ملاحظة علوية|lang=fr|Some text}}</nowiki>}}	{{hatnote|lang=fr|Some text}} Some text	Shows code and example
{{tln|ملاحظة علوية}}	قالب:ملاحظة علوية	Produces a normal link to the template
{{elc|Template:ملاحظة علوية}} {{elc|Template:Hatnote|Hatnote}}	[[Template:ملاحظة علوية]] [[Template:Hatnote|Hatnote]]	Formats wikilink, with optional piped link text and blended suffix
{{ml|Example|hello}}	{{#استدعاء:Example|hello}}	Counterpart to {{وصلة قالب}} for linking to Lua modules
{{mfl|Example|hello}}	قالب:Mfl	Similar to {{ml}}, but expects the function to be documented and creates a link to the corresponding section
{{mlx|Example|hello}}	{{#استدعاء:Example|hello}}	Counterpart to {{tlx}} for linking to Lua modules
{{ml-lua|Module:Example|hello}}	قالب:Ml-lua	Link to Lua modules and built-in libraries, showing Lua code.
{{para|title|<var>book title</var>}}	|title=book title	Formats template parameters for display, with or without values
{{sclx|LASTING}}	[[WP:LASTING]]	Takes a shortcut suffix in project namespace and displays it with brackets and the WP: alias in a <code></code> tag.
{{tag|ref}} {{xtag|templatedata}}	<ref></ref> <templatedata>	Formats [X]HTML tags; can add content, choose opening, closing, or self-closing
{{dtl|Ping project}}	{{d:Ping project}}	Wikidata counterpart to {{وصلة قالب}}
{{pf|if}} {{pf|if|{{{1}}}|true|false}}	قالب:Pf قالب:Pf	Parser function equivalent to {{وصلة قالب}}
{{magic word|uc:}}	{{uc:}}	Magic word links

With utility links

Templates producing utility links for a given template (Hatnote used here as example)

Code example	Effect
{{lt|ملاحظة علوية}}	قالب:ملاحظة علوية (عدل | نقاش | تاريخ | وصلات | راقب | سجل)
{{lts|ملاحظة علوية}}	قالب:ملاحظة علوية(تحرير نقاش ارتباطات تاريخ)
{{t links|ملاحظة علوية}}	ملاحظة علوية (عدل نقاش تاريخ وصلات # /صفحات فرعية /شرح /شرح عدل /ملعب /ملعب فرق /مختبر)
{{tfd links|ملاحظة علوية}}	Template:ملاحظة علوية (نقاش · تاريخ · تحويلات · سجلات · صفحات فرعية)
{{tetl|ملاحظة علوية}}	{{ ملاحظة علوية }} ارتباطات نقاش عرض
{{tsetl|ملاحظة علوية}}	{{نسخ:ملاحظة علوية}}  وصلات نقاش عدّل
{{ti|ملاحظة علوية}}	قالب:ملاحظة علوية (نقاش, روابط, تحرير)
{{tic|ملاحظة علوية}}	قالب:ملاحظة علوية (نقاش وصلات تعديل)
{{tim|ملاحظة علوية}}	قالب:ملاحظة علوية ( نقاش، ماذا يصل هنا، عدل)
{{tiw|ملاحظة علوية}}	قالب:ملاحظة علوية (نقاش، ماذا يصل هنا، تعديل)
{{tlt|ملاحظة علوية}}	{{ملاحظة علوية}} (نقاش)
{{ttl|ملاحظة علوية}}	{{ملاحظة علوية}} (t/l)
{{twlh|ملاحظة علوية}}	قالب:ملاحظة علوية (وصلات، نقاش)