View source for Template:Deprecated template/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
{{tsh|Tdeprecated|TemplateObsolete}}

The {{Tl|Deprecated template}} 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).

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}}}}

Usage without a date parameter categorizes templates to [[:Category:Deprecated templates]]. Adding the date parameter categorizes the template to [[:Category:Deprecated templates from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]].

This template changes style depending on what kind of page it is show 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 and is 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]].

=== 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|fuu&lt;/nowiki&gt;}}
{{Deprecated template|Old|New|parameter}}
{{Deprecated template|Old|New|<nowiki>parameter|fuu</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}}


The template can be stopped from categorizing by adding <code><nowiki>|nocat=true</nowiki></code>. 


;Special parameters for templates outside template namespace.

{{Para|old}} and {{Para|new}} can be used with the full names including namespace.

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


{{Para|4}} and {{Para|5}} can be used to indicate the namespaces of the  old and new template when they are not in template namespace. In that case {{Para|1}} and {{Para|2}} should be used with the name of the old and new template without namespace. 

{{Tlx|Deprecated template|1{{=}}Old|2{{=}}New|4{{=}}Template|5{{=}}Wikipedia}} gives the same result as in the example above using {{Para|old}} and {{Para|new}}:
{{Deprecated template|1=Old|2=New|4=Template|5=Wikipedia}}

== See also ==

* {{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
* {{Tl|Db-deprecated}}&nbsp;– for deprecated templates that have been slated for deletion
* {{Tl|Deprecated stub}}&nbsp;– for deprecated stub templates
* {{Tl|Sdeprecated}}&nbsp;– for deprecated shortcuts
* {{Tl|Obsolete template}}
* [[: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)

<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Template namespace templates]]
[[Category:Redirect templates]]

[[ms:Templat:Templat dikecam]]
</includeonly>