帮助:模板
维基百科,自由的 encyclopedia
模板(英语:Template)是维基百科的系统中的一项功能,类似于计算机语言中的子程序。本文提供在MediaWiki创建模板的技术指南;维基百科使用MediaWiki并对模板有一定的规范。另外也可参考:
- 模板扩展语法:Help:解析器函数
- 模板分类:Category:维基百科模板和Wikipedia:模板消息
- 模板命名空间的帮助信息:Wikipedia:模板命名空间
- 模板索引:所有模板
什么是模板,为什么要用模板
本页为操作指南,用于介绍中文维基百科社群的一些实现和操作方式。 本文只是论述,不属于方针或指引。如果本指南与方针或指引起冲突或不一致,请以方针或指引的条文为准。 |
模板是您在条目的上方看到各种各样的条条框框,比如“本条目需要清理”、“本条目应避免有陈列杂项、琐碎资料的部分。”等。有时候条目右侧也能看到一个灰色的框,里面写着有关这个条目的基本信息,比如一位艺人的“生日”、“出生地”、“国籍”等。条目最下方有时候也会见到一个大方框,里面陈列着和这个条目相关的内容(称为“导航模板”,比如这个)。这些都是“模板”。模板的形式还有很多很多,有的是直接镶嵌在条目正文里面的,有的虽然看不到但是却依然影响到条目显示的内容(比如字词转换模板)。但是如果你翻阅这些条目的源代码,就会发现这些模板都长成类似“{{模板名字|模板参数}}
”这样子,用一对双大括号将模板的内容扩起来。
为什么会有这些模板?有时候,一段内容会在多个条目中反复出现,这时候如果一遍一遍复制那些内容,一遍遍粘贴到各个条目里面可能不太方便,而且大段大段的对阅读也有影响;而且,万一日后内容有变动,又要进到各个条目里面把这些内容一个个全改一遍,这会产生大量的重复劳动。模板就是为了这样的目的:只需要给重复的部分放到一个模板里、起个名字,以后需要用到这些内容的时候直接调用模板就行了。需要更改内容的时候,也只需要在模板里改动,那些调用了模板的条目也会随着模板自动变更,增加了工作效率。
所有的模板都会放在一个叫“Template”的命名空间,即“模板命名空间”,标题名称是“Template:模板名字
”、“模板:模板名字
”这样。在写作条目时,只需要在合适的位置放上“{{模板名字}}
”,模板就会在合适的地方显示出来了。有时候对于同一个模板,虽然显示的内容稍有差异,但大体的框架是一致的,这个时候就会用到“模板参数”,即“{{模板名字|模板参数}}
”的形式,具体的用法请见下文。
需要注意的一点是,维基百科的系统——MediaWiki本身并不会自动为条目挂上模板。因此,当看到条目里面显示了“本条目需要补充更多来源”等文字时,是其他维基人人工将模板挂上去。在模板所述问题修正之后,可以自行将模板从源代码中删除,这段提示文字将自动消失。
调用模板
调用模板就是把模板内容嵌入到调用方页面。
在Template命名空间里的页面才是模板,所以模板都由Template:开头,在中文维基,以模板:开头同样有效。调用时必须使用模板标签,即{{Template:模板名}}的形式,“Template:”可以在无歧义的情况下省略。如Template:tc是一个模板,内容为“in”。如果把{{tc}}
加入某个页面,则{{tc}}的内容会在此页面显示,即{{tlc|...}}
。
如果“Template:模板名”不存在,{{模板名}}
的作用就与[[Template:模板名]]
相同,提供一个连接到不存在页面的链接:Template:模板名。
模板可以被重定向。例如Template:请求来源被重定向到Template:Citation needed,所以{{请求来源}}效果等同于{{Citation needed}}。有时移动模板并创建重定向后,原调用重定向的页面可能会出错,只要过一段时间(几小时)等服务器刷新缓存即可。