عبد العزيز: بوت: تعريب V2.1

2023-09-13T12:27:22Z

صفحة جديدة

<includeonly>{{صغير|1=Note: This documentation for {{Tlx|Tlx}} is also [[أرابيكا:توثيق قالب]] by its derivatives {{Tlx|tlxb}}, {{Tlx|Tlxc}}, {{Tlx|Tlx}} (<span class="plainlinks">[{{fullurl:Tlx/doc |action=edit}} edit]</span>{{#ifeq:{{SITENAME}}|Meta |). |{{,}}[[M:template:{{PAGENAMEE}}|master page]]).}}}}</includeonly><noinclude>{{صفحة توثيق فرعية}}{{تحديد}}</noinclude>
{{#ifeq:{{BASEPAGENAME}}|Tlx |{{استخدام واسع|{{Tlx/شرح/عداد}}}}}} }}
This template is used to show example template usage without expanding the template itself.

== Basic use ==
''(Note: In the following examples, [[علامة حذف|ثلاث نقاط]] indicate where parameters have been omitted.)''

: {{tlx{{\sandbox}}|tlx|Template|''first parameter''|''second parameter''|''third''|...|''tenth''}} produces: {{tlx{{\sandbox}}|Template|''first parameter''|''second parameter''|''third''|...|''tenth''}}

Where parameters might contain one or more equals-signs ("="), replace each equals-sign with {{Tlf|{{=}}}}:
: {{tlx{{\sandbox}}|tlx|Template|''first''<nowiki>{{=}}</nowiki>''something''|''second''|''third''<nowiki>{{=}}</nowiki>''something''|...|tenth}} produces: {{tlx{{\sandbox}}|Template|''first{{=}}something''|''second''|''third{{=}}something''|...|''tenth''}}

For more than ten parameters, possibly also containing equals-signs, use {{وسم في النسق|nowiki}} thus:
: {{tlx{{\sandbox}}|tlx|Template|<nowiki><nowiki>''first''|''second''|''third=something''|...|''999th''</nowiki></nowiki>}} produces: {{tlx{{\sandbox}}|Template|<nowiki>first|second|third=something|...|999th</nowiki>}}

== Purpose and naming ==

[[Wikt:mnemonic|Mnemonically]], "['''t''']emplate ['''l''']ink e['''x''']panded" (after {{قا|قا}}, "['''t''']emplate ['''l''']ink").

This template allows an example of calling a template, accompanied by one or more parameters, to be displayed without also causing the template to be called.

Up to ten of the template's parameters (numbered or nowiki-keywords) may be displayed as placeholders, while more than over 10 parameters can be displayed using a coded vertical-bar (as in "{{صغير|&#124;}}..."). A keyword parameter can be used with equals code &#61; or <nowiki>{{=}}</nowiki> or in nowiki-text: "{{وسم في النسق|nowiki|content=size=10}}" or all parameters as a string in "{{وسم في النسق|nowiki|o}}" tags; see ''[[#Examples|Examples]]'' at bottom. For more details, see [[{{TALKPAGENAME}}|this talk]] page.

; Exceptions
If the intended template lists numerous parameters, then perhaps this template should really ''not'' be used, and just hardcode the usage with {{وسم في النسق|code|o}}{{وسم في النسق|nowiki|o}}. For example:
: {{وسم في النسق|code|content={{وسم في النسق|nowiki|content=<nowiki>{{Anytemplate|arg1=23|size=250px|</nowiki><var>other parameters...</var><nowiki>}}</nowiki>}}}}.
If a vertical display, with parameters on their own lines, is desired, this can also be laid out manually in this manner, or more rapidly done with {{وسم في النسق|pre}}.

=== المعلمات ===
* If the only parameter supplied is {{Param|1}}, i.e. a template's name, {{Tlf|tlx}}'s output is the same as {{قا|قا}} – i.e. a link within [[قوس (ترقيم)]] – but in a [[monospaced font]]:
** {{Tlc|tl|tl}} produces: {{قا|قا}}
** {{Tlc|tlx|tl}} produces: {{tlx{{\sandbox}}|tl}}
: {{Tlf|قا}} will also not take nor display additional parameters.

; Named parameters
{{وسيط|subst}}
: Setting this parameter to any non-blank value will prefix the string <code>subst:</code> linked to [[مساعدة:Substitution]]. This is useful to indicate when a template should be substituted. For example, {{tlx{{\sandbox}}|tlx|Welcome|3=subst=Y}} produces: {{tlx{{\sandbox}}|Welcome|subst=Y}}. This is similar to the action of the {{tlx{{\sandbox}}|tlxs}} template: {{tlx{{\sandbox}}|tlxs|Welcome}} produces: {{tlxs|Welcome}}.
{{وسيط|SISTER}}
: For an interwiki link to [[مساعدة:وصلات إنترويكي|other sister projects]], such as: {{وسيط|SISTER|M:}} ([[m:|Meta]]), {{وسيط|SISTER|Q:}} ([[q:|WikiQuote]]), {{وسيط|SISTER|S:}} ([[s:|WikiSource]]), etc, facilitating interwiki template documentation and/or discussion.
{{وسيط|LANG}}
: For a link to [[مساعدة:وصلات اللغات]], such as: {{وسيط|LANG|de:}} ([[:de:|ألمانيا]]), {{وسيط|LANG|sv:}} ([[:sv:|السويد]]), etc, facilitating cross-language template documentation and/or discussion.

== Documentation ==

{{قا|Tlx}} is a generalization of {{قا|قا|x}}, {{قا|قاو|x|y}} etc., with output that is arguably more legible. This depends on the browser, but narrow gaps between characters such as "{{Thinsp}}'''{'''{{Thinsp}}", "{{Thinsp}}'''|'''{{Thinsp}}", "{{Thinsp}}'''}'''{{Thinsp}}" and links can be hard to read when not monospaced (and hard to click on; for uses like <code><nowiki>{{!}}</nowiki></code>, see {{قا|Tn}}, which makes the click target bigger).

=== الاستخدام ===
:<code>{{tlx{{!}}Templatename}}</code>
:<code>{{tlx{{!}}Templatename{{!}}param}}</code>
:<code>{{tlx{{!}}Templatename{{!}}1{{!}}2{{!}}3{{!}}4{{!}}5{{!}}6{{!}}7{{!}}8{{!}}9{{!}}10}}</code>
:<code>{{tlx{{!}}Templatename{{!}}1{{!}}2{{!}}3{{!}}4{{!}}5{{!}}6{{!}}7{{!}}8{{!}}9{{!}}10&#124;more}}</code>
:<code>{{tlx{{!}}Templatename{{!}}param&#61;value}}</code>
There are up to 10 placeholders for parameters of the specified template.

=== أمثلة ===
{{#switch:{{SITENAME}} |Wikipedia|Meta= |
; Note: At the en.wikipedia and Meta sites, '''X0, X1, X2, ... X9 are sandbox templates''' for experimentation on involved templates that need be in template space. An auto-cleansing software facility exists that might be used to duplicate the facility on other sister projects.
}}

{{Aligned table|cols=3
|class=wikitable |style=border:1;cellpadding:4;
|row1style=background:whitesmoke;font-weight:bold;
| Code | Result | Remarks
| {{Tlx|tlx|x0}} | {{tlx{{\sandbox}}|x0}} |  
| {{Tlx|tlx|Abc}} | {{tlx{{\sandbox}}|Abc}} |  
| {{Tlx|tlx|ABC}} | {{tlx{{\sandbox}}|ABC}} |  
| {{Tlx|tlx|AbC}} | {{tlx{{\sandbox}}|AbC}} |  
| {{Tlx|tlx|x1|one}} | {{tlx{{\sandbox}}|x1|one}} |  
| {{Tlx|tlx|x2|one|two}} | {{tlx{{\sandbox}}|x2|one|two}} |  

| {{Tlx|tlx|x3|1|2|3|4|5|6|7|8|9|10}} | {{tlx{{\sandbox}}|x3|1|2|3|4|5|6|7|8|9|10}} |  
| {{Tlx|tlx|x4|1|2|3|4|5|6|7|8|9|10|11}} | {{tlx{{\sandbox}}|x4|1|2|3|4|5|6|7|8|9|10|11}} | up to 10 parameters...
| {{Tlx|tlx|x5|1|2|3|4|5|6|7|8|9|10&#124;11}} | {{tlx{{\sandbox}}|x5|1|2|3|4|5|6|7|8|9|10|11}} | {{محاذاة|right|...<code>&#124;</code> for more}}

| {{Tlx|tlx|x1|x=u}} | {{tlx{{\sandbox}}|x1|x=u}} | the straightforward equals-sign won't work...
| {{Tlx|tlx|x1|x&#61;u}} | {{tlx{{\sandbox}}|x1|x=u}} | {{محاذاة|right|...but <code>&#61;</code> is okay}}
| {{Tlx|tlx|x1|x<nowiki>{{=}}</nowiki>u}} | {{tlx{{\sandbox}}|x1|x{{=}}u}} | {{محاذاة|right|...and <code><nowiki>{{=}}</nowiki></code> is okay}}
| {{Tlx|tlx|x1|<nowiki>x=u</nowiki>}} | {{tlx{{\sandbox}}|x1|<nowiki>x=u</nowiki>}} | {{محاذاة|right|sticky nowiki also okay}}

| {{Tlx|tlx|x2| |two}} | {{tlx{{\sandbox}}|x2| |two}} | empty won't work...
| {{Tlx|tlx|x2|&#32;|two}} | {{tlx{{\sandbox}}|x2| |two}} | {{محاذاة|right|...but <code>&#32;</code> is okay}}
| {{Tlx|tlx|x2|&nbsp;|two}} | {{tlx{{\sandbox}}|x2| |two}} | {{محاذاة|right|...<code>&nbsp;</code> is also okay}}
| {{Tlx|tlx|x2|{{وسم في النسق|nowiki|s}}|two}} | {{tlx{{\sandbox}}|x2|<nowiki/>|two}} | {{محاذاة|right|{{وسم في النسق|nowiki|s}} handles the space}}
| {{Tlx|tlx|x2| &#124; two}} | {{tlx{{\sandbox}}|x2| | two}} | {{محاذاة|right|<code>&#124;</code> is okay}}
| {{Tlx|tlx|x2| {{!}} two}} | {{tlx{{\sandbox}}|x2 | {{!}} two}} | {{محاذاة|right|<nowiki>{{!}}</nowiki> is dubious}}

| {{Tlx|tlx|x2|<nowiki>2=</nowiki>|<nowiki>3=two</nowiki>}} | {{tlx{{\sandbox}}|x2|2=|3=two}} | empty really doesn't work

| {{Tlx|tlx|x2|<nowiki>2=one</nowiki>|two}} | {{tlx{{\sandbox}}|x2|two}} | "two" overrides "2{{=}}one"

| {{Tlx|tlx|x2|<nowiki>3=two</nowiki>|<nowiki>2=one</nowiki>}} | {{tlx{{\sandbox}}|x2|3=two|2=one}} | {{محاذاة|right|irregular parameter order is okay}}
}}
; Unlimited parameters as one {{وسم في النسق|nowiki}} string
: {{tlx{{\sandbox}}|tlx|convert|<nowiki><nowiki>14|m|ftin|abbr=out|sp=us</nowiki></nowiki>}}

== انظر أيضاً ==
* {{قا|tlxb}}, a version of {{Tlf|tlx}} where the template name is shown in bold.
*: {{قا|Tlb}}, a version of {{Tlf|قا}} where the template name is shown in bold.
* {{قا|temt}}, a version of {{Tlf|tlx}} that handles templates whose names include "Template:" and pages outside the Template: [[أرابيكا:نطاق]] that are treated as templates.
* {{قا|وسيط}}, for the presentation of template parameters and values (e.g. {{وسيط|paraname|val}}, {{وسيط|another}}).

== قوالب وصلة قالب ==
{{قوالب وصلة قالب}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|ملعب| |{{#ifeq:{{BASEPAGENAME}}|Tlx |
[[تصنيف:قوالب ارتباط القالب الداخلي]]
[[تصنيف:وصلات بين مشاريع ويكيميديا]]
[[تصنيف:قوالب مساعدة على الطباعة]]

}} }}</includeonly>

قالب:Tlx/شرح - تاريخ المراجعة

عبد العزيز: بوت: تعريب V2.1