Community Central
Community Central
No edit summary
Tag: sourceedit
m (→‎Further help and feedback: Mass editing of links)
Tag: Help
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{tocright}}'''Template substitution''' is an alternate way to embed information contained in a [[Help:Templates|template]]. Substitution is performed by placing the code <code>subst:</code> between the template braces, before the template name, like this:
{{tocright}}
 
'''Template substitution''' is an alternate way to embed information contained in a [[Help:Templates|template]]. Substitution is performed by placing the code <code>subst:</code> between the template braces, before the template name, like this:
 
   
 
:'''<code><nowiki>{{subst:Templatename}}</nowiki></code>'''
 
:'''<code><nowiki>{{subst:Templatename}}</nowiki></code>'''
   
  +
== Process ==
==How does substituting work?==
 
 
Normally, when the code for a template named <code><nowiki>{{something}}</nowiki></code> is added to a page, it will still say <code><nowiki>{{something}}</nowiki></code> in the [[Help:Wikitext|wikitext]] when you next edit the page.
 
Normally, when the code for a template named <code><nowiki>{{something}}</nowiki></code> is added to a page, it will still say <code><nowiki>{{something}}</nowiki></code> in the [[Help:Wikitext|wikitext]] when you next edit the page.
   
Line 13: Line 12:
 
[[File:Subst template.png|thumb|500px|center|The same template after being substituted.]]
 
[[File:Subst template.png|thumb|500px|center|The same template after being substituted.]]
   
==Why would I use this?==
+
== Reasons for substituting ==
  +
Most templates should not be substituted in pages, as doing so will make their contents harder to edit once added to a page. However, there are some instances where it can be useful.
One reason is for things like welcome templates. Substituting these can be a good idea because welcome templates may change over time, and it can be odd to have someone's talk page change long after they have seen the notice. In addition, substituting it can give a better impression, as actual code can look more "human" than text saying <code><nowiki>{{welcome}}</nowiki></code>.
 
   
  +
In some cases, templates that exist solely to provide formatting or quick links should be substituted rather than included normally. For example, if a template exists to create the full format link to a game page, as a shorthand for editors to type, it is better to substitute the template. Adding templates for small uses such as links can unnecessarily add to the max template count of a page for a minor function that can be replicated in wikitext.
It can also be useful if the template is supposed to be edited manually after it has been placed.
 
  +
  +
In other cases, it may be that a template code is designed to be edited manually after it has been placed on a page. In these cases, substituting the template code, and immediately editing the page after, is ideal.
  +
  +
For talk page messages, preserving the code of the template used at the time is often best, as it can be odd to have someone's talk page change long after they have seen the notice. This includes [[Help:Welcome tool|welcome templates]], as well as [[Help:Signatures|signatures]].
  +
  +
Additionally, it is possible to use template substituting to remove a template from pages. Simply clear out the contents of the template on the template page, and substitute it on all pages that included it, to remove it and any of its content.
   
 
==See also==
 
==See also==
Line 24: Line 29:
 
==Further help and feedback==
 
==Further help and feedback==
 
{{Help and feedback section}}
 
{{Help and feedback section}}
 
 
[[ca:Ajuda:Substituint plantilles]]
 
[[ca:Ajuda:Substituint plantilles]]
 
[[de:Hilfe:Vorlagen/Wikitext/Substitution]]
 
[[de:Hilfe:Vorlagen/Wikitext/Substitution]]
Line 32: Line 36:
 
[[ja:ヘルプ:テンプレートの置換]]
 
[[ja:ヘルプ:テンプレートの置換]]
 
[[pl:Pomoc:Substytucja szablonów]]
 
[[pl:Pomoc:Substytucja szablonów]]
 
[[pt:Ajuda:Substituindo predefinições]]
  +
[[tr:Yardım:Şablonları yerine alma]]
  +
[[uk:Довідка:Вставка контенту з шаблонів]]
 
[[vi:Trợ giúp:Thay thế bản mẫu]]
 
[[vi:Trợ giúp:Thay thế bản mẫu]]
 
[[zh:Help:替換引用模板]]
 
[[zh:Help:替換引用模板]]
[[pt:Ajuda:Substituindo predefinições]]
 
 
 
[[Category:Editing]]
 
[[Category:Editing]]
 
[[Category:Source editing]]
 
[[Category:Source editing]]

Revision as of 07:08, 1 December 2019

Template substitution is an alternate way to embed information contained in a template. Substitution is performed by placing the code subst: between the template braces, before the template name, like this:

{{subst:Templatename}}

Process

Normally, when the code for a template named {{something}} is added to a page, it will still say {{something}} in the wikitext when you next edit the page.

Non subst template

A template in the editor that has not been substituted.

However, if you substitute a template, the text {{subst:something}} will be replaced with the full template code from Template:Something when you save the page. If you edit the page again, you will no longer see {{subst:something}} in the text:

Subst template

The same template after being substituted.

Reasons for substituting

Most templates should not be substituted in pages, as doing so will make their contents harder to edit once added to a page. However, there are some instances where it can be useful.

In some cases, templates that exist solely to provide formatting or quick links should be substituted rather than included normally. For example, if a template exists to create the full format link to a game page, as a shorthand for editors to type, it is better to substitute the template. Adding templates for small uses such as links can unnecessarily add to the max template count of a page for a minor function that can be replicated in wikitext.

In other cases, it may be that a template code is designed to be edited manually after it has been placed on a page. In these cases, substituting the template code, and immediately editing the page after, is ideal.

For talk page messages, preserving the code of the template used at the time is often best, as it can be odd to have someone's talk page change long after they have seen the notice. This includes welcome templates, as well as signatures.

Additionally, it is possible to use template substituting to remove a template from pages. Simply clear out the contents of the template on the template page, and substitute it on all pages that included it, to remove it and any of its content.

See also

Further help and feedback