Help:命名空间
注意:當您編輯本頁面時,即同意以CC0協議授權您的貢獻。您可以在公有領域帮助页面找到更多信息。 |
在 MediaWiki 维基中,所有的页面都分组存放在称为“命名空间(namespaces)”的各个集合中,从而使各个页面在一个较高的层次并以用途为依据区别开来。某些命名空间中的页面还具有一些特殊属性,或在与其他页面交互时具有不同的行为。
命名空间在页面标题中以命名空间:
前缀表示。所以,本页标题(Help:Namespaces/zh
)中的前缀Help:
就表示这个页面位于Help
命名空间中。每个命名空间都由一个数字和一个名字标识,这个名字是可以翻译的,也可以有多个别名。
没有前缀的页面位于主空间中。注意,冒号和前缀也可能并不表示一个命名空间:页面Foo:Namespaces/zh
实际上位于主空间中,这是因为“Foo”这个命名空间并不存在。类似地,页面Help:Foo:Namespaces/zh
位于“Help”命名空间中。
标准命名空间
标准安装的 MediaWiki 具有 16 个命名空间可用于存放用户生成的内容。此外,还有两个特殊的命名空间,它们包含 MediaWiki 软件自动创建的页面。标准命名空间成对组织,每一对都包含一个“主题空间”和一个“讨论空间。”命名空间从 0 开始编号,因此,所有的主题空间都是偶数索引,所有的讨论空间都是奇数索引。
媒体
这个命名空间是一个别名,用来直接链接到媒体文件:[[Media:MediaWiki-2020-logo.svg]]
将直接链接到图片本身,而不是像[[:File:MediaWiki-2020-logo.svg]]
那样链接到图片描述页面。
特殊
这个命名空间集合了所有 特殊页面,其中的报告和界面均由 MediaWiki 动态生成并且不能直接编辑。除非修改或扩展 MediaWiki 软件外,否则无法在这个命名空间中创建页面。
(主)
这个命名空间没有冒号分隔的前缀。它通常被称为“主名字空间”或“主空间”。此命名空间通常包含了 wiki 中大量的内容页面 。一般情况下,这个命名空间没有特殊属性。
讨论
“Talk”命名空间是主空间附属的讨论空间,没有特殊属性。
用户
每一位用户在“User”命名空间中都有一个对应的页面。只要用户身份被确认,编辑历史、监视列表及最近修改等,就都会链接至此。
用户可以在这个页面及其子页面中记录关于他们自己的信息,或是用来测试和起草新内容。
User:用户名/Foo.js
或User:用户名/Foo.css
形式的页面只能被用户自己或界面管理员(或MediaWiki 1.32之前的管理員)编辑。
用户讨论
这个命名空间是与“User”相关联的讨论空间。
这个命名空间中的页面主要是用来给特定的用户留言,或通知他们感兴趣的讨论内容。
当一个User talk:UserName
页面被编辑后,只要用户“用户名”加载任意一个页面,就会在页面顶端显示一条通知消息:
这条消息将持续可见,直至用户打开了他的讨论页面去阅读消息。
维基管理员技巧: 像是Echo 的擴充功能可能會覆蓋此行為。
项目
这个命名空间通常用来存放与 wiki 运营和开发相关的“元讨论”内容。 它会自动重定向到以Wiki名称命名的一个命名空间下,示例: [[Project:Licenses]] → [[Wikipedia:Licenses]].
Because this namespace's name changes from wiki to wiki, you may want to simply look at the 5th entry in any dropdown containing a list of all namespaces. The project namespace will be listed immediately after the User talk namespace. On some wiki farms, the name "Meta" may be used for this namespace.
项目讨论
这个命名空间通常用来存放相关主题页面的讨论内容,没有特殊属性。
文件
“File”命名空间保存了可通过“Media”命名空间访问的图像、视频、声音文件以及其它媒体文件的元信息。每个文件在“File”命名空间中都有一个对应的页面,通常存放着许可证信息。如果直接链接到这个命名空间中的页面,而非内联于其中的媒体文件,就会得到右边的图片:[[File:MediaWiki-2020-logo.svg|right]]
。关于此链接语法的更多细节,可参考:Help:图片 。
如果要创建一个到文件页面的内部链接,你需要在命名空间之前加一个冒号:[[:File:MediaWiki-2020-logo.svg|right]]
,效果为:File:MediaWiki-2020-logo.svg。
在 MediaWiki 标准安装中,“File”命名空间具有别名“Image” - 参考命名空间别名。
要绕过描述页直接链接到媒体文件,请参阅媒体命名空间。
文件讨论
这是一个讨论空间,通常用来讨论与媒体文件相关的内容,没有特殊属性。
MediaWiki
“MediaWiki”命名空间用来保存系统消息和其它重要内容。
例如,页面MediaWiki:Edit(或默认“Vector”皮肤中的MediaWiki:Vector-view-edit页面)就包含了每个页面顶部“编辑”选项卡中的文本。
如果这个页面存在的话,它将取代默认文字“Edit。”类似地,MediaWiki:Common.css页面中保存了将用于所有页面的层叠样式表的代码。
这个命名空间具有特殊属性,只有拥有(editinterface)
权限的用户可以编辑。
自MediaWiki 1.32起,JavaScript和CSS頁面同時需要editinterface
和(分別)editsitejs
或editsitecss
權限才能修改。
MediaWiki讨论
这是一个讨论空间,通常用来讨论与关联的系统消息相关的内容,没有特殊属性。
模板
“Template”命名空间用来保存模板——一段可以嵌入到其它页面中的文本或 wiki 代码。因此它具有特殊属性——它是嵌入调用发生时所使用的默认命名空间:wiki 代码{{Foo}}
与{{Template:Foo}}
是等价的。
模板讨论
这个讨论空间通常用来进行相关模板页面的讨论,没有特殊属性。
帮助
“Help”命名空间通常用来保存帮助文件、指引或“如何...”之类的指南页面,没有特殊属性。 請參見Help命名空间內容。
帮助讨论
这个讨论空间通常用来进行相关帮助页面的讨论,没有特殊属性。
分类
“Category”命名空间中包含分类——也就是其它页面的动态列表。
直接链接到一个分类页面并不会产生一个内部链接,而是将当前页面包含至相关的分类页面中。
因此,代码[[Category:Help]]
将在页面底部(位于底部被标记为“分类”的文本框中)产生一个分类链接。
单击链接可以跳转到分类页面,并且,当前页面将出现在其中的页面列表中。
如果要创建一个到分类页面的内部链接,你需要在命名空间之前加一个冒号:[[:Category:Help]]
,效果为:Category:Help。
关于分类页面链接的语法,请参见Help:分类 。
分类讨论
这个讨论空间通常用来进行相关分类页面的讨论,没有特殊属性。
本地化
命名空间名称和别名可被开发人员本地化。 要请求本地化命名空间,请在Phabricator提交MediaWiki国际化任务。 在任务描述中,您应该提供右侧表格中,所有命名空间的翻译,以及任何您wiki上的额外命名空间(例如“Module”或“Gadget”)。
如果站点的语言是中文,那么只有当内容已被转换且没有添加 __NOTITLECONVERT__
或 __NOTC__
魔术字时,命名空间的名称才会被翻译。
重命名命名空间
数字 | 规范名称 | 本地化名称 |
---|---|---|
-2 | Media | 媒体 |
-1 | Special | 特殊 |
0 | (Main) | |
1 | Talk | 讨论 |
2 | User | 用户 |
3 | User talk | 用户讨论 |
4 | Project | 项目 |
5 | Project talk | 项目讨论 |
6 | File | 文件 |
7 | File talk | 文件讨论 |
8 | MediaWiki | MediaWiki |
9 | MediaWiki talk | MediaWiki讨论 |
10 | Template | 模板 |
11 | Template talk | 模板讨论 |
12 | Help | 帮助 |
13 | Help talk | 帮助讨论 |
14 | Category | 分类 |
15 | Category talk | 分类讨论 |
命名空间的名称可被翻译为英语之外的其它语言,并且 wiki 系统管理员可以重命名某些命名空间(使用命名空间管理器)。 这些名称也就是所谓的命名空间的“本地化”名称。 但所有的命名空间都有一个“规范名称(canonical name)”,这个原始英文名可在所有的 MediaWiki 安装中使用。 因此,链接 User:Foo 总是指向用户 foo 的用户页面,无论当前 wiki 所使用的语言是法语(本地化名称应为Utilisateur:Foo)、俄语(Участник:Foo)还是印地语(सदस्य:Foo)。
右侧的表格中列出了命名空间的规范名称,以及其在本 wiki 上所对应的本地化名称。
命名空间别名
在某些 wiki 中,命名空间还具有别名(aliases):这些额外的名称也将被解析为本地化名称。 例如,某个 wiki 可能将“T”定义为 Template 的别名,因此输入 T:Foo 与 Template:Foo 将是等价的,这可以节省几个字符和一点时间。 一个实际的用例是英文维基百科,它将“WP”定义为 Project 的别名,亦即命名空间“Wikipedia”。
默认情况下,“Image”是 File 的别名,因此[[Image:MediaWiki-2020-logo.svg]]
与[[File:MediaWiki-2020-logo.svg]]
是等价的。
自定义命名空间
- 参见手册:使用自定义命名空间 以获取更多信息。
有些 wiki 用户希望可以在标准命名空间之外组织他们的内容。这可以通过在 wiki 中定义额外的命名空间来实现。这些命名空间与正常的命名空间没有任何区别,并且通常采用大于等于 100 的索引值。这些自定义的命名空间一般没有特殊属性。
辨识命名空间
有若干种方法可用来识别某个页面所属的命名空间:
- 魔术字
魔术字{{NAMESPACE}}
返回页面所在的命名空间的值。
要引用另一个命名空间,请使用{{ns:<name>}}
(例如{{ns:Project}}
),或{{SUBJECTSPACE}}
/ {{TALKSPACE}}
以引用命名空间与当前的配对。
- JavaScript
JavaScript变量wgCanonicalNamespace
记录了命名空间的完整名称。
变量wgNamespaceNumber
则记录了命名空间的索引序数。
- CSS
页面 HTML 代码中的<body>
标记具有两个根据命名空间不同而不同的 CSS 类:一个是ns-#
,其中的 # 是命名空间的索引;另一个是ns-XXX
,其中的 XXX 在所有位于主题空间 的页面中为“subject
”,在所有位于 Special 命名空间的页面中为“special
”,在所有位于讨论空间 的页面中为“talk
”。
下面的 CSS 代码就可以根据对象所处命名空间的不同而改变它的外观:
.ns-subject a { /* 使主题页面上的大多数链接显示为绿色。 */
color: #0f0;
}
.ns-talk a { /* 让讨论页中的链接显示为蓝色。 */
color: #00f;
}
.ns-3 a { /* 使用户讨论页中的链接显示为红色。 */
color: #f00;
}
您可以在搜索结果页面“高级”标签中,或是从任何“最近更改”页面(例如贡献或监视列表)的选项框中的下拉列表获取MediaWiki安装副本中所有命名空间名称的完整列表。 对于每个命名空间的系统属性,使用MediaWiki API 即可:
- API