ವಿಕಿಪೀಡಿಯ:Substitution ಇಗೆ ಮೂಲವನ್ನು ವಿಕ್ಷಿಸಿ

{{for|a technical description of substitution functions|Help:Substitution}}
{{subcat guideline|editing guideline|Template substitution|WP:TSUB|WP:SUBST}}
'''Substitution''' is the <u>one-time, permanent copying of any content on Wikipedia</u>. It differs from [[Wikipedia:Transclusion|transclusion]], which continually updates as the linked-to content changes.  

To substitute, add <code>subst:</code> after the opening braces, as in <code><nowiki>{{subst:page name}}</nowiki></code>. For example:  ''substitution'' <code><nowiki>{{subst:Medicine}}</nowiki></code> in contrast to ''transclusion'' <code><nowiki>{{Medicine}}</nowiki></code>. The contents of page "Medicine" will be expanded (for any templates) and stored at each point where "<nowiki>{{subst:Medicine}}</nowiki>" is placed in a page. Note how ref-tags refuse to run "subst:" unless temporarily renamed as "&lt;xref name=xx>" or similar.

This page also lists templates that should either always or never be substituted except in the Wikipedia namespace. Automated tools ([[Wikipedia:Bots|bots]]) that do such replacements will ''never'' be used on the original template. If you are going to use a bot to substitute templates, please read through [[Wikipedia talk:Substitution|the talk page]] first, as many are under dispute or change status over time, and substitution is permanent.

== About subst ==
=== Definition ===
The '''subst:''' keyword (short for "substitution") is used as a prefix inside [[Wikipedia:Template messages|template code]]. It changes the way the software expands the template. Ordinarily, a template will be expanded "on the fly"; that is, the template code on a page calls a separate page every time it is rendered. Although most page views are served from the cache, pages need to be rendered for previews, and rendered again when the page changes. When someone is editing a page with a normal template call, they see the template call. Placing "subst:" inside the curly brackets tells the software to ''permanently'' replace the template with the text of the template (i.e., the text that is on the template's article page ''when the template is added to the page''). Therefore <nowiki>{{template}}</nowiki> becomes <nowiki>{{subst:template}}</nowiki>, until you save the page. The next editor sees not the template call, but the text of the template when you saved; it does not change even if the template is edited.

=== Usage ===
You can subst a template tag by adding "subst:" to a template tag. For example, use <nowiki>{{</nowiki>subst:test5}} instead of <nowiki>{{</nowiki>test5}}. 

When this is a major component of an edit, it is strongly suggested that the template be mentioned in the [[Help:Edit summary|edit summary]] (for instance, put "<nowiki>{{subst:test}}</nowiki>", "subst:test"  or "test1 applied" in your edit summary) so other editors can easily see what you have done.

Additionally, when creating or editing templates that are commonly substituted, adding an HTML comment to the template page helps article editors to see how templates are being used (e.g. <code>&lt;!-- Substituted from [[Template:Documentation]] --></code>).

=== Benefits ===
* Templates are often modified or deleted.  If a template is [[Wikipedia:Glossary#Boilerplate text|boilerplate text]], consider whether you want it to vary as the template is modified.  If your answer is "no", substitution is warranted.  An example of this is the {{tl|welcome}} template.  The archives of a user's talk page should show the actual welcome message they received, not the current welcome message.
* If there is a template you would like to modify for a single occasion, but you do not want to modify the template for all the pages that use it, and you do not want to make a new template, you can substitute the template and then with a second edit, make the modifications.  For example: a template might be used with all the states of the United States and with the District of Columbia.  The template might be worded correctly for the states, but not for DC.  To fix the wording, you can substitute the template and then fix the wording.
* Substituting frequently used, but unprotected templates (of which there are few, such as {{tl|help me}}) limits the damage that can be caused by editing them. See [[Wikipedia:high-risk templates|high-risk templates]].
* Using certain templates hides wikitext from newcomers, which prevents them from learning how to use it.  (Of course, there is a "how to edit" link at the bottom of each edit page.)
* Substituting ''en masse'' '''may''' ultimately speed up the site, though the amount and significance of this is the subject of frequent debate.  Every time a page is rendered, the server must get text from a separate page for each template used; while each individual template has little effect, the vast number of templates used on Wikipedia is one factor affecting server load and article load times.  However, former [[m:Chief Technical Officer|Chief Technical Officer]] [[User:Brion VIBBER|Brion Vibber]] (who "maintain[s] overall responsibility for all technical functions of the Foundation, including both hardware and software") has <span class="plainlinks">[http://en.wikipedia.org/w/index.php?title=Wikipedia:Village_pump_%28technical%29&diff=36029520&oldid=36025274 said]</span>: {{" '}}Policy' should not really concern itself with server load except in the most extreme of cases; keeping things tuned to provide what the user base needs is our job."  (See [[Wikipedia:Don't worry about performance]].)
* Substitution allows for recursive evaluation through macro templates.

=== Drawbacks ===

* Once a template is substituted, the result is no longer linked to the template, making it hard to find all pages displaying that text (though categories can sometimes relieve this). The problem can easily be worked around by including a link to the template in the template's code or assigning it a [[Template:Z number doc|z number]], specifically for the purpose of tracking its usage.
* A substituted template will not be updated when the master template is updated.
* If the template is used to standardize the appearance of something, you probably do not want to do a substitution.  An example of this is a table of contents or navigation box.
* Substituting ''en masse''—editing thousands of articles with bots—temporarily slows down the site and wastes server resources unnecessarily.
* Substitution increases the size of articles in the database and database dumps.
* A substituted template can add a lot of wiki-code or HTML to the article, harming accessibility for the less technically inclined.
* Substituting templates prevents newcomers from learning to use templates, and prevents users from finding their documentation.
* If the template is just being used temporarily, it is usually better not to substitute.  Substituted templates are much harder to remove or modify. 
* When a vandalised template is substituted, it is more difficult to repair than regular vandalism because of the lack of links between the template and its incarnations and the lack of updatability.
* Some meta-templates, such as {{tn|!}} and {{tl|((}}, do not work if they are substituted.

==Templates that should always be substituted==
This is a list of templates that should always be substituted, organized by [[Wikipedia:Namespace|namespace]]. Each list is ordered alphabetically with grouped series. '''This is not a comprehensive list''', other less-used templates may also  need to be substituted, see the template's documentation for details.

===Article namespace===
* {{tl|No more links}}—substituting this inserts a commentary only visible in edit mode, with a short explanation to discourage spamming links
* {{tl|sub}}, {{tl|sup}} &ndash; but suggest these not subst:ed if used many times on one page, otherwise code likely to become cluttered.

===Article talk===
* {{tl|tmfrom}}, {{tl|tmto}}

===User talk namespace===
All of the templates listed in [[:ವರ್ಗ:User warning templates]] and [[:ವರ್ಗ:Welcome templates]], as well as the user talk page component of [[Template:Shoutbox sidebar]] (and its predecessor [[Template:Shoutbox]]), should be substituted.  This does not apply to templates on the user page.

===File namespace===
(none listed)

=== Misc. templates ===

* {{tl|archive top}}, {{tl|archive bottom}}—similar boilerplate message as for the deletion related messages, but for regular discussions instead.
* User signature templates, if transcluded, cause undue server strain as changes to a minor user template must then be widely propagated. If used, user signature templates should be substituted. (It should be noted, however, that [[WP:SIG#NT|user signature templates are discouraged]].)

===Uncategorised suggestions===
<!-- * ''There are currently no uncategorised suggestions.'' -->

==Templates that ''must'' be substituted==
These templates have a purpose and/or syntax that require them to be substituted.
* {{tl|afd}}—or else the link to "this article's entry" does not work.
* {{tl|cfd}}, {{tl|cfr}}, {{tl|cfm}}, which insert comments which serve as queues for {{ul|Cydebot}}, which is used to rename or merge categories.
* {{tl|copyvio}}—For articles to be listed at [[WP:Copyright problems|copyright problems]], will result in an error message if transcluded.
* {{tl|nld}}—For images with no info on copyright status, adds {{tl|no license}} with today's date automatically filled in.
* {{tl|nrd}}—For images with no [[Help:Image description page#Fair use rationale|fair use rationale]], adds {{tl|no rationale}} with today's date automatically filled in.
* {{tl|nsd}}—For images with no source info, adds {{tl|no source}} with today's date automatically filled in.
* {{tl|orfud}}—For "generic" orphaned fair use images, adds {{tl|di-orphaned fair use}} with today's date automatically filled in.
* {{tl|or-fu-re}}—For fair use images that have been orphaned in favour of another image, adds {{tl|di-orphaned fair use}} with today's date automatically filled in (takes the name of the replacement image as parameter).
* {{tl|proposed deletion}}—Proposed deletion, adds {{tl|proposed deletion/dated}} with today's date automatically filled in.
* {{tl|rfd}}-Redirects for Deletion
* {{tl|rfu}}—For fair use images that it should be possible to replace with a free licensed image, adds {{tl|replaceable fair use}}, with today's date automatically filled in.
* {{tl|refu-c}}—Used in captions of images flagged as replaceable fair use, adds {{tl|rfu-c}} with the "due date" (today + 7 days) automatically calculated and filled in.
* {{tl|OnProd}}—which inserts today's-date-dependent name of the category page to which the article was added when nominated for deletion.

==Templates that should ''not'' be substituted==
Technically, templates shall not be substituted that
:(a) contain calls to [[mw:Help:Extension:ParserFunctions|ParserFunctions]] (#if, #switch, etc.), unless, where possible, these are substituted too (see [[mw:Manual:Substitution#Multilevel substitution]])
:(b) template calls that do leave some parameters to their [[m:Help:Parameter default|defaults]] by not specifying them, unless the [[m:Help:Parameter default#Alternative default mechanism|alternative default mechanism]] is used<br/>
:because those constructs are not replaced in the generated wiki-code <nowiki>(Single level substing of case (a) leaves the #if or #switch constructs verbatim at the subst location and (b) leaves constructs like "{{{1|default value}}}")</nowiki>.<br />
:If specific [[WP:CON|consensus]] is to eliminate a particular call of such a template, [[Special:ExpandTemplates]] can be used to expand that call to plain wiki-syntax. 
:(c) templates that contain external links as the formatting of the URL to perform queries or look-ups  may change.

=== List ===
This is a list of templates that should not be substituted. This is because they contain formatting standard code, contain complex code, or contain code that breaks if substituted.

* {{tn|!}}—escapes a vertical bar for Wiki table syntax from the [[m:Help:Parameter_default|default parameter]] and [[m:ParserFunctions|ParserFunctions]] mechanisms.
* {{tl|citation needed}}—contains complex code. 
* Various citation/reference templates—which contain very complex conditional code (see: [[WP:CITET]]).
* {{tl|cleanup}}, {{tl|merge}}, {{tl|trivia}} and other [[Wikipedia:Cleanup resources|cleanup templates]]—bots rely on them, substitution makes a mess of the article text and breaks the [[:ವರ್ಗ:Cleanup by month|cleanup by month]] date categorization.
* {{tl|dmoz}}, {{tl|yahoo}}—URL queries external web directories.
* [[:ವರ್ಗ:Infobox templates|Infobox templates]]—various ones for the sake of bot-identification and consistency.
* {{tl|Javadoc:EE}}, {{tl|Javadoc:SE}}, {{tl|Javadoc:SE-guide}}—conditional templates whose purpose is to update the links when the master template is updated.
* {{tl|ISP}}, {{tl|Openproxy}}, {{tl|repeat vandal}}, {{tl|SharedIP}}, {{tl|SharedIPEDU}}, {{tl|s/wnote}}—not messages to the users (so it is no problem if they change from their original form), so no reason to subst, but the standard reasons not to subst apply.
* {{tl|ln}}, {{tl|lnt}}—complex code.
* {{tl|main}}—maintains formatting standard.
* {{tl|switch}}—also conditional templates; substituting breaks usage.
* {{tl|See also}}—standard formatting for see also list.
* {{tl|selfref}}—does not work when substed, as it is meant to contain different code in mirrors.
* {{tl|Signpost-subscription}}—must be updated weekly.
* {{tl|stub}} templates—various ones for simplified usage and removal.
* {{tl|talkarchive}}, {{tl|archive}}
* {{tl|tl}}, {{tl|tlp}}, {{tl|ttl}}, {{tl|ti}}, {{tl|tic}}, {{tl|tls}}, {{tl|cl}}, {{tl|ccl}}—Many '''very''' widely used ({{tl|tl}} with over 600,000 transclusions at last count). Quicker to type than their substitutions, and non-substing them allows new Wikipedians to learn about them and be able to use them.
* {{tl|Number of portals}} — Requires extremely frequent updating.
* {{tl|sockpuppet}} and similar templates intended to placed on the top level page in user space.  (Note: warnings and notices in the user talk space should be substituted)

===Wrong title templates===
These templates—used in the main-space—add a comment about why an article is misnamed. They may be removed as the Mediawiki titling facilities improve, and the wording/layout may change.

* {{tl|correct title}}
* {{tl|lowercase}}

===Chemical abbreviations===
''See [[:ವರ್ಗ:Chemical element symbol templates]].'' These are used to simplify the entry of chemical formulae.''
* {{tl|Actinium}}, {{tl|Aluminium}}, {{tl|Americium}}, {{tl|Antimony}}, {{tl|Argon}}, {{tl|Arsenic}}, {{tl|Astatine}}
* {{tl|Barium}}, {{tl|Berkelium}}, {{tl|Beryllium}}, {{tl|Bismuth}}, {{tl|Bohrium}}, {{tl|Boron}}, {{tl|Bromine}}
* {{tl|Cadmium}}, {{tl|Caesium}}, {{tl|Calcium}}, {{tl|Californium}}, {{tl|Carbon}}, {{tl|Cerium}}, {{tl|Chlorine}}, {{tl|Chromium}}, {{tl|Cobalt}}, {{tl|Copper}}, {{tl|Curium}}
* {{tl|Darmstadtium}}, {{tl|Dubnium}}, {{tl|Dysprosium}}
* {{tl|Einsteinium}}, {{tl|Erbium}}, {{tl|Europium}}
* {{tl|Fermium}}, {{tl|Flerovium}}, {{tl|Fluorine}}, {{tl|Francium}}
* {{tl|Gadolinium}}, {{tl|Gallium}}, {{tl|Germanium}}, {{tl|Gold}}
* {{tl|Hafnium}}, {{tl|Hassium}}, {{tl|Helium}}, {{tl|Holmium}}, {{tl|Hydrogen}}
* {{tl|Indium}}, {{tl|Iodine}}, {{tl|Iridium}}, {{tl|Iron}}
* {{tl|Lanthanum}}, {{tl|Lawrencium}}, {{tl|Lead}}, {{tl|Lithium}}, {{tl|Livermorium}}, {{tl|Lutetium}}
* {{tl|Magnesium}}, {{tl|Manganese}}, {{tl|Meitnerium}}, {{tl|Mendelevium}}, {{tl|Mercury}}, {{tl|Molybdenum}}
* {{tl|Neodymium}}, {{tl|Neon}}, {{tl|Neptunium}}, {{tl|Niobium}}, {{tl|Nitrogen}}, {{tl|Nobelium}}
* {{tl|Osmium}}, {{tl|Oxygen}}
*  {{tl|Palladium}}, {{tl|Phosphorus}}, {{tl|Platinum}}, {{tl|Plutonium}}, {{tl|Polonium}}, {{tl|Potassium}}, {{tl|Praseodymium}}, {{tl|Promethium}}, {{tl|Protactinium}}
* {{tl|Radium}}, {{tl|Radon}}, {{tl|Rhenium}}, {{tl|Rhodium}}, {{tl|Roentgenium}}, {{tl|Rubidium}}, {{tl|Ruthenium}}, {{tl|Rutherfordium}}
* {{tl|Samarium}}, {{tl|Scandium}}, {{tl|Seaborgium}}, {{tl|Selenium}}, {{tl|Silicon}}, {{tl|Silver}}, {{tl|Sodium}}, {{tl|Strontium}}, {{tl|Sulfur}}
* {{tl|Tantalum}}, {{tl|Technetium}}, {{tl|Tellurium}}, {{tl|Terbium}}, {{tl|Thallium}}, {{tl|Thorium}}, {{tl|Thulium}}, {{tl|Tin}}, {{tl|Titanium}}, {{tl|Tungsten}}
* {{tl|Ununbium}}, {{tl|Ununoctium}}, {{tl|Ununpentium}}, {{tl|Ununseptium}}, {{tl|Ununtrium}}, {{tl|Uranium}}
* {{tl|Vanadium}}
* {{tl|Xenon}}
* {{tl|Ytterbium}}, {{tl|Yttrium}}
* {{tl|Zinc}}, {{tl|Zirconium}}

=== Deletion-related ===
Most templates related to renaming or deleting pages are used temporarily, and thus do not need to be substituted (it just makes more work to delete them). 
* {{tl|catfd}}
* {{tl|ifd}} {{tl|ifd2}} {{tl|idw}} {{tl|idw-uo}} {{tl|idw-pui}} {{tl|idw-cp}}
* {{tl|cfdnotice}}
* {{tl|sfd-t}} {{tl|sfd-r}} {{tl|sfr-t}}
* {{tl|prod-2}}
* and all in [[:ವರ್ಗ:Speedy deletion templates]]
* {{tl|editprotected}} not deletion related, but also temporary
'''''Exceptions''''':
The following templates ''must'' be substituted in order to work correctly:
* {{tl|afd}} {{tl|afd2}} {{tl|afd3}}
* {{tl|cfd}} {{tl|cfm}} {{tl|cfr}} {{tl|cfr-speedy}} 
* {{tl|nld}} {{tl|nsd}}
* {{tl|prod}}
* {{tl|rfd}}
* {{tl|tfd2}} {{tl|tfdnotice}}
In addition, those templates which document a finished deletion process ({{tl|afd top}}, etc.) should be substituted.

==Under debate==
* {{tl|col-begin}} {{tl|col-2}} {{tl|col-3}} {{tl|col-4}} {{tl|col-end}}—alleged by some to simplify usage.
* {{tl|clear}}, {{tl|clearleft}} {{tl|clearright}}
* {{tl|ed}} {{tl|ed2}} {{tl|ed right}} {{tl|edit}}—simplify addition of edit link to templates
* Some have suggested that since user sig templates should be substed, {{tl|unsigned}}, {{tl|unsigned2}} should be substed for the same reasons.  However, the latter are all protected and will change much more infrequently than most signature templates; also, they are significantly longer.

== See also ==
{{Wikipedia glossary}}
* [[Help:Substitution]]
* [[meta:Help:Substitution]]
* [[Special:ExpandTemplates]] (put the template with the brackets {{ }} in the "input text" box).
* [[User:Pathoschild/Projects/Template substitution]] (bot-parseable lists, last updated 12 September 2006)
* [[:ವರ್ಗ:Wikipedia substituted templates]]
* {{tl|Subst only}} (placed on the <u>documentation subpages</u>, not the template pages, of templates that need to be substituted rather than transcluded)
* {{tl|Uw-subst}} (talkpage template that reminds users to subst)
* Substitution bots using this page
** [[User:Alphachimpbot|Alphachimpbot]]
** [[User:XyBot|XyBot]]
** [[User:MetsBot|MetsBot]]
** [[User:MartinBotIII|MartinBotIII]]
** [[User:Tawkerbot|Tawkerbot]]
** [[User:ZsinjBot|ZsinjBot]]
* Other substitution bots
** [[User:Addbot|Addbot]]
** [[User:Legobot|Legobot]]
** [[User:RBot|RBot]]
** [[User:ShepBot|ShepBot]]
** [[User:SpebiBot|SpebiBot]]
** [[User:DinoBot2|DinoBot2]]

[[ವರ್ಗ:Wikipedia templates|{{PAGENAME}}]]