Difference between revisions of "Template:Deprecated template/doc"

From blackwiki
Jump to navigation Jump to search
imported>Davidgothberg
(Updated the doc and clarified that this template itself is not deprecated.)
imported>SMcCandlish
(→‎Parameters: update)
 
(84 intermediate revisions by 34 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
+
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 +
{{tsh|Tdeprecated|TemplateObsolete|Deprecated}}
  
This is the {{tl|tdeprecated}} template.
+
The {{Tl|Deprecated template}} template notifies users that a given template has been replaced by a different one or ones, or simply [[Deprecation|deprecated]] (advised to no longer be used) without a replacement. This is useful when usage is different (so a redirect won't work) or you'd like to reduce the number of redirects (which makes bot parsing more difficult).
  
Note: This template itself is ''not'' deprecated. However using it with only one parameter is deprecated, it now takes 2-3 parameters instead. In the display above it gets no parameters, that's why it says: "This usage is deprecated."
+
Whenever possible, it should replace the deprecated template's content entirely, so that someone using the template will see only the message.
 +
 
 +
=== Usage ===
 +
 
 +
{{Tlx|Deprecated template|old template name|new template name|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
  
{{tl|deprecated template}} redirects here and can be used as an alternative name for this template.
 
  
This template notifies users that a given template has been replaced by a different one. This is useful when usage is different (so a redirect won't work) or you'd like to reduce the number of redirects (which makes bot parsing more difficult).
+
Usage without a second (replacement) template name simply produces:
  
Whenever possible, it should replace the deprecated template's content entirely, so that someone using the template will see the message.
+
{{Deprecated template|nocat=y}}
  
=== Usage ===
+
The template changes style depending on what kind of page it is shown on. Thus it adheres to the standardised looks for the different namespaces.
 +
 
 +
If a deprecated template is still [[Wikipedia:Transclusion|in use]] on other pages, add {{Tag|noinclude}} tags around the {{Tl|Deprecated template}} template. That way the template page will show the deprecation tag, but pages using it will not. If a template has been fully deprecated, meaning that it not [[Wikipedia:Transclusion|in use]] on other pages, the noinclude tags may be removed. That way a deprecation tag will show on any page using the deprecated template. Afterwards consider nominating the template for [[Wikipedia:Templates for discussion|deletion]], or marking it with {{Tl|Historical template}}.
 +
 
 +
=== Parameters ===
 +
 
 +
;Standard
 +
{{Tlx|Deprecated template|Old|New|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
 +
{{Deprecated template|Old|New|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
 +
 
 +
;Additional
 +
The template can show parameters as follows:
 +
 
 +
{{Tlx|Deprecated template|Old|New|parameter}}
 +
 
 +
{{Tlx|Deprecated template|Old|New|&lt;nowiki&gt;parameter{{=}}foo&lt;/nowiki&gt;}}
 +
{{Deprecated template|Old|New|parameter}}
 +
{{Deprecated template|Old|New|<nowiki>parameter=foo</nowiki>}}
 +
 
 +
 
 +
The template can also show a note:
 +
 
 +
{{Tlx|Deprecated template|Old|New|note{{=}}Further details can be inserted here}}
 +
{{Deprecated template|Old|New|note=Further details can be inserted here, such as why the template is retained, or the particulars of the replacement process}}
  
: <code><nowiki>{{tdeprecated|old template name|new template name}}</nowiki></code> (categorises to [[:Category:Deprecated templates|Deprecated templates]]).
+
The {{para|note}} parameter can also be given as {{para|reason}} or {{para|result}}.
  
: <code><nowiki>{{tdeprecated|old template name|new template name|date=</nowiki>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}<nowiki>}}</nowiki></code> (categorises to [[:Category:Templates deprecated since {{CURRENTMONTHNAME}} {{CURRENTYEAR}}|Templates deprecated since {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]]).
 
  
==== Normal usage ====
+
;Special parameters for templates outside template namespace.
  
Normal usage categorises templates to [[:Category:Deprecated templates|Deprecated templates]].
+
{{Para|old}} and {{Para|new}} can be used with the full names including namespace.
  
<pre>{{tdeprecated|old|new}}
+
{{Tlx|Deprecated template|old{{=}}Template:Old|new{{=}}Wikipedia:New}}
{{tdeprecated|old|new|parameter}}
+
{{Deprecated template|old=Template:Old|new=Wikipedia:New}}
{{tdeprecated|old|new|&lt;nowiki&gt;parameter|fuu&lt;/nowiki&gt;}}</pre>
 
{{tdeprecated|old|new|category=}}
 
{{tdeprecated|old|new|parameter|category=}}
 
{{tdeprecated|old|new|<nowiki>parameter|fuu</nowiki>|category=}}
 
  
==== With a date ====
+
To link to a category full of templates, use <code>:Category:{{var|Name of category here}}</code>, with a leading colon.
  
Adding the 'date' parameter subcategorises the template to [[:Category:Templates deprecated since {{CURRENTMONTHNAME}} {{CURRENTYEAR}}|Templates deprecated since {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]].
+
The {{para|new}} parameter cannot be used with the third unnamed parameter (the one illustrating a parameter of the third template). For example, this is not valid:<br />
 +
{{in5}}<code>{{!mxt|1=<nowiki>{{Deprecated template|Old|new=User:SnorkelWeasel/MyTemplate|&lt;nowiki&gt;chickens=yes&lt;/nowiki&gt;}}</nowiki>}}</code><br />
 +
Such a feature could be added, but it has never been needed yet.
  
<div style="{{quote style}} font-family:monospace;"><nowiki>{{tdeprecated|old|new|date=</nowiki>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}<nowiki>}}</nowiki></div>
+
;Category suppression
{{tdeprecated|old|new|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|category=}}
 
  
=== See also ===
+
The template can be prevented from categorizing by adding <code><nowiki>|nocat=true</nowiki></code>. This is only intended for examples, e.g. in the template's own documentation.  In that case, not only the page itself will not be categorized, but transclusions of such pages will also be prevented from categorizing in [[:Category:Pages using deprecated templates]]. Do not use this parameter to passive-aggressively contest a template's documentation. Take up the matter on the template's talk page or that of a relevant other venue, such as [[WP:Village pump (technical)]].
  
* {{Lts|Sdeprecated}}
+
== See also ==
* [[:Category:Deprecated templates]]
 
  
<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
+
* {{Tl|Deprecated template-inline}}&nbsp;– same as this template, but for deprecated [[WP:WPILT|inline templates]] that are being kept around (in name, at least) for historical reasons
[[Category:Template namespace templates|{{PAGENAME}}]]
+
* {{Tl|Deprecated stub}}&nbsp;– for deprecated stub templates
[[Category:Redirect templates|{{PAGENAME}}]]
+
* {{Tl|Historical template}} - for deprecated templates that are kept for historical reasons
 +
* [[:Category:Deprecated templates]]&nbsp;– the category where this template lists templates it is used on
 +
* {{Tl|Xtd}} (and [[Template:Xt/see also|related templates]])&nbsp;– for indicating deprecated (and good, bad and neutral) examples in guidelines, how-tos and template documentation
 +
* {{Tl|Dc}}&nbsp;– inline {{Dc|deprecated code or text}}; {{Tl|Dc2}} variant has {{Dc2|strikethrough}} (both explicitly use the {{Tag|del|open}} element, and can be used in articles, e.g. about HTML or other specifications that may have deprecated features)
 +
* {{tl|Superseded}} – for Wikipedia pages
 +
* {{tl|Obsolete}} – for media files
  
[[es:Plantilla:Plantilla en desuso]]
+
<includeonly>{{sandbox other||
[[it:Template:Template obsoleto]]
+
<!-- Categories below this line, please; interwikis at Wikidata -->
[[ka:თარგი:თმოძველდა]]
+
[[Category:Documentation header templates]]
[[ja:Template:移行中のテンプレート]]
+
[[Category:Deprecated templates| ]]
[[sq:Stampa:Stampa të vjetruar]]
+
}}</includeonly>
[[sl:Predloga:Todsvetovana]]
 
[[tr:Şablon:Geçersizş]]
 
</includeonly>
 

Latest revision as of 17:38, 26 October 2020

The {{Deprecated template}} template notifies users that a given template has been replaced by a different one or ones, or simply deprecated (advised to no longer be used) without a replacement. This is useful when usage is different (so a redirect won't work) or you'd like to reduce the number of redirects (which makes bot parsing more difficult).

Whenever possible, it should replace the deprecated template's content entirely, so that someone using the template will see only the message.

Usage

{{Deprecated template|old template name|new template name|date=December 2025}}


Usage without a second (replacement) template name simply produces:

The template changes style depending on what kind of page it is shown on. Thus it adheres to the standardised looks for the different namespaces.

If a deprecated template is still in use on other pages, add <noinclude>...</noinclude> tags around the {{Deprecated template}} template. That way the template page will show the deprecation tag, but pages using it will not. If a template has been fully deprecated, meaning that it not in use on other pages, the noinclude tags may be removed. That way a deprecation tag will show on any page using the deprecated template. Afterwards consider nominating the template for deletion, or marking it with {{Historical template}}.

Parameters

Standard

{{Deprecated template|Old|New|date=December 2025}}

Additional

The template can show parameters as follows:

{{Deprecated template|Old|New|parameter}}

{{Deprecated template|Old|New|<nowiki>parameter=foo</nowiki>}}


The template can also show a note:

{{Deprecated template|Old|New|note=Further details can be inserted here}}

The |note= parameter can also be given as |reason= or |result=.


Special parameters for templates outside template namespace.

|old= and |new= can be used with the full names including namespace.

{{Deprecated template|old=Template:Old|new=Wikipedia:New}}

To link to a category full of templates, use :Category:Name of category here, with a leading colon.

The |new= parameter cannot be used with the third unnamed parameter (the one illustrating a parameter of the third template). For example, this is not valid:
     {{Deprecated template|Old|new=User:SnorkelWeasel/MyTemplate|<nowiki>chickens=yes</nowiki>}}
Such a feature could be added, but it has never been needed yet.

Category suppression

The template can be prevented from categorizing by adding |nocat=true. This is only intended for examples, e.g. in the template's own documentation. In that case, not only the page itself will not be categorized, but transclusions of such pages will also be prevented from categorizing in Category:Pages using deprecated templates. Do not use this parameter to passive-aggressively contest a template's documentation. Take up the matter on the template's talk page or that of a relevant other venue, such as WP:Village pump (technical).

See also

  • {{Deprecated template-inline}} – same as this template, but for deprecated inline templates that are being kept around (in name, at least) for historical reasons
  • {{Deprecated stub}} – for deprecated stub templates
  • {{Historical template}} - for deprecated templates that are kept for historical reasons
  • Category:Deprecated templates – the category where this template lists templates it is used on
  • {{Xtd}} (and related templates) – for indicating deprecated (and good, bad and neutral) examples in guidelines, how-tos and template documentation
  • {{Dc}} – inline deprecated code or text; {{Dc2}} variant has strikethrough (both explicitly use the <del> element, and can be used in articles, e.g. about HTML or other specifications that may have deprecated features)
  • {{Superseded}} – for Wikipedia pages
  • {{Obsolete}} – for media files