MediaWiki模板使用教程

MediaWiki提供了功能丰富的模板，支持插入动态内容、来自其他页面的文本等等。MediaWiki模板不像是扩展或媒体文件，它没有集中的存放库，可以是新编写的、也可以是某个已完成的工作，将它从wiki站点（如维基百科）导出，然后导入到目标wiki站点，以节省重复的工作。

一、MediaWiki模板基本用法

模板就是标准的wiki页面，其内容是设计用来嵌入包含（将文件以连结的形式置入）到其他页面中的。模板名称遵循以“Template:”为前置字元的惯例，这会将其指派给对应的命名空间；而且，可以像创建其他任何Wiki页面一样创建模板页面。

To transclude a template, you used double open & close curly brackets {{template name}}.

最简单的模板用法如下：创建一个名为Template:Welcome的页面，内容如下：

好！欢迎来到本wiki。

这样，你就已经创建了你的第一个模板！现在在一个新页面中插入如下代码：

{{Welcome}}

在查看该新页面时，“你好！欢迎来到本wiki。”的文本将代替{{Welcome}}。模板内容被嵌入包含到另一个页面中，也就是，它被结合在页面中。

可以在任何想要欢迎某人的页面上的任何位置插入{{Welcome}}。假设它已被使用在100个页面中，若随后将模板内容更改为：

你好呀！欢迎来到这个奇妙的Wiki。

然后你重新访问任何一个那100个使用该模板的页面，将看到新文本而不是原始文本。在这种方式中，不曾编辑100个页面的内容却已经更改了它们，就是因为该模板已被嵌入包含到这些页面中。

二、调用MediaWiki模板

在维基百科和类似的wiki平台中，模板的调用方式多种多样。以下是几种常见的模板调用方法及其作用：

1、{{模板名称}} — 这种方式会在页面中动态插入名为“模板:模板名称”的页面内容。每次页面被加载时，模板的内容都会被插入到页面中。任何对模板的修改都会反映在所有调用该模板的页面上，同时，这些页面也会被列入“链接到”该模板的列表中。

2、{{subst:模板名称}} — 这种方式会在页面中插入模板“模板:模板名称”的静态副本。在调用模板时，其内容会被复制到页面中，因此之后对模板的更改不会影响已经使用了该副本的页面。与手动输入内容相比，这种方式有一些微妙的不同。

3、{{safesubst:模板名称}} — 这种方式用于当模板包含其他模板或解析器函数调用时，允许递归替换。

4、{{msgnw:模板名称}} — 这种方式会将模板的源代码显示在页面中，类似于 <nowiki> 标签。例如，{{msgnw:Template:Thankyou}} 会显示：

<noinclude> <languages/> </noinclude>
'''感谢你！''' 感谢{{{reason|{{{1}}}}}}。 祝好，{{{signature|{{{2}}}}}}敬上。
<noinclude> [[Category:Template examples{{#translation:}}|{{PAGENAME}}]] </noinclude>

普通页面也可以用作模板，只需指定其所在的命名空间即可：

{{模板:页面名称}} — 嵌入包含标题为“模板:页面名称”的页面内容（等同于 {{页面名称}}）；
{{讨论:页面名称}} — 嵌入包含标题为“讨论:页面名称”的页面内容；
{{:页面名称}} — 嵌入包含标题为“页面名称”的页面内容（例如，在主命名空间）；
{{subst::页面名称}} — 替换为标题为“页面名称”的内容。

若指定的命名空间不存在，则完整标题会被假定为一个模板。例如，{{Foo:Bar}} 会嵌入 Template:Foo:Bar。模板名称也可以相对当前页面生成。例如，如果在页面 foo 上使用 {{/bar}}，则会插入页面 foo/bar 的内容。另外模板调用还可以动态生成。例如，{{ {{foo}} }} 会调用 Template:foo，并将其结果解释为另一个模板的名称进行调用。

三、从一个Wiki复制模板到另一个Wiki

要从一个Wiki复制模板到另一个Wiki，可以按照以下步骤操作：

1、有导入权限的情况

在源Wiki的“Special:Export”页面，下载包含所需模板历史的.xml文件：
输入模板名，如“Template:Welcome”，注意大小写和特殊字符；
选择“包含模板”并“仅包含当前修订”；
点击“导出”；
在目标Wiki的“Special:Import”页面，上传.xml文件。

2、无导入权限的情况

前往源Wiki的模板页面，复制全部维基文本；
在目标Wiki中创建同名模板页面，粘贴刚才的维基文本，并在编辑摘要中注明出处；
检查源Wiki的模板依赖，重复上述步骤，确保所有相关模板都被复制。

3、后续调整

个性化编辑以适配新Wiki，比如更新Logo、删除冗余分类和修正红色链接。请注意文档子页面不会被导出，因此需手动处理引用页面中的红色链接。

四、编辑MediaWiki模板

1、插入新模板

要将模板添加到页面，请将光标放在页面上要插入模板的位置。然后打开插入菜单并选择“ 模板”。或者，键入两个大括号{{以打开同一个对话框。

输入模板的名称或相关关键字，找到你需要插入的模板。下拉框中将会显示在名称或描述中包含搜索项的结果。这应该能帮助你找到相关的模板，即使你还不知道其准确名称。

如果使用关键字找不到这一类模板，你可以查看wiki上拥有类似内容的其他页面，并阅读或编辑页面源代码以查看使用了哪些模板。找到需要的名称的模板后，可以将其输入到此字段中以插入。

还可以编辑页面上已有的模板。当选择要编辑的模板时，它会变成蓝色，并且会出现一个显示“ 模板”的框。然后选择“编辑”链接或双击模板本身以打开模板。

有些模板在阅读时不可见。在可视化编辑器中，此类隐藏模板仍会显示，以便可以单击并编辑或删除它们。模板名称将显示在拼图图标旁边，并且两者都将灰显。

2、模板参数

当添加新模板或编辑已安好的模板时，会看到此对话框。在框中看到的内容取决于相关模板是否包含TemplateData，这是其他编辑器添加的有用元数据，以便更轻松地在可视化编辑器中编辑模板。

当模板包含TemplateData时，可视化编辑器可以使用它来呈现带注释的字段供填写。对于具有某些社区提供的TemplateData的模板，可视化编辑器显示命名参数的列表，通常还有说明和说明，解释每个参数值的含义和所需格式。

你可以禁用任何可选的参数（左侧有蓝色的复选框）。如果参数的复选框是灰色的不可点击，那么这个参数是模板必需的，无法禁用。

插入新的模板时，你会发现有些可选的参数已经选好了。这意味着模板的作者建议使用这些参数。最好检查你在模板内使用的所有参数以确保你能够了解其用途。点击未选中的参数以将其添加到模板。点击已添加的参数会将会把你带到参数的输入框中。

医学模板参数会显示为“已弃用”。插入模板时，不要使用已弃用的参数，这些参数可见只是因为在旧的页面使用。

3、添加未记录的参数

如果要插入或编辑的模板的作者未在TemplateData中布置其参数，这种参数我们称为“未记录”或“未命名参数”。在这些情况下，应该查阅模板本身的页面。在那里可以学习如何正确使用和使用模板的所有参数。这包括学习模板作者编写的参数的确切名称。

如果在文档中发现模板需要没有名称的参数，请使用未记录的参数输入填充数字作为参数名称的占位符，然后像往常一样在要提供的值旁边添加。

示例：

第一个未命名参数：“1”
第一个未命名参数的值：“en_US”
第二个未命名参数：“2”
第二个未命名参数的值：“是”

如果不小心包含了不存在、拼写错误或错误的参数，为这些参数输入的值将不会显示在正在编辑的页面上。

4、自动生成的参数

在此示例中，所讨论的模板缺少TemplateData，但可以自动生成参数。这意味着已经为添加了未记录的参数，但名称可能不容易理解，并且对话框无法显示任何说明或说明。因此，对话框提供了指向模板文档的链接，它应该可以帮助推断和填写模板的各种参数。

5、编辑多部分模板内容

在编辑期间，可以打开由多个模板或链接到某个维基文本的单个模板组成的模板内容。这与下面描述的嵌套模板不同。在这种情况下，模板被更好地可视化为堆栈或连接。
此内容通常包含“不平衡的模板”，这些模板本身并不完整，需要与某些wikitext或其他模板配对才能发挥作用。

模板内容相关的各部分必须通过维基文本创建，但是可以在可视化编辑器中编辑。此时你会在对话框顶部看到一条消息，指示了这种情况，侧边栏底部会看到一个特殊化的工具栏，在那里你可以使用图标按钮添加额外参数、额外的维基文本、删除元素或改变顺序。

6、嵌套模板

模板可以包括其他模板作为参数值。当看到一个参数的值包含表示模板的双花括号 ( {{ }} ) 时，就会认出它。可视化编辑器无法使用编辑器易于使用的界面在模板（嵌套模板）中呈现此模板，因此如果想自己嵌套模板，则需要了解如何手动添加模板wikitext到适当的参数字段。

7、完成编辑

完成模板编辑后，可以单击“应用更改”。然后可以预览编辑并确保它看起来像想要和期望的那样。可能还会看到一条错误消息，该消息（与上面提到的其他TemplateData一样）是社区提供的内容，其用途可能有所不同。可能需要查阅模板自己的文档才能找到一些错误的根源。如果仍然遇到问题，请考虑在模板的讨论页上发布问题。