模組:Unsubst
![]() | 此模块被引用於約155,000個頁面。 為了避免造成大規模的影響,所有對此模块的編輯應先於沙盒或測試樣例上測試。 測試後無誤的版本可以一次性地加入此模块中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
![]() | 此模块已被保护。此为高度可见模块,其已用于大量条目或被频繁替换引用。由于破坏或失误会影响诸多页面,即便细小的改动也可能导致大量服务器负载,因此已被保护,不可编辑。 |
![]() | 参数$N 已弃用,您可以在Category:使用$N的Module:Unsubst调用中找到使用这一参数的模板并删去$N 。 |
此模組是為了預防不應替換引用的模板利用替換引用導入參數(自我替換引用模板)。
用法
{{{{{|safesubst:}}}#invoke:Unsubst||$B= [ ... 模板的其餘內容 ... ] }}
參數「$B」為不替換引用時的模板內容。除了$B
外所有傳入的參數皆視為是替換引用後的模板代碼,參數__DATE__
會自動轉換成時間(Y年n月)。
有些模板有加上<noinclude>
但未在結尾加上</noinclude>
,此時必須補上。
範例
正常時模板應使用此格式:
{{ {{{|safesubst:}}}#invoke:Unsubst||參數1=值1|date=__DATE__ |$B= [ ... 模板的其餘內容 ... ] }}<noinclude> {{doc}} </noinclude>
原始碼 | 結果 |
---|---|
{{subst:example}} |
{{Example|參數1=值1|date=2024年9月}}
|
{{subst:example|參數1=X}} |
{{Example|參數1=X|date=2024年9月}}
|
{{subst:example|參數2=X}} |
{{Example|參數1=值1|參數2=X|date=2024年9月}}
|
{{subst:example|date={{subst:#time:c}}}} |
{{Example|參數1=值1|date=2024-09-03T04:06:35+00:00}}
|
上述文档嵌入自Module:Unsubst/doc。 (编辑 | 历史) 编者可以在本模块的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。 本模块的子页面。 |
local p = {}
local specialParams = {
['$N'] = 'template name', -- Deprecated, but keeping until it is removed from transcluding templates
['$B'] = 'template content',
}
p[''] = function ( frame )
if not frame:getParent() then
error( '{{#invoke:Unsubst|}} makes no sense without a parent frame' )
end
if not frame.args['$B'] then
error( '{{#invoke:Unsubst|}} requires parameter $B (template content)' )
end
if mw.isSubsting() then
---- substing
-- Combine passed args with passed defaults
local args = {}
for k, v in pairs( frame.args ) do
if not specialParams[k] then
if v == '__DATE__' then
v = mw.getContentLanguage():formatDate( 'Y年n月' )
end
args[k] = v
end
end
for k, v in pairs( frame:getParent().args ) do
args[k] = v
end
-- Build an equivalent template invocation
-- First, find the title to use
local titleobj = mw.title.new(frame:getParent():getTitle())
local title
if titleobj.namespace == 10 then -- NS_TEMPLATE
title = titleobj.text
elseif titleobj.namespace == 0 then -- NS_MAIN
title = ':' .. titleobj.text
else
title = titleobj.prefixedText
end
-- Build the invocation body with numbered args first, then named
local ret = '{{' .. title
for k, v in ipairs( args ) do
if string.find( v, '=', 1, true ) then
-- likely something like 1=foo=bar, we need to do it as a named arg
break
end
ret = ret .. '|' .. v
args[k] = nil
end
for k, v in pairs( args ) do
ret = ret .. '|' .. k .. '=' .. v
end
return ret .. '}}'
else
---- Not substing
-- Just return the "body"
return frame.args['$B'] .. (frame.args['$N'] and frame:getParent():getTitle() == mw.title.getCurrentTitle().prefixedText and '[[Category:使用$N的Module:Unsubst调用]]' or '')
end
end
return p