帮助:模板

来自Rizline中文维基

编写Rizline中文维基时,我们几乎不可避免使用模板。模板是一类特殊的页面,用于嵌入或替换引用进其他的页面,以加入一些事先编写好的内容,或者信息栏、导航栏等。

模板的特点

模板包括以下几个特点:

  • 模板调用简单,添加{{模板名}}即可调用模板内容到当前页面。
    • 仅需修改模板,调用模板的页面会自动更新修改。
  • 模板可以隐藏大量重复使用的代码,提高代码可读性。
  • 模板可以接受参数,提供一定范围内的自定义效果。
    • 如果模板允许,你可以在它的参数中使用其他模板。

模板标签

{{模板名}}叫做模板标签,用途是将名为[[模板:模板名]]的模板加入页面中。如果一个页面不是以“模板:”开头,则不属于模板,但也可以使用模板标签。

模板的参数

模板的参数有两种:

  • 命名参数,参数名为{{{参数名}}}
  • 匿名参数,参数名默认为{{{1}}}{{{2}}}等。

在调用带参数的模板的时候:

  • 对于命名参数,即诸如{{{参数1}}}{{{参数2}}}形式的参数,调用时使用{{模板名|参数1=参数1的值|参数2=参数2的值}}这样的格式;
  • 对于匿名参数,即诸如{{{1}}}{{{2}}}形式的参数,调用时使用{{模板名|参数1的赋值|参数2的赋值}}

含有命名参数的模板

现在假设我们创建了[[模板:姓名]],内容为:

我是{{{姓}}}{{{名}}}。

如果用{{姓名}}调用这个模板,不写任何参数,我们会得到:

我是{{{姓}}}{{{名}}}。

如果用{{姓名|姓=张|名=飞}}调用,我们会得到:

我是张飞。

含有编号参数的模板

现在假设我们创建了[[模板:数数]],内容为:

一二三{{{1|四五六}}}七八九

如果用{{数数|六五四}}调用,我们会得到:

一二三六五四七八九

如果传递一个空值,用{{数数|}}调用,我们会得到:

一二三七八九

如果用{{数数}}调用,我们会得到:

一二三四五六七八九