imported>A2569875 来自 2023年11月6日 (一) 12:23

2023-11-06T12:23:55Z

新页面

{{NoteTA
|G1=MediaWiki
|1=zh-hans:替换引用;zh-hant:替換引用;
}}{{Documentation subpage}}
'''軟替換引用'''（Softsubst）是常規或「硬」[[Help:替換引用|替換引用]]的替代，其不會真的將對應模板替換引用，但會引導編者進行替換引用。[[Help:替換引用|常規替換引用]]與[[Template:Softsubst#top|軟替換引用]]的關聯或差異就好比[[Help:重定向|常規重定向]]與[[Wikipedia:软重定向|軟重定向]]間的差異，同為因技術限制等原因無法達成效果但提供了提示供編者或讀者達成目標。

== 概要 ==
本模板是設計能使一些不能被提換引用的模板提供一個替換引-{}-用的方案。其效果與直接使用模板接近，但預覽時會顯示一個提示框告知編者替換引用後的結果原始碼。

softsubst與safesubst類似，條目儲存編輯在無法替換引用的情況下會有與普通使用模板相同的行為。此外，此用法不同於<code><nowiki>{{#tag:nowiki}}</nowiki></code>與<code><nowiki>{{#tag:pre}}</nowiki></code>，透過這些擴展標籤雖然也能有類似效果，但在擴展標籤之下的原始碼不能用，softsubst則有提示文字題是編者應該檢查校正；而<code><nowiki>{{#tag:source}}</nowiki></code>產生帶代碼偶爾會有多餘的換行符，而此模板沒有此問題。

另外一個類似的工具為[[Special:展开模板]]，然而其無法測試位於頁面局部的特殊環境狀態（如{{tl|變數}}或特殊的多層參數傳遞甚至是特殊環境測試需求），而本模板可以克服此問題。

== 使用方法 ==
若一個模板是無法替換引用的模板，如{{tl|ilh}}，想嘗試替換引用如下代碼：
:<code><nowiki>{{ilh|測試的內容|context for test|lang={{lan|zh-hant=英語|zh-hans=英语}} |lang-code=en}}</nowiki></code>
::→「{{ilh|測試的內容|context for test|lang={{lan|zh-hant=英語|zh-hans=英语}} |lang-code=en}}」
直接替換引用會變為：
:<code><nowiki>{{subst:ilh|測試的內容|context for test|lang={{lan|zh-hant=英語|zh-hans=英语}} |lang-code=en}}</nowiki></code>
::→「{{#invoke:ilh|main}}」（效果異常）
使用Softsubst則為：
:<code><nowiki>{{softsubst|ilh|測試的內容|context for test|lang={{lan|zh-hant=英語|zh-hans=英语}} |lang-code=en}}</nowiki></code>
::→「{{softsubst{{sandbox other|/sandbox}}|ilh|測試的內容|context for test|lang={{lan|zh-hant=英語|zh-hans=英语}} |lang-code=en}}」{{#ifexpr:{{#invoke:參數|call|Module:EditState.isPreview}}+0|（預覽模式下顯示模板可能的原始碼）|（非預覽模式下模板行為接近一般模板）}}
使用Softsubst在預覽模式下會出現以下提示：
::{{變數|subst|2={{ilh|測試的內容|context for test|lang={{lan|zh-hant=英語|zh-hans=英语}} |lang-code=en}}}}
這些原始碼的渲染效果：
::→「[[:測試的內容|測試的內容]]（英語：-{[[:en:context for test|context for test]]}-）」

== 參見 ==
*[[Special:展开模板]]
*{{subst|resubst}}：能使替換引用延遲執行的模板

<includeonly>{{Sandbox other||

}}</includeonly>

Template:Softsubst/doc - 版本历史

imported>A2569875 来自 2023年11月6日 (一) 12:23