模块:Namespace pagename/data
| 此模块已被全保护。仅限管理员编辑。 |
本页是 Module:Namespace pagename 的资料页,以 mw.loadData 载入,存放页面类型的名称、各命名空间的默认字尾,以及各种判定规则。本页只有资料,判断逻辑在 Module:Namespace pagename;命名空间本身的名称在 Module:Namespace/data。
各项设定的使用时机与先后顺序见 Module:Namespace pagename#判定顺序。
数据结构
NS
命名空间编号常量,供本页其他设定以名称而非数字索引使用。主模块也会读取,但目前只用到 NS.USER 与 NS.MODULE_TALK。
EVENT(1728)与 EVENT_TALK(1729)虽已定义,但 Module:Namespace/data 未收录其名称,因此这两个命名空间的输出目前是空字符串。
ContentModelMap
内容模型到页面类型的直接映射,命中后不再检查重定向、子页面与页面内容。
| 内容模型 | 页面类型 | 输出(繁体) |
|---|---|---|
css、sanitized-css |
style |
样式 |
javascript |
script |
工具 |
json |
json |
数据 |
NamespaceSuffixConfig
DefaultSuffixList
每个命名空间在没有判断出页面类型时附加的字尾。键是命名空间编号,值为 false 表示不加字尾;未列出的命名空间同样不加字尾。
字尾本身由本页开头的区域变数 suffixTemplates 定义:
| 名称 | en | zh-hans | zh-hant | 用户 |
|---|---|---|---|---|
page |
page |
页 | 页 | 界面、帮助与各讨论命名空间 |
pageWithSpace |
page |
页 | 页 | 目前未被使用 |
pageName |
page |
页面 | 页面 | 特殊 |
pageNameWithSpace |
page |
页面 | 页面 | 项目 |
userPage |
page |
页 | 页面 | 用户 |
- “不加字尾”的命名空间:媒体、条目、文件、模板、分类、主题、维基专题、草稿、MOS、字幕、模块、结构式讨论。
- 英文输出的特殊处理:
page与pageName的英文值没有前置空白,因此英文会输出Talkpage、Helppage、MediaWikipage、Specialpage、User talkpage。要修正请改用带空白的pageWithSpace/pageNameWithSpace。
EnablePageTypeNamespaces
会进一步检测页面类型(内容模型、重定向、子页面名称、页面内容)的命名空间白名单。不在此列的命名空间一律只输出“命名空间名称+默认字尾”。
目前为:用户(2)、项目(4)、文件(6)、模板(10)、草稿(118)、模块(828)。
此白名单不影响固定沙盒(SandboxPageNames)与编辑提示(NoticeRules),这两项在白名单检查之前就已判断。
AllowTemplateType
允许判定为文件、沙盒、测试样例的命名空间。目前为:用户(2)、模板(10)、模块(828)。
AllowTempType
允许判定为临时页的命名空间。目前为:用户(2)、项目(4)、模板(10)、草稿(118)、模块(828)。
Error
错误讯息,%s 会替换成用户的输入值。
| 键 | 用途 |
|---|---|
pg-error |
第二参数无法解析成合法页面名称时输出。 |
ns-error |
目前未被主模块使用。 |
SandboxPageNames
各命名空间的固定沙盒页名。键是命名空间编号,值是“页面名称 → true”的表,比对的是 title.text(不含命名空间前缀的完整页面名)。
| 命名空间 | 页面名称 |
|---|---|
| 项目(4) | 沙盒、重定向沙盒 |
| 用户讨论(3) | Sandbox for user warnings~zhwiki |
| 模板(10) | 沙盒、X1、X2、X3 |
| 分类(14) | 沙盒 |
| 草稿(118) | 沙盒 |
| 文件(6) | 沙盒.png、沙盒.svg |
此外主模块另有一条硬编码规则:用户命名空间下符合 ×××/沙盒(仅一层子页面)的页面也视为沙盒。更深层的 ×××/×××/沙盒 则由 SubpageRules 的 sandbox 规则命中。
SubpageRules
依子页面名称判定页面类型。键是页面类型(须在 #Type 中有对应项),值可包含:
| 栏位 | 说明 |
|---|---|
names |
子页面名称的清单。比对前会把 title.subpageText 的第一个字转成小写,因此 /Doc 会命中而 /DOC 不会。
|
matcher.allowNs |
允许的命名空间清单。 |
matcher.subpageOnly |
是否只匹配子页面。 |
未设 matcher 的规则只在子页面上生效,且命名空间须在 AllowTemplateType(temp 则是 AllowTempType)之中。
目前规则:
| 类型 | names | matcher |
|---|---|---|
doc |
doc |
- |
sandbox |
sandbox、沙盒 |
- |
testcases |
testcases、测试样例、測試樣例 |
- |
temp |
temp、temporary |
- |
intro |
intro、introduction、说明、說明 |
模板命名空间,且必须是子页面 |
NoticeRules
编辑提示类页面的判定规则。matcher 以命名空间编号为键,每项可包含:
| 栏位 | 说明 |
|---|---|
rootText |
根页面名称须等于此值。 |
subpageText |
最后一层子页面名称须等于此值(区分大小写)。 |
onlyFirstLevel |
只匹配第一层子页面(title.rootText == title.baseText)。
|
目前规则:
| 类型 | 命中的页面 |
|---|---|
editnotice |
Template:Editnotices/×××、User:×××/Editnotice、User talk:×××/Editnotice
|
mailnotice |
User:×××/Emailnotice
|
命中后输出会直接取代整个结果,不附加命名空间名称;#Type 中的 %u 会换成指向 title.rootText 的用户链接。
ContentRules
依页面内容判定类型,是判定顺序中的最后一步。键是页面类型,值是阵列,每项可以是 mw.ustring.match 的 Lua 模式,或接受 (nsid, content) 的函数。
sandbox 不受 AllowTemplateType 限制(只要命名空间在 EnablePageTypeNamespaces 之中即会检测),doc 与 testcases 则另须命名空间在 AllowTemplateType 之中。
| 类型 | 侦测的标记 |
|---|---|
sandbox |
{{Sandbox…}}、{{Template sandbox notice}},以及简繁两种“请在这行文字底下进行您的测试……”提示
|
doc |
{{Documentation subpage}}、{{Template doc inline}}、{{Template doc viewed directly}}
|
testcases |
{{Template testcases notice}}、{{Test cases notice}}、{{测试样例}}、{{測試樣例}}
|
读取页面内容会用到 title:getContent(),计入解析器的昂贵函数配额,因此主模块提供 skipCheckContent 参数可略过这一步。
Type
页面类型的显示名称,格式与 Module:Namespace/data 的语言表相同,由 Module:Lan2 依用户语言回退挑选。分两类:
接在命名空间名称后面当字尾,英文值开头的空白请勿删除:
| 类型 | en | zh-hans | zh-hant |
|---|---|---|---|
style |
styles |
样式 | 样式 |
script |
scripts |
脚本 | 工具 |
json |
data |
数据 | 数据(zh-tw:资料)
|
redirect |
redirect |
重定向 | 重定向 |
doc |
documentation |
文档 | 文件 |
sandbox |
sandbox |
沙盒 | 沙盒 |
testcases |
testcases |
测试样例 | 测试样例 |
temp |
temporary page |
临时页 | 临时页 |
intro |
introductory page |
说明页 | 说明页 |
直接取代整个输出,英文值不需要前置空白:
| 类型 | en | zh-hans | zh-hant | 备注 |
|---|---|---|---|---|
external |
Interlanguage link |
跨语言链接 | 跨语言链接 | |
editnotice |
editnotice |
编辑提示 | 编辑提示 | |
mailnotice |
%u's mailnotice |
%u的电邮提示 | %u的电邮提示 | %u 会换成用户链接
|
shortcut |
Shortcut of %s |
%s快捷方式 | %s捷径 | 目前未被主模块使用 |
shortcut 之所以未被使用,是因为伪命名空间的显示已交由 Module:Namespace 依 Module:Namespace/data 的 PseudoNamespace.messages 产生。
编辑指引
- 新增页面类型时,须同时在
Type加入名称,并在SubpageRules、ContentRules或NoticeRules加入对应的判定规则;字尾型的类型记得在英文值前面留一个空白。 - 让既有类型适用于更多命名空间时,改
EnablePageTypeNamespaces、AllowTemplateType或AllowTempType,不要在主模块里加特例。 - 新增命名空间时,除了本页的
NS与DefaultSuffixList,还要在 Module:Namespace/data 补上名称,否则输出会缺少命名空间名称。 - 改动后请用 Template:Namespace pagename/testcases 验证,该页已涵盖各命名空间与各页面类型的组合。
参见
- Module:Namespace pagename-使用本页资料的主模块
- Module:Namespace/data-命名空间名称的资料
- Module:Lan2-语言回退
- Template:Namespace pagename、Template:Namespace pagename/testcases-包装模板与测试样例
require('strict')
-- 命名空间常量
local NS = {
MEDIA = -2,
SPECIAL = -1,
MAIN = 0,
TALK = 1,
USER = 2,
USER_TALK = 3,
PROJECT = 4, -- Wikipedia
PROJECT_TALK = 5, -- Wikipedia talk
FILE = 6,
FILE_TALK = 7,
MEDIAWIKI = 8,
MEDIAWIKI_TALK = 9,
TEMPLATE = 10,
TEMPLATE_TALK = 11,
HELP = 12,
HELP_TALK = 13,
CATEGORY = 14,
CATEGORY_TALK = 15,
PORTAL = 100,
PORTAL_TALK = 101,
WIKIPROJECT = 102,
WIKIPROJECT_TALK = 103,
DRAFT = 118,
DRAFT_TALK = 119,
MOS = 126,
MOS_TALK = 127,
TIMEDTEXT = 710,
TIMEDTEXT_TALK = 711,
MODULE = 828,
MODULE_TALK = 829,
EVENT = 1728,
EVENT_TALK = 1729,
TOPIC = 2600,
}
-- 各种字尾
-- 英文的字尾與命名空間名稱之間要留一個空白,特殊頁面 (-1) 與討論命名空間(nsid % 2 == 1)除外,
-- 因此非討論命名空間請使用 pageWithSpace / pageNameWithSpace。
local suffixTemplates = {
-- 使用「頁」的字尾
page = { ['en'] = 'page', ['zh-hans'] = '页', ['zh-hant'] = '頁' },
pageWithSpace = { ['en'] = ' page', ['zh-hans'] = '页', ['zh-hant'] = '頁' },
-- 使用「頁面」的字尾
pageName = { ['en'] = 'page', ['zh-hans'] = '页面', ['zh-hant'] = '頁面' },
pageNameWithSpace = { ['en'] = ' page', ['zh-hans'] = '页面', ['zh-hant'] = '頁面' },
-- 使用者頁面特殊處理
userPage = { ['en'] = ' page', ['zh-hans'] = '页', ['zh-hant'] = '頁面' },
}
return {
-- 命名空间常量
NS = NS,
-- 内容模型直接映射到页面类型
ContentModelMap = {
['css'] = 'style',
['sanitized-css'] = 'style',
['javascript'] = 'script',
['json'] = 'json',
},
NamespaceSuffixConfig = {
-- 字尾 頁/頁面 的列表
DefaultSuffixList = {
-- 不要加字尾
[NS.MEDIA] = false,
[NS.MAIN] = false,
[NS.FILE] = false,
[NS.TEMPLATE] = false,
[NS.CATEGORY] = false,
[NS.PORTAL] = false,
[NS.WIKIPROJECT] = false,
[NS.DRAFT] = false,
[NS.MOS] = false,
[NS.TIMEDTEXT] = false,
[NS.MODULE] = false,
[NS.TOPIC] = false,
-- 页面 / 頁面
[NS.SPECIAL] = suffixTemplates.pageName, -- 特殊页面
[NS.PROJECT] = suffixTemplates.pageNameWithSpace, -- 维基百科页面
-- 使用者頁面特殊處理:页 / 頁面
[NS.USER] = suffixTemplates.userPage,
-- 页 / 頁
[NS.MEDIAWIKI] = suffixTemplates.pageWithSpace,
[NS.HELP] = suffixTemplates.pageWithSpace,
[NS.TALK] = suffixTemplates.page,
[NS.USER_TALK] = suffixTemplates.page,
[NS.PROJECT_TALK] = suffixTemplates.page,
[NS.FILE_TALK] = suffixTemplates.page,
[NS.MEDIAWIKI_TALK] = suffixTemplates.page,
[NS.TEMPLATE_TALK] = suffixTemplates.page,
[NS.HELP_TALK] = suffixTemplates.page,
[NS.CATEGORY_TALK] = suffixTemplates.page,
[NS.PORTAL_TALK] = suffixTemplates.page,
[NS.WIKIPROJECT_TALK] = suffixTemplates.page,
[NS.DRAFT_TALK] = suffixTemplates.page,
[NS.MOS_TALK] = suffixTemplates.page,
[NS.TIMEDTEXT_TALK] = suffixTemplates.page,
[NS.MODULE_TALK] = suffixTemplates.page,
},
-- 檢測頁面內容模型(JS/CSS/JSON/重定向)的命名空間
EnablePageTypeNamespaces = {
NS.USER,
NS.PROJECT,
NS.FILE,
NS.TEMPLATE,
NS.DRAFT,
NS.MODULE,
},
-- 檢測文檔、沙盒、測試樣例的命名空間
AllowTemplateType = {
NS.USER,
NS.TEMPLATE,
NS.MODULE,
},
-- 檢測臨時頁面的命名空間
AllowTempType = {
NS.USER,
NS.PROJECT,
NS.TEMPLATE,
NS.DRAFT,
NS.MODULE,
}
},
-- 錯誤
Error = {
['pg-error'] = {
['en'] = 'Invalid page name: %s.',
['zh-hans'] = '页面名称“%s”无效。',
['zh-hant'] = '頁面名稱「%s」無效。'
},
['ns-error'] = {
['en'] = 'Invalid namespace: %s.',
['zh-hans'] = '命名空间“%s”无效。',
['zh-hant'] = '名字空間「%s」無效。'
},
},
-- 沙盒頁面名
SandboxPageNames = {
[NS.PROJECT] = { ['沙盒'] = true, ['重定向沙盒'] = true },
[NS.USER_TALK] = { ['Sandbox for user warnings~zhwiki'] = true },
[NS.TEMPLATE] = { ['沙盒'] = true, ['X1'] = true, ['X2'] = true, ['X3'] = true },
[NS.CATEGORY] = { ['沙盒'] = true },
[NS.DRAFT] = { ['沙盒'] = true },
[NS.FILE] = { ['沙盒.png'] = true, ['沙盒.svg'] = true },
},
-- 子頁面名稱判定規則
SubpageRules = {
doc = {
names = { 'doc' },
},
sandbox = {
names = { 'sandbox', '沙盒' },
},
testcases = {
names = { 'testcases', '测试样例', '測試樣例' },
},
temp = {
names = { 'temp', 'temporary' },
},
intro = {
names = { 'intro', 'introduction', '说明', '說明' },
matcher = { allowNs = { NS.TEMPLATE }, subpageOnly = true },
},
},
-- 编辑提示
NoticeRules = {
editnotice = {
matcher = {
-- Template:Editnotices/xxx
[NS.TEMPLATE] = { rootText = 'Editnotices' },
-- User:xxx/Editnotice 与 User talk:xxx/Editnotice
[NS.USER] = { subpageText = 'Editnotice', onlyFirstLevel = true },
[NS.USER_TALK] = { subpageText = 'Editnotice', onlyFirstLevel = true },
},
},
mailnotice = {
-- User:xxx/Emailnotice
matcher = {
[NS.USER] = { subpageText = 'Emailnotice', onlyFirstLevel = true },
},
},
},
-- 頁面內容判定規則
ContentRules = {
sandbox = {
'%{%{[Ss]andbox',
'%{%{[Tt]emplate[_%s]sandbox[_%s]notice',
'%{%{請注意:請在這行文字底下進行您的測試,請不要刪除或變更這行文字以及這行文字以上的部份。',
'%{%{请注意:请在这行文字底下进行您的测试,请不要删除或变更这行文字以及这行文字以上的部分。',
},
doc = {
'%{%{[Dd]ocumentation[_%s]subpage',
'%{%{[Tt]emplate[_%s]doc[_%s]inline',
'%{%{[Tt]emplate[_%s]doc[_%s]viewed[_%s]directly'
},
testcases = {
'%{%{[Tt]emplate[_%s]testcases[_%s]notice',
'%{%{[Tt]est[_%s]cases[_%s]notice',
'%{%{测试样例',
'%{%{測試樣例'
}
},
-- 頁面類型
Type = {
-- 這裡的頁面類型會連接成後綴 因此en的空白勿刪
style = {
['en'] = ' styles',
['zh-hans'] = '样式',
['zh-hant'] = '樣式'
},
script = {
['en'] = ' scripts',
['zh-hans'] = '脚本',
['zh-hant'] = '工具'
},
json = {
['en'] = ' data',
['zh-hans'] = '数据',
['zh-hant'] = '數據',
['zh-tw'] = '資料'
},
redirect = {
['en'] = ' redirect',
['zh-hans'] = '重定向',
['zh-hant'] = '重新導向'
},
doc = {
['en'] = ' documentation',
['zh-hans'] = '文档',
['zh-hant'] = '文件'
},
sandbox = {
['en'] = ' sandbox',
['zh-hans'] = '沙盒',
['zh-hant'] = '沙盒'
},
testcases = {
['en'] = ' testcases',
['zh-hans'] = '测试样例',
['zh-hant'] = '測試樣例'
},
temp = {
['en'] = ' temporary page',
['zh-hans'] = '临时页',
['zh-hant'] = '臨時頁'
},
intro = {
['en'] = ' introductory page',
['zh-hans'] = '说明页',
['zh-hant'] = '說明頁'
},
-- 這裡的頁面類型會直接替換原本的字串 因此en不需要留空白
external = {
['en'] = 'Interlanguage link',
['zh-hans'] = '跨语言链接',
['zh-hant'] = '跨語言連結'
},
editnotice = {
['en'] = 'editnotice',
['zh-hans'] = '编辑提示',
['zh-hant'] = '編輯提示'
},
-- %u表示用户名,在主模块换成用户链接
mailnotice = {
['en'] = '%u\'s mailnotice',
['zh-hans'] = '%u的电邮提示',
['zh-hant'] = '%u的電郵提示'
},
shortcut = {
['en'] = 'Shortcut of %s',
['zh-hans'] = '%s快捷方式',
['zh-hant'] = '%s捷徑'
},
}
}