模組:Namespace
| 此模組已評為穩定版,穩定可靠,可各處使用無誤。已可在幫助頁面和其他維基百科資源中提及,以幫助新用戶學習。為降低服務器負載和錯誤輸出,改善本模組前應進行沙盒測試,而不是重複的試錯性編輯。 |
| 此模組已被全保護。僅限管理員編輯。 |
| 此模組已被移動保護。僅限管理員移動。 |
| 此模組被引用於約1,070,000個頁面,佔全部頁面的13%。 為了避免造成大規模的影響,所有對此模組的編輯應先於沙盒或測試樣例上測試。實施修改前,建議先在討論頁發起討論。 模板引用數量會自動更新。 |
本模組判斷頁面所在的命名空間,並輸出命名空間的本地化名稱。除了 MediaWiki 的真實命名空間外,也支援偽命名空間(LTA:、NC:、NT:、RSP: 等以冒號前綴模擬命名空間的條目空間頁面)。
命名空間編號、英文名與簡繁中文名在 Module:Namespace/data 維護,語言回退由 Module:Lan2 處理。若需要依頁面的實際內容(重定向、沙盒、子頁面……)細分頁面類型,請改用 Module:Namespace pagename。
用法
Wikitext
namespace
{{#invoke:Namespace|namespace|命名空間|相符時的輸出|不相符時的輸出}}
比對目前頁面所在的命名空間,相符時輸出第二個參數,否則輸出第三個參數。
| 位置參數 | 具名參數 | 說明 |
|---|---|---|
|1= |
|namespace= |
要比對的命名空間,可用編號、名稱或別名,詳見 #_isNamespace。 |
|2= |
|then= |
相符時的輸出,預設為空字串。 |
|3= |
|else= |
不相符時的輸出,預設為空字串。 |
具名參數優先於對應的位置參數。另外,透過模板呼叫時模板的參數會直接傳遞給本函數,且優先於 #invoke 上所寫的參數,因此只要在包裝模板中寫上 {{#invoke:Namespace|namespace}},模板的使用者即可直接提供上述三個參數。
範例(在 Template:Example):
{{#invoke:Namespace|namespace|template|是模板|不是模板}} <!-- 是模板 -->
{{#invoke:Namespace|namespace|10|是模板|不是模板}} <!-- 是模板 -->
{{#invoke:Namespace|namespace|help|是幫助|不是幫助}} <!-- 不是幫助 -->
{{#invoke:Namespace|namespace|help|是幫助}} <!-- (空字串) -->
{{#invoke:Namespace|namespace|namespace=10|then=是模板|else=不是模板}} <!-- 是模板 -->
目前頁面位於偽命名空間時,會以偽命名空間前綴比對,例如在 LTA:Foo 上以 LTA 比對即為相符;偽命名空間的討論頁(Talk:LTA:Foo)同樣視為該偽命名空間。
namespaceName
{{#invoke:Namespace|namespaceName|語言|命名空間}}
輸出命名空間的本地化名稱。
| 參數 | 說明 |
|---|---|
|1= |
語言代碼,如 zh-hant、zh-hans、zh-tw、en。省略或留空時取使用者的介面語言({{int:Lang}});無法對應的語言代碼會回退為英文。
|
|2= |
命名空間,可用編號(10)、命名空間名稱或別名(Template、模板、t)、偽命名空間前綴(LTA、LTA:)或偽命名空間的討論頁前綴(Talk:LTA)。省略時使用目前頁面所在的命名空間。
|
- 省略
|2=且目前頁面位於條目或討論命名空間時,會額外判斷頁面是否位於偽命名空間。 - 本站存在但 Module:Namespace/data 未收錄的命名空間(例如
1728)會輸出空字串。 - 明確傳入空值(
|2=)、無法辨識的命名空間,或偽命名空間的完整頁面名(LTA:Foo)時,會輸出紅字的「輸入命名空間錯誤」。需要由頁面名稱取得偽命名空間前綴時,請先以 #isPseudoNamespace 取得前綴。
範例:
{{#invoke:Namespace|namespaceName|zh-hant|0}} <!-- 條目 -->
{{#invoke:Namespace|namespaceName|zh-hant|10}} <!-- 模板 -->
{{#invoke:Namespace|namespaceName|zh-hant|t}} <!-- 模板 -->
{{#invoke:Namespace|namespaceName|zh-hant|模板}} <!-- 模板 -->
{{#invoke:Namespace|namespaceName|zh-hant|4}} <!-- 專案 -->
{{#invoke:Namespace|namespaceName|zh-hans|2}} <!-- 用户 -->
{{#invoke:Namespace|namespaceName|zh-tw|2}} <!-- 使用者 -->
{{#invoke:Namespace|namespaceName|en|10}} <!-- Template -->
{{#invoke:Namespace|namespaceName|zh-hant|LTA}} <!-- 持續出沒的破壞者捷徑 -->
{{#invoke:Namespace|namespaceName|zh-hant|Talk:LTA}} <!-- 持續出沒的破壞者討論捷徑頁 -->
{{#invoke:Namespace|namespaceName|zh-hant|1728}} <!-- (空字串) -->
{{#invoke:Namespace|namespaceName|zh-hant|corgi}} <!-- 輸入命名空間錯誤(紅字) -->
conversionNamespaceName
{{#invoke:Namespace|conversionNamespaceName|語言|命名空間}}
參數與行為同 #namespaceName,但優先使用 Module:Namespace/data 中的 編號-display,即本站實際顯示的命名空間名稱;未定義 -display 的命名空間則與 #namespaceName 完全相同。目前兩者有差異的是專案與介面命名空間:
| 命名空間 | namespaceName | conversionNamespaceName |
|---|---|---|
4 |
專案 | 維基百科 |
5 |
專案討論 | 維基百科討論 |
8 |
介面 | MediaWiki |
9 |
介面討論 | MediaWiki討論 |
isPseudoNamespace
別名:ispseudo
{{#invoke:Namespace|isPseudoNamespace|頁面名稱}}
檢查頁面是否位於偽命名空間:是則輸出偽命名空間前綴,否則輸出空字串,|1= 省略時檢查目前頁面。與 #namespaceName 的 |2= 不同,本函數接受完整頁面名稱,也接受偽命名空間的討論頁。
範例:
{{#invoke:Namespace|isPseudoNamespace|LTA}} <!-- LTA -->
{{#invoke:Namespace|isPseudoNamespace|LTA:Foo}} <!-- LTA -->
{{#invoke:Namespace|isPseudoNamespace|Talk:LTA:Foo}} <!-- LTA -->
{{#invoke:Namespace|isPseudoNamespace|RSP:Foo}} <!-- RSP -->
{{#invoke:Namespace|isPseudoNamespace|Template:Foo}} <!-- (空字串) -->
{{#invoke:Namespace|ispseudo}} <!-- 目前頁面的偽命名空間前綴 -->
已有包裝模板 Template:IsPNS(輸出前綴)與 Template:IfPNS(條件判斷)。
Lua
以下範例中隱含
local mNS = require('Module:Namespace')
_lan
僅供Module:Namespace pagename使用的內部函數。
_isNamespace
-- @param string|number id
-- @return string|number|nil
mNS._isNamespace(id)檢查一個輸入是不是偽命名空間或真實命名空間,返回偽命名空間、命名空間編號或 nil。
範例:
mNS._isNamespace("") -- 0
mNS._isNamespace("0") -- 0
mNS._isNamespace(0) -- 0
mNS._isNamespace("t") -- 10
mNS._isNamespace("模板") -- 10
mNS._isNamespace("template") -- 10
mNS._isNamespace("LTA") -- "LTA"
mNS._isNamespace("LTA:") -- "LTA"
mNS._isNamespace("corgi") -- nil
mNS._isNamespace(-999) -- nil
_pseudoNamespaceDisplay
僅供Module:Namespace pagename使用的函數,不保證穩定性。
-- @param string lang
-- @param string ns
-- @param bool isTalk
-- @return string
-- @throw
mNS._pseudoNamespaceDisplay(lang, ns, isTalk)返回偽命名空間的顯示名。輸入的偽命名空間不存在會拋出錯誤,使用前請先用 #_isPseudoNamespace 檢查是否是有效偽命名空間。
範例:
mNS._pseudoNamespaceDisplay("zh", "LTA") -- 持续出没的破坏者快捷方式
mNS._pseudoNamespaceDisplay("zh", "NC") -- 命名常规快捷方式
mNS._pseudoNamespaceDisplay("zh", "NT") -- 收录标准快捷方式
mNS._pseudoNamespaceDisplay("zh", "RSP") -- 来源评级快捷方式
mNS._pseudoNamespaceDisplay("zh-hant", "LTA", false) -- 持續出沒的破壞者捷徑
mNS._pseudoNamespaceDisplay("zh-hant", "LTA", true) -- 持續出沒的破壞者討論捷徑頁
_isPseudoNamespace
-- @param string|nil ns
-- @param false|nil [isPage]
-- @return nil|string, boolean
-- @throw
mNS._isPseudoNamespace(ns, isPage)
-- @param string|mw.title|nil page
-- @param true isPage
-- @return nil|string, boolean
-- @throw
mNS._isPseudoNamespace(page, isPage)檢查一個輸入是不是偽命名空間,返回偽命名空間(或 nil),以及該偽命名空間是否位於討論命名空間。
isPage為true時,第一個參數視為頁面,可以是字串或mw.title物件,冒號後的內容會被忽略。isPage為false或nil時,第一個參數只能是字串,且只接受PNS與PNS:兩種形式;LTA:Foo這類完整頁面名稱會被判定為非偽命名空間。- 第一個參數為
nil或省略時改用目前頁面,並視為isPage = true。 - 不在條目或討論命名空間的頁面一律返回
nil, false。 - 第一個參數既不是字串也不是
mw.title物件時會拋出錯誤。
範例:
mNS._isPseudoNamespace("LTA") -- "LTA", false
mNS._isPseudoNamespace("LTA:") -- "LTA", false
mNS._isPseudoNamespace("Talk:LTA") -- "LTA", true
mNS._isPseudoNamespace("LTA:Foo") -- nil, false(isPage 不為 true)
mNS._isPseudoNamespace("") -- nil, false
mNS._isPseudoNamespace("corgi") -- nil, false
mNS._isPseudoNamespace("LTA:Foo", true) -- "LTA", false
mNS._isPseudoNamespace("Talk:LTA:Foo", true) -- "LTA", true
mNS._isPseudoNamespace("Template:LTA", true) -- nil, false(不在條目或討論命名空間)
mNS._isPseudoNamespace(10) -- 拋出錯誤
_namespaceName
-- @param string|nil [lang]
-- @param string|number|nil [ns]
-- @return string
-- @throw
mNS._namespaceName(lang, ns)返回命名空間的本地化名稱,參數與 #namespaceName 相同,但錯誤會直接拋出而不是輸出紅字訊息。lang 省略或為空字串時取使用者的介面語言;ns 省略時使用目前頁面所在的命名空間,並在頁面位於條目或討論命名空間時額外判斷偽命名空間。
範例:
mNS._namespaceName("zh-hant", 0) -- "條目"
mNS._namespaceName("zh-hant", "t") -- "模板"
mNS._namespaceName("zh-hant", 4) -- "專案"
mNS._namespaceName("zh-hans", 2) -- "用户"
mNS._namespaceName("zh-tw", 2) -- "使用者"
mNS._namespaceName("en", 10) -- "Template"
mNS._namespaceName("zh-hant", "LTA") -- "持續出沒的破壞者捷徑"
mNS._namespaceName("zh-hant", "Talk:LTA") -- "持續出沒的破壞者討論捷徑頁"
mNS._namespaceName("zh-hant", 1728) -- ""(Module:Namespace/data 未收錄)
mNS._namespaceName("zh-hant") -- 目前頁面所在命名空間的名稱
mNS._namespaceName("zh-hant", "") -- 拋出錯誤
mNS._namespaceName("zh-hant", "corgi") -- 拋出錯誤
mNS._namespaceName("zh-hant", "LTA:Foo") -- 拋出錯誤(請先用 _isPseudoNamespace 取得前綴)
_conversionNamespaceName
-- @param string|nil [lang]
-- @param string|number|nil [ns]
-- @return string
-- @throw
mNS._conversionNamespaceName(lang, ns)同 #_namespaceName,但優先使用 Module:Namespace/data 中的 編號-display,即本站實際顯示的命名空間名稱,差異見 #conversionNamespaceName。
範例:
mNS._conversionNamespaceName("zh-hant", 4) -- "維基百科"
mNS._conversionNamespaceName("zh-hant", 8) -- "MediaWiki"
mNS._conversionNamespaceName("zh-hant", 10) -- "模板"(無 10-display,同 _namespaceName)
已棄用的別名
下列函數名稱因命名不當而棄用,行為與對應的新名稱完全相同,請勿在新的程式碼中使用:
| 已棄用 | 請改用 |
|---|---|
NamespacesDisplay |
#namespaceName |
NamespacesConversionDisplay |
#conversionNamespaceName |
_NamespacesDisplay |
#_namespaceName |
_NamespacesConversionDisplay |
#_conversionNamespaceName |
_PseudoNamespaceDisplay |
#_pseudoNamespaceDisplay |
參見
- Module:Namespace/data-命名空間與偽命名空間的資料
- Module:Namespace/testcases-單元測試
- Module:Namespace pagename-依頁面實際內容細分頁面類型
- Module:Lan2-語言回退
- Template:NS、Template:NS1-顯示命名空間名稱
- Template:IsPNS、Template:IfPNS-偽命名空間判斷
require('strict')
local p = {}
local data = mw.loadData('Module:Namespace/data')
local mLan = require('Module:Lan2')
local getArgs
local function ifempty(ret, val)
return ret ~= '' and ret or val
end
local function inArray(str, arr)
for i, v in ipairs(arr) do
if str == v then
return v
end
end
return nil
end
-- @internal
-- @see [[Module:Namespace pagename]]
function p._lan(args, lang)
return mLan.main(args,
ifempty(lang and lang:lower(), mw.getCurrentFrame():callParserFunction { name = 'int', args = { 'Lang' } }), {
['def'] = { 'en' }
})
end
-- 檢查一個輸入是不是偽命名空間或真實命名空間,返回偽命名空間、命名空間編號或 nil。
-- @param string|number id
-- @return string|number|nil
function p._isNamespace(id)
id = tostring(id)
local PNS, _ = p._isPseudoNamespace(id)
return
PNS
or mw.site.namespaces[tonumber(id) or id:lower()] and mw.site.namespaces[tonumber(id) or id:lower()].id
or nil
end
function p.namespace(frame)
local args
if frame == mw.getCurrentFrame() then
-- We're being called via #invoke. The args are passed through to the module
-- from the template page, so use the args that were passed into the template.
if not getArgs then
getArgs = require('Module:Arguments').getArgs
end
args = getArgs(frame, { parentFirst = true })
else
-- We're being called from another module or from the debug console, so assume
-- the args are passed in directly.
args = frame
if type(args) ~= type({}) then args = { frame } end
end
local id = tostring(args.namespace or args[1])
local PNS, _ = p._isPseudoNamespace()
return (PNS or mw.title.getCurrentTitle().namespace) == p._isNamespace(id) and (args['then'] or args[2]) or (args['else'] or args[3])
end
local UNKNOWN_NAMESPACE = -3
for key, func in pairs({
namespaceName = function(nsid)
return data.Namespace[tostring(nsid)]
end,
conversionNamespaceName = function(nsid)
return data.Namespace[tostring(nsid) .. '-display'] or data.Namespace[tostring(nsid)]
end,
}) do
-- @param string|nil [lang]
-- @param string|nil [ns]
-- @throw
-- @return string
p['_' .. key] = function(lang, ns)
local PNS, PNSIsTalk
local nsid
if ns ~= nil then
if ns == '' then
nsid = UNKNOWN_NAMESPACE
else
local nsid_info = mw.site.namespaces[tonumber(ns)] or mw.site.namespaces[ns]
if not nsid_info then
PNS, PNSIsTalk = p._isPseudoNamespace(ns, false)
nsid = UNKNOWN_NAMESPACE
else
nsid = nsid_info.id
end
end
else
local title = mw.title.getCurrentTitle()
nsid = title.namespace
if nsid == 0 or nsid == 1 then
PNS, PNSIsTalk = p._isPseudoNamespace(title, true)
end
end
if PNS then
return p._pseudoNamespaceDisplay(lang, PNS, PNSIsTalk)
elseif nsid <= UNKNOWN_NAMESPACE then
error('Input namespace error.')
end
return p._lan(func(nsid), lang)
end
p[key] = function(frame)
if not getArgs then
getArgs = require('Module:Arguments').getArgs
end
local args = getArgs(frame, {
valueFunc = function(k, v)
if k == 2 then
return type(v) == 'string' and mw.text.trim(v) or v
elseif v then
v = mw.text.trim(v)
if v ~= '' then
return v
end
end
return nil
end
})
local lang = args[1]
local ns = args[2]
local statue, wt = pcall(p['_' .. key], lang, ns)
if statue then
return wt
end
return tostring(mw.html.create('span'):attr('style', 'color:red;'):wikitext(
p._lan({
['en'] = 'Input namespace error',
['zh-hans'] = '输入命名空间错误',
['zh-hant'] = '輸入命名空間錯誤'
}, lang)
):done())
end
end
-- @deprecated 命名不當
p.NamespacesDisplay = p.namespaceName
-- @deprecated 命名不當
p._NamespacesDisplay = p._namespaceName
-- @deprecated 命名不當
p.NamespacesConversionDisplay = p.conversionNamespaceName
-- @deprecated 命名不當
p._NamespacesConversionDisplay = p._conversionNamespaceName
-- @param string|nil ns
-- @param false|nil [isPage]
-- @throw
-- @return nil|string, boolean
-- @overload function _isPseudoNamespace(ns, isPage)
-- ----
-- @param string|mw.title|nil page
-- @param true isPage
-- @throw
-- @return nil|string, boolean
-- @overload function _isPseudoNamespace(page, isPage)
function p._isPseudoNamespace(nsOrPage, isPage)
if not nsOrPage then
nsOrPage = mw.title.getCurrentTitle()
isPage = true
elseif nsOrPage == '' then
return nil, false
end
local success, titleObj
if type(nsOrPage) == type('') then
if not nsOrPage:match(':') then
nsOrPage = nsOrPage .. ':'
end
success, titleObj = pcall(mw.title.new, nsOrPage)
if not success or not titleObj or not titleObj:inNamespaces(0, 1) then
return nil, false
end
local split = mw.text.split(titleObj.text, ':')
if not isPage and (#split > 2 or (split[2] ~= '' and split[2] ~= nil)) then
-- isPage = false 時僅允許:
-- 1. PNS
-- 2. PNS:
return nil, false
end
nsOrPage = split[1] -- 移除冒號後的東西
elseif type(nsOrPage) == type({}) and type(nsOrPage.text) == type('') and isPage then
-- 如果傳入頁面物件,則 isPage 必然要是 true
if not nsOrPage:inNamespaces(0, 1) then
return nil, false
end
titleObj = nsOrPage
nsOrPage = mw.text.split(nsOrPage.text, ':')[1] -- 移除冒號後的東西
else
error(string.format(
'bad argument #1 to \'_isPseudoNamespace[isPage=%s]\' (%s expected, got %s)',
isPage and 'true' or 'false',
isPage and 'string or mw.title object' or 'string',
type(nsOrPage)
))
end
if inArray(nsOrPage, data['PseudoNamespace']['list']) then
return nsOrPage, titleObj.namespace == 1
end
return nil, false
end
function p.isPseudoNamespace(frame)
local arg = require('Module:Arguments').getArgs(frame)['1']
local PNS, _ = p._isPseudoNamespace(arg, true)
return PNS or ''
end
-- @alias
p.ispseudo = p.isPseudoNamespace
-- @internal
-- @see [[Module:Namespace pagename]]
function p._pseudoNamespaceDisplay(lang, ns, isTalk)
if not inArray(ns, data['PseudoNamespace']['list']) then
error('Input pseudo namespace error.')
end
local display = p._lan(data.PseudoNamespace.messages[isTalk and 'talk' or 'main'], lang)
display = mw.ustring.gsub(display, '$1', p._lan(data.PseudoNamespace[ns], lang))
return display
end
-- @deprecated 命名不當
p._PseudoNamespaceDisplay = p._pseudoNamespaceDisplay
return p