教程:使用模板

来自iFx Wiki
跳到导航 跳到搜索

模板(Template)是MediaWiki提供的自动替换功能。将常用内容定义为模版后,可以在条目中引用。使用模版有利于维护条目内容,如果需要更改模版的内容,只需在模版页中更改,就能显示在所有引用该模版的页面中。


使用模板

在页面源代码中的适当位置插入模版代码,用一堆双大括号围住模版名称(无需添加Template:),即可引用模版内容。

{{ 模版 }}


使用可视化编辑器时也可以用这个按钮输入上述代码:

VizEditorAddTemplate.png

不同的模版格式

使用模版时可以添加参数调整模版的内容,例如,使用国家模版时可以使用“国名”指定国家名称。

无参数

直接显示模版内容。

{{ 这是一个无参数模版 }}


未命名参数

可以向模版中依次传入参数,在不同情况下让模版显示不同内容。 模版名与参数之间、参数与参数之间,使用竖线隔开。

{{ 模版 | 第一个参数 | 第二个参数 }}

命名参数

传入参数时也可以用等号指定特定参数的值,在这种情况下,顺序不会影响最终显示效果。

{{ 国家信息 | 国名=废狗帝国 | 首都=废狗岛 | 国家格言=从萝莉到萝莉 }}

参数很多的情况下

可以在模版内换行使源代码更容易阅读。

{{国家信息
|国名=废狗帝国
|首都=废狗岛
|国家格言=从萝莉到萝莉
}}

注意事项

  • 大括号、竖线和等于号必须使用半角符号(英语标点),使用中文标点会导致模版格式错误。中英文标点中的竖线很容易混淆,如果使用模版时格式总是出错,可以尝试把所有竖线都修改一下。
  • 本页面中的例子仅用于说明模版使用方法,不代表实际的模版参数。

本Wiki中的模板

参见: 教程:模版索引

创建模版

在模板(Template)名字空间中创建的页面可以自动成为模版。

Template:国家信息

获取参数信息

可以使用三重大括号在文本中插入参数的值。

这是上文{{{参数名}}}这是下文

获取未命名参数

可以直接使用数字引用特定位置上的参数。

这是第一个参数: {{{ 1 }}}


指定参数默认值

如果模版使用者没有提供某个参数的值,可以在编写模版的时候指定一个默认值,防止模版出错。

{{{ 当这个参数名没有指定值的时候 | 自动填入这个值 }}}

制作规范

直接面向作者的模版,例如国家信息、作者信息、提示信息等,请使用中文命名,并使用中文参数名。

{{ 国家信息 | 国名=废狗帝国 }}

便于模板编写者使用而制作的模版,例如信息栏、侧边栏等,请使用英语命名(驼峰式命名规范),并使用英文参数名。

{{ SideBar | title=This Is Title | content=This is content }}

注意事项

  • �MediaWiki中模板的命名空间为“模板”,但容易误打成“模版”,实际创建的时候可以使用英文"Template"避免放错名字空间。
  • 模板中可以使用HTML标签,但部分标签和属性可能无法正常使用。
  • 建议尽量使用命名参数。