imported>Ericliu1912：修正筆誤

2026-04-25T14:00:12Z

修正筆誤

新页面

<includeonly></includeonly><noinclude>{{template doc page viewed directly}}</noinclude>

{{Tl|Deprecated template}}模板用於在其他模板的'''程式碼'''中（而非其 {{mono|/doc}}子頁面）標示該模板已被取代或不建議再使用。當該模板被嵌入或檢視時，會顯示提示，通知使用者該模板已被其他模板取代，當模板只是單純被[[已弃用|棄用]]且無新模板作為替代時，也可以使用此模板。
這個模板在以下情況最有幫助：
*若由於用途差異而無法將舊模板直接[[WP:R|重新導向]]至新模板；
*或希望減少重新導向數量以方便機械人處理。

'''如該模板已「完全棄用」'''，可在其他頁面嵌入時，讓{{Tlc|Deprecated template}}的提示訊息完全取代其內容，方法是在模板內容全部替換為{{tag|includeonly|content={<nowiki/>{Deprecated template}<nowiki/>}}}。這樣使用者在套用該模板時，只會見到提示訊息，而不會實際執行該已棄用的模板。

{{tl|Historical template}} 則是另一個相關模板，適用於社群已達成共識認為該模板應停止使用，但若移除會導致歷史專案頁面出現嚴重錯誤的情況。

{{tl|Deleted template}} 則提供一種方式，可在刪除模板的同時保留其舊版本供歷史頁面顯示正確內容之用。

== 用法 ==
=== 尚未完全棄用的模板 ===

若某個模板仍被使用中（即仍有頁面在[[Wikipedia:嵌入包含|嵌入]]它），因此尚未準備好完全棄用，可在該模板原始碼中的{{Tlc|Deprecated template}}外加上 {{Tag|noinclude}}標籤。
這樣可確保棄用提示只會顯示在模板的說明頁面，而不會出現在所有使用該模板的頁面上。

若模板尚未完全棄用，可在其程式碼中加入以下內容：
<syntaxhighlight lang="wikitext">
<noinclude>
{{Deprecated template}}
</noinclude>
</syntaxhighlight>

=== 已完全棄用的模板 ===

當某個模板已經'''完全棄用'''，並且不再被任何頁面嵌入時，可以移除該模板程式碼中包圍{{Tlc|Deprecated template}}的{{Tag|noinclude}}標籤。
這樣做後，任何仍在使用該已棄用模板的頁面都會自動顯示棄用提示。

之後，可考慮透過[[WP:AFD]]提名刪除該模板，或以{{tl|Historical template}}取代，以標示該模板已屬歷史用途。

<syntaxhighlight lang="wikitext">
{{Deprecated template|已棄用模板名稱|新模板名稱}}
</syntaxhighlight>

若未提供第二個（即替代模板名稱）參數，則僅會顯示一般的棄用提示，如下所示：

{{Deprecated template|nocat=true}}

== 参数 ==
=== 標準用法 ===

{{Tlx|Deprecated template|已棄用模板名稱|新模板名稱}}
{{Deprecated template|已棄用模板名稱|新模板名稱|nocat=true}}

===額外說明===

模板可透過下述方式顯示新模板應使用的參數：

{{Tlx|Deprecated template|已棄用模板名稱|新模板名稱|parameter}}

{{Deprecated template|已棄用模板名稱|新模板名稱|parameter|nocat=true}}

{{Tlx|Deprecated template|已棄用模板名稱|新模板名稱|<nowiki>parameter{{=}}foo</nowiki>}}

{{Deprecated template|已棄用模板名稱|新模板名稱|<nowiki>parameter=foo</nowiki>|nocat=true}}

此模板亦可顯示附註說明，例如：

{{Tlx|Deprecated template|舊模板名稱|新模板名稱|note{{=}}此處可加入更多詳情，例如為何保留該模板、替換過程的具體情況，或在有兩個以上新模板時的詳細說明。}}
{{Deprecated template|Old|New|note=此處可加入更多詳情，例如為何保留該模板、替換過程的具體情況，或在有兩個以上新模板時的詳細說明。|nocat=true}}

參數{{para|note}}亦可改用{{para|reason}}或{{para|result}}。

=== 用於模板命名空間以外頁面的特殊參數 ===

參數{{para|old}}和{{para|new}}可搭配完整名稱（包含命名空間）使用，例如：

{{Tlx|Deprecated template|old{{=}}Template:已棄用模板名稱|new{{=}}Wikipedia:新模板說明}}
{{Deprecated template|old=Template:已棄用模板名稱|new=Wikipedia:新模板說明|nocat=true}}

若要連結至一個包含多個模板的分類頁，請使用加上冒號的語法：
<code>:Category:{{var|此處填寫分類名稱}}</code>（冒號「:」必須置於最前方）。

另外，{{para|new}} 參數不能與第三個未命名參數（即用來示範第三個模板的參數）同時使用。
例如，下列語法是無效的： 
{{in5}}<code>{{!mxt|1=<nowiki>{{Deprecated template|已棄用模板名稱|new=User:Example/MyTemplate|<nowiki>chickens=yes</nowiki>}}</nowiki>}}</code> 

理論上此模板可以加入這項功能，但截至目前並沒有需要這樣用法的情況。

=== 關閉分類功能 ===

可在模板後加入 <code><nowiki>|nocat=true</nowiki></code> 以避免自動加入分類。當模板的展示僅供範例用途，例如在模板自身的說明頁中使用時，可以加入此參數。啟用此參數後，該頁面本身不會被加入[[:Category:已停用模板]]，而且嵌入該頁面的其他頁面亦不會被加入至 [[:Category:使用已停用模板的页面]]分類中。

請不要以此參數來抗議模板被棄用。若對模板的棄用狀態或說明內容有異議，請前往該模板的討論頁，或相關社群討論頁面（例如[[Wikipedia:互助客栈/技术]]）提出。

=== 完整參數 ===
;<code><nowiki>{{Deprecated template|旧模板名称|新模板名称|date=被废弃的时间}}</nowiki></code>
所有参数都是可选的。
*<code>new</code>：未过时的模板。
*<code>date</code>：被废弃的时间，必须是ISO格式，如{{#time:Y-m-d}}。
*{{code|historical}}：是否是由于历史原因保留。
*{{code|nocat}}：是否關閉分類。

{| class="wikitable"
|-
! 代码 !! 显示效果
|-
| <nowiki>{{Deprecated template}}</nowiki>
|| {{Deprecated template|nocat=true}}
|-
| <nowiki>{{Deprecated template|date=</nowiki>{{#time:Y-m-d}}<nowiki>}}</nowiki>
|| {{Deprecated template|date={{#time:Y-m-d}}|nocat=true}}
|-
| <nowiki>{{Deprecated template|Deprecated template</nowiki> <nowiki>
|date=</nowiki>{{#time:Y-m-d}}<nowiki>}}</nowiki>
|| {{Deprecated template|Deprecated template|date={{#time:Y-m-d}}|nocat=true}}
|-
| <nowiki>{{Deprecated template|Deprecated template</nowiki> <nowiki>
|new=Template:Update after|date=</nowiki>{{#time:Y-m-d}}<nowiki>}}</nowiki>
||{{Deprecated template|Deprecated template|new=Template:Update after|date={{#time:Y-m-d}}|nocat=true}}
|-
|<nowiki>{{Deprecated template|Deprecated template</nowiki> <nowiki>|new=Template:Update after</nowiki> <nowiki>|note=你也可以用其他模板。|date=</nowiki>{{#time:Y-m-d}}<nowiki>}}</nowiki>
|| {{Deprecated template|Deprecated template|new=Template:Update after|note=你也可以用其他模板。|date={{#time:Y-m-d}}|nocat=true}}
|}

==模板資料==
{{TemplateData header}}
<templatedata>
{
"params": {
"3": {
"label": "參數",
"description": "顯示新模板的參數，必須使用 <nowiki></nowiki> 標籤包住。",
"example": "<nowiki>parameter=foo</nowiki>",
"type": "content",
"suggested": true
},
"old": {
"aliases": [
"1"
],
"label": "已棄用模板名稱",
"description": "要被取代的模板名稱。",
"type": "line",
"default": "{{PAGENAME}}",
"suggested": true
},
"by": {
"label": "棄用者／原因來源",
"description": "指出由誰或由甚麼原因使該模板被棄用。",
"type": "line"
},
"historical": {
"label": "是否因歷史原因而保留？",
"description": "如填入任何值，會顯示「並僅因歷史原因而保留」。",
"example": "yes",
"type": "boolean"
},
"new": {
"aliases": [
"2"
],
"label": "替代模板",
"description": "取代該已棄用模板的模板頁名稱。一般無需加上命名空間前綴，但如有需要也可加入，甚至可指向其他命名空間。若要連結至包含多個模板的分類，請使用以冒號開頭的語法，如「:Category:此處填寫分類名稱」。",
"type": "line",
"suggested": true
},
"note": {
"aliases": [
"reason",
"result"
],
"label": "附註",
"description": "說明該模板被棄用的原因、如何替換為新模板說明，或任何其他有用資訊。",
"type": "content",
"suggested": true
},
"nocat": {
"label": "關閉分類功能",
"description": "設定為true以避免自動加入分類。當模板的展示僅供範例用途，例如在模板自身的說明頁中使用時，可以加入此參數。啟用此參數後，該頁面本身不會被加入「Category:已停用模板」，而且嵌入該頁面的其他頁面亦不會被加入至「Category:使用已停用模板的頁面」分類中。",
"example": "true",
"type": "boolean"
}
},
"description": "提示使用者某個模板已被其他模板取代，當模板只是單純被棄用且無新模板作為替代時，也可以使用此模板。",
"paramOrder": [
"old",
"new",
"3",
"note",
"by",
"historical",
"nocat"
],
"format": "inline"
}
</templatedata>

== 參見 ==
* [[Template:Deleted template]]--刪除模版
* [[:Category:已停用模板]]
* {{clc|Category:使用已停用模板的页面}}

<includeonly>

[[Category:模板頁的模板|{{PAGENAME}}]]
[[Category:重定向模板|{{PAGENAME}}]]
</includeonly>

Template:Deprecated template/doc - 版本历史

imported>Ericliu1912：​修正筆誤

imported>Ericliu1912：修正筆誤