সহায়:সাঁচ: বিভিন্ন সংশোধনসমূহৰ মাজৰ পাৰ্থক্য
Content deleted Content added
অ Bot: Migrating 1 langlinks, now provided by Wikidata on d:q4168710 |
অ Bot: Replace deprecated <source> tag and "enclose" parameter; কসমেটিক পরিবর্তন |
||
1 নং শাৰী:
{{Wiki markup}}
{{shortcut|HELP:T|Wikipedia:TEMPLATE}}
:''To find lists of commonly used templates, see [[
A '''template''' is a Wikipedia page created to be included in other pages. Templates usually contain repetitive material that might need to show up on any number of articles or pages. They are commonly used for [[
The most common method of inclusion is called [[
For a brief introduction to the subject, see ''[[
== General ==
Most templates are pages in the [[
Templates can contain any desired [[wp:wikitext|wikitext]], including calls to other templates. They have some limited programming capacities: customizable values (called [[#Parameters|parameters]]), calculation and branchings (using [[
'''How to do it:''' To transclude a template to an article or page, type <code><nowiki>{{template name}}</nowiki></code> in the wikitext at the place where the template is to appear. The prefix "Template:" need not be included, and an initial capital is not necessary.
Templates stored in other namespaces are transcluded in the same way, except that the namespace prefix, such as "User:", must be included. To transclude a page in [[
'''Note:''' Attempting to transclude a template that does not exist produces a [[wp:redlink|red link]], just like linking to any other nonexistent page. Following the link allows one to create that particular template. It is not possible to transclude pages between projects (such as different language Wikipedias) — to use a template on another language project, a copy of the template must be created in that project.
== Full syntax for transcluding and substituting ==
The basic transclusion syntax given above can be extended by the addition of [[parameter]]s, which are used to control the template's output. The syntax for this is
* <code><nowiki>{{template name|parameter|parameter|...}}</nowiki></code>
31 নং শাৰী:
The value of a parameter can be the empty string (pipe or equals sign followed immediately by the next pipe or the closing braces). This is different from leaving the parameter undefined (although templates are often coded so as to behave the same in both cases).
If a template is to be [[
Template names are exactly like other [[
Notice that the same double-brace syntax is used for many MediaWiki variables and parser functions (see [[
== Basic template usage examples ==
(If you wish to experiment with any of these, please use the [[
An example of a very simple template can be found at [[
To transclude the above template onto another page (e.g. in the [[
For example, type "<code>The 11th letter of the Greek alphabet is the lambda (<nowiki>{{lambda}}</nowiki>)</code>" and you will see "The 11th letter of the Greek alphabet is the lambda ({{lambda}})". You can use templates without knowing the details of their code — you only need to remember what result they produce (this is usually described on the template page).
Another way to use this template is to [[
=== Examples with parameters ===
{{anchor|Parameters}}
An example of a template that takes parameters is [[
{{for|the card game|Contract bridge}}
This usage takes two unnamed parameters, but the same template can also be used with different numbers of parameters to give slightly different results, as explained in the documentation on the template page. For example, <code><nowiki>{{For||Latins|Latin (disambiguation)}}</nowiki></code> produces
56 নং শাৰী:
Note in particular the usage with an empty parameter — here the consecutive pipes mean that the first parameter passed to the template is the empty string.
Other templates, particularly more complex ones, take named parameters (or a mixture of named and unnamed ones). A simple example is [[
:<code><nowiki>{{payoff matrix | UL = 5 | UR = 7 | DL = 2 | DR = 9 | Name = Example usage }}</nowiki></code>
{{payoff matrix | UL = 5 | UR = 7 | DL = 2 | DR = 9 | Name = Example usage }}
65 নং শাৰী:
The spaces around the equal signs and before and after the parameters are used only for clarity — they are not needed, and are ignored when the template is evaluated (although this is not the case with unnamed parameters). However parameter names are fully case sensitive — for example, it is not possible to replace "DR" by "dr" or "Dr" in the above example. Parameters with names that are not used by the template are simply ignored.
== Usage hints and workarounds ==
The following points may be worth noting when using templates:
* An unnamed parameter cannot contain an ordinary equals sign, as this would be interpreted as setting off a named parameter. (This does not apply if the equals sign comes within another template call or other item which the parser handles separately.) To pass an equals sign in an unnamed parameter (for example in a [[URL]] with key/value pairs), replace the equals sign with the special template {{tlx|{{=}}}}, which returns an equals sign that will not be specially interpreted. Another method is to replace the unnamed parameter (and any subsequent unnamed parameters) with named parameters — the first unnamed parameter is equivalent to a named parameter with the name "1", and so on. So to call template {{tl|done}} with the parameter "a=b", type either <code><nowiki>{{done|a{{=}}b}}</nowiki></code> or <code><nowiki>{{done|1=a=b}}</nowiki></code>.
71 নং শাৰী:
* Remember that whitespace characters (spaces, tabs, carriage returns and line feeds) are not automatically stripped from the start and end of unnamed parameters (as they are from named parameters). Including such characters (or any other non-visible characters in any parameters) may in some cases affect the template's behaviour in unexpected ways. (Template designers can use {{tl|StripWhitespace}} to remove unwanted whitespace in unnamed parameters.)
* In documentation and discussions it is often convenient to be able to produce the template call syntax, with a link to the template in question, but without actually calling the template. This can be done easily using the "{{tl|tl}}" template (the ''template link'' template). For example, using the text "<tt><nowiki>{{tl|tc}}</nowiki></tt>" produces "{{tl|tc}}". There is an extended version, {{tl|tlx}}, which also supports parameters.
* When a template is changed (when the template or one of its subtemplates is edited), the change will be reflected on all pages on which the template is transcluded. However the change may not become visible on all pages immediately — a previously cached version of a page, based on the previous version of the template, may continue to be displayed for some time. Use the [[
* When viewing old versions of pages, remember that templates will be transcluded as they are now, not necessarily as they were when the old page version was active.
* To list all pages onto which a template is transcluded, use [[
* To get a list of templates transcluded on a page, click "Edit", and find the list below the edit window. This list also includes the sub-templates used by the templates that are directly transcluded. To get such a list for a page section, an old version of the page, or your newly edited version prior to saving, click "Show preview" on the appropriate edit page. (For an old version, the subtemplate tree will be constructed according to the templates' current state.)
== Creating and editing templates ==
Templates are created and edited in much the same way as any other page: choose an appropriate name, navigate to that page, then click the Edit tab or create a new page as needed. As mentioned above, templates are normally placed in the [[
Before creating a template, do a quick search for existing templates (e.g. by exploring [[:Category:Wikipedia templates]]) to see if there's already a template that does what you want, or a similar template whose code can be copied and modified (or left in place and expanded). Look for generic templates on which the new template can be based (for example, [[
There is no hard rule about what name to choose for a template — make it short but reasonably descriptive. If similar templates exist, try to follow a consistent naming pattern. Templates can be renamed without breaking existing transclusions, provided a redirect to the new template name is left behind.
Be extremely careful when editing existing templates — changes made can affect a large number of pages, often in ways you might not expect. For this reason many high-use templates are [[
To propose the deletion of unused or inappropriate templates, or other changes in the way particular templates are used, go to [[
=== Handling parameters ===
The values of the parameters which can be fed to a template are represented in the template code by items enclosed between ''triple'' braces:
* the code <code><nowiki>{{{xxx}}}</nowiki></code> will be replaced by the value of the parameter named ''xxx''
98 নং শাৰী:
Because of the multiple uses of double-brace and triple-brace syntax, expressions can sometimes be ambiguous. It may be helpful or necessary to include spaces to resolve such ambiguity, for example by writing <code><nowiki>{{ {{{xxx}}} }}</nowiki></code> or <code><nowiki>{{{ {{xxx}} }}}</nowiki></code>, rather than typing five consecutive braces. However, watch out for unwanted whitespace appearing in template expansions.
=== System variables and conditional logic ===
Template code often makes use of the variables and parser functions described at [[
Some of the most often used variables and functions are listed hereafter. For more, see [[
{| class="wikitable" style="text-align:center;" width="80%"
139 নং শাৰী:
|{{#if: {{{param|}}} | Hooray...! | Darn...! }}
|-
| [[
|<nowiki>{{#expr: ( pi * 4 ^ 2 ) round 3 }}</nowiki>
|{{#expr: ( pi * 4 ^ 2 ) round 3 }}
|-
| [[
|<nowiki>{{#ifexpr: 1.23E+3 mod 2 | Odd | Even }}</nowiki>
|{{#ifexpr: 1.23E+3 mod 2 | Odd | Even }}
179 নং শাৰী:
The PAGENAME and NAMESPACE variables are particularly useful, and frequently used, to change template behavior based on context. For example, if the template transcludes a category link (e.g. cleanup templates, which transclude a link categorizing the page as a page which needs cleanup), it will often check the NAMESPACE variable to make sure that talk pages, user pages, or anywhere else the tag might incidentally be placed do not themselves get categorized as pages needing cleanup.
=== Nesting templates ===
Templates may contain other templates — this is usually called "nesting". As the template is processed, the wikitext produced by any nested templates is transcluded into the nesting template, so that the final product is essentially processed from the most deeply nested template out. While fairly straightforward in application, it involves some noteworthy quirks and tricks.
195 নং শাৰী:
When a nested template contains unmatched curled-brackets — as in {{tl|lb}} — the unmatched brackets are treated as text during processing, and do not affect the parsing of brackets in the nesting template. If the nested template is substituted, however, the substitution is processed first, and this ''will'' change how braces are parsed in the nesting template. This has little practical use, but can occasionally introduce unexpected errors.
See the [[
=== Noinclude, includeonly, and onlyinclude ===
By default, when a template is transcluded (or substituted), the entire wikitext (code) of the template page gets included in that of the target page. However it is possible to modify that behaviour, using tags that specify which parts of the template code are to be included. This makes it possible to avoid transcluding information intended for display only on the template page itself, such as the template's documentation, [[
* <code><nowiki><noinclude>...</noinclude></nowiki></code> — the text between the noinclude tags will not be included when the template is transcluded (substituted)
* <code><nowiki><includeonly>...</includeonly></nowiki></code> — the text between the includeonly tags will be transcluded (substituted), but will not be processed on the template's own page
207 নং শাৰী:
These tags can be nested inside each other, though (for a given page) this really only applies to the "onlyinclude" tag; nesting "includeonly" and "noinclude" tags is fairly pointless. Be careful not to split the tags, however. Constructions like this <tt><nowiki><onlyinclude>abc<includeonly>def</onlyinclude>ghi</includeonly></nowiki></tt> will not work as expected. Use the "first opened, last closed" rule that is standard for XML.
=== Problems and workarounds ===
* If the first included character of a template is one of the Wiki markup characters '''<tt>:;*#</tt>''', then it is processed as though it is at the beginning of a line (even when the template tag is not). This allows the creation of various kinds of lists in templates where the template may not always be in the correct place for a list. To avoid this effect use <tt><nowiki>#</nowiki></tt> or a numeric character reference ([[Numeric character reference|NCR]]) or HTML entity such as <tt>&#58;</tt> for a colon. This NCR is also useful in conjunction with definition [[
* For issues involving the substitution of templates (for example, how to control whether subtemplates are substituted as well when the parent template is substituted), see [[
* The template {{tl|StripWhitespace}} can be used to strip any initial or final whitespace from unnamed parameter values, if this would cause problems (named parameter values are automatically stripped in this way).
* For debugging templates the following techniques are sometimes helpful:
** using "subst:" — substituting a template (rather than transcluding it) can show more clearly what is happening when the template is transcluded.
** using "msgnw:" — this keyword (short for "message, nowiki") transcludes the wikitext of the template page, more or less, rather than the processed contents. it is not perfect: lists are rendered, comments are removed, and single newlines are replaced with spaces (which is particularly confounding when transcluding wikitext tables).
** using [[
* To protect server resources and avoid infinite loops, the parser imposes certain limits on the depth of nesting of transclusions and on the page size with expanded templates. This may cause pages to break when using very complex templates, particularly if there are multiple such templates on the same page. For more information, see [[
* Do not use <code>=</code> wikimarkup to create section headers within a template which is intended for use in article space — this will create an [edit] link that when transcluded will confusingly open the template for editing.
=== Documentation and categories ===
Categorizing your template and documenting its proper usage will make it easier for other editors to find and use. For detailed advice, see [[
Documentation for users, together with the template's categories and [[
In the case of complex templates, the documentation (together with categories and wikilinks) is often kept on a separate [[
Some templates contain category definitions in their transcluded code, i.e. they are intended to place the target pages in particular categories. This is often done with maintenance categories (placing articles into ordinary content categories in this way is discouraged). When doing this, it may be necessary to use "includeonly" tags to keep the template itself out of the category. The template should also be designed to suppress categorization in the case of demonstration uses — see [[
== Expand limits ==
When templates are rendered or expanded to HTML for viewing in your browser, they use memory. This is called the post-expand include size and has a limit of 2,048,000 bytes. This size is included as an invisible comment in the HTML output— use your browser's view source feature to show the raw HTML and search for ''newpp''. The report will look like:
<
<!--
NewPP limit report
237 নং শাৰী:
Expensive parser function count: 2/500
-->
</syntaxhighlight>
The example shows that template expansion is using 63k out of 2M of available memory.
If too many templates are included on a page, the post-expand include size may exceed the limit. When this happens, templates after the limit will no longer expand and will show as {{red|1=[[
== See also ==
{| class="wikitable"
257 নং শাৰী:
* Introductions:
** [[Transclusion]]
** [[
** [[mw:Help:Templates]]
* [[
* [[
* [[
* [[mw:Help:Magic words]]
* [[mw:Help:Extension:ParserFunctions]]
* [[m:Help:Parameter default]]<!-- m: -->
* [[
* [[
* [[
* [[
* [[
* [[
|
* [[mw:Manual:$wgEnableScaryTranscluding|Interwiki transclusion]]
278 নং শাৰী:
* [[mw:Manual:Parser.php]]
|
* [[
* [[
* [{{fullurl:Special:Allpages|namespace=10}} Special:Allpages (namespace 10)] all templates on this server
* [[
|
* Multilingual portal pages, see [[meta:www]]
* CSS and JS pages, see [[
* Pages in the MediaWiki namespace, see [[
* [[
* [[m:Spam blacklist]]
|}
== Notes ==
{{Reflist}}
|