Help:模板：修订间差异

{{mbox|text=本页是关于模板用法的帮助页面。关于求闻百科对模板的使用标准，请参见[[Qiuwen:格式手册/模板]]。}}

在维基文本中，嵌入一个模板的基本语法是{{tlx|-{}-模板名称|参数}}。参数可以有多个，也可以没有。模板名称就是模板页面的名称，通常不含命名空间。例如。{{tlc|colorbox|green}}调用的模板页面就是[[Template:Colorbox]]。

一般地，在任何页面，使用<code><nowiki>{{</nowiki>-{}-''名称''<nowiki>}}</nowiki></code>即可'''嵌入包含'''（{{lang-en|transclude}}）该名称的模板，该模板对应页面“Template:''名称''”。如果该模板页面内容被改变，那么嵌入包含了该模板的页面中相应的内容也将改变。

非模板命名空间的页面也可以被嵌入包含。在嵌入包含页面时，可以指定命名空间，主命名空间页面可以在''名称''前加上一个“:”。例如，{{tlx|:-{}-上海轨道交通7号线}}将会嵌入包含名为“上海轨道交通7号线”而非“Template:上海轨道交通7号线”的页面。如果是使用不存在的命名空间，则仍会补上“Template:”前缀，例如，{{tlx|AABBCC:-{}-test}}将会嵌入包含名为“Template:AABBCC:test”的页面，而{{tlx|:AABBCC:-{}-test}}则会嵌入包含名为“AABBCC:test”的主命名空间页面。

那么，在其他页面，嵌入此模板时就需要提供参数。比如，{{tlx|-{}-欢迎|Steve|Minecraft}}就可以得到“Steve，您好，欢迎来到Minecraft！”。

从上面的模板代码中不难看出，三层花括号中的数字表示第几个参数，例如{{nowiki|(((1)))}}就是第一个参数，在这次调用时，它被文本“Steve”取代，{{nowiki|(((2)))}}则是代表第二个参数。

通常来说，编号参数是不指定名称的，因为系统很清楚每个参数是第几个参数。但是，你也可以为每个参数指定名称，即“<code>-{}-名称=值</code>”的形式。例如，<code>-{}-<nowiki>{{</nowiki>''模板名称''<nowiki>|a|b|c}}</nowiki></code>实际上也就相当于<code>-{}-<nowiki>{{</nowiki>''模板名称''|'''1='''a|'''2='''b|'''3='''c<nowiki>}}</nowiki></code>。当参数名称被明确指定时，参数的赋值顺序就不再重要。例如，<code>-{}-<nowiki>{{</nowiki>''模板名称''|'''1='''a|'''2='''b|'''3='''c<nowiki>}}</nowiki></code>和<code>-{}-<nowiki>{{</nowiki>''模板名称''|'''1='''a|'''3='''c|'''2='''b<nowiki>}}</nowiki></code>是同一个意思，尽管c排在了b的后面，但调用时很明确地指定了c是第3个参数，而b是第二个参数。

编号的参数隐式赋值时有一个限制，就是'''内容不能包含等号'''，否则会被识别为命名参数。例如，设想被欢迎的人的名字叫做“x+y=z”，嵌入<code><nowiki>{{</nowiki>-{}-欢迎<nowiki>|x+y=z|求闻百科}}</nowiki></code>并不会得到“x+y=z，您好，欢迎来到求闻百科！”，因为这样的模板调用中，会将<code>x+y=z</code>理解为：名称为“x+y”的参数值为“z”，而非第一个参数的值为“x+y=z”。这种情况下，可以通过以下方法解决：

* 明确指定参数名称，如<code><nowiki>{{</nowiki>-{}-欢迎|'''1='''x+y=z<nowiki>}}</nowiki></code>。

* 使用nowiki包裹等号，如<code><nowiki>{{</nowiki>-{}-欢迎|x+y&lt;nowiki>=&lt;/nowiki>z<nowiki>}}</nowiki></code>。

上面的第二种方法也适用于参数的值中含有管道符<code>|</code>的情形，假如你需要将<code>|</code>用作参数值的内容，而不是将其用来分隔参数，则可以用nowiki标签。

此外，与明确指定参数名称相比，隐式的参数名称赋值还有一个特点就是，'''隐式的赋值保留首尾空格'''。当指定参数名称赋值时，如果参数值的两端有空格，这些空格就会被移除。比如，{{tlx|-{}-欢迎| User | 求 闻 百 科 }}将会得到“ User ，您好，欢迎来到 求 闻 百 科 ！”，所有的空格都被保留了。而{{tlx|-{}-欢迎|1= User | 求 闻 百 科 }}将会得到“User，您好，欢迎来到求 闻 百 科！”，每个参数两端的空格都被自动删除。

* {{tlx|-{}-欢迎|username=Example1|sitename=萌娘百科}}会产生：

** Example1，您好，欢迎来到萌娘百科！

* {{tlx|-{}-欢迎|username=Example2|sitename=Minecraft Wiki}}会产生：

** Example2，您好，欢迎来到Minecraft Wiki！

由于命名参数在赋值时必须指定名称，因此不会存在参数值被等号打断的问题，参数值的首尾空格也将自动被截去。

嵌入模板时，如果某个参数（无论是位次参数还是命名参数）被定义了但没有提供值，则解析模板时使用该参数的默认值，如果默认值不存在，则不处理参数。

另外，参数的默认值也可以设为空字符串，然后使用[[Help:解析器函数|解析器函数]]进行处理。这里，将“欢迎”模板再进行一些增强：如果username没有指定，或者为空，则不显示username，“您好”一词之前也没有显示逗号；如果sitename没有指定，或者为空，则显示为“滚动的天空Wiki”。代码如下：

你可能已经注意到了，在这个例子中，“完全不提供参数”与“提供空的参数值”是等价的，因为参数的默认值就是空字符串。如果你确实需要区分“完全不提供参数”与“提供空的参数值”，则多次使用统一参数并提供不同默认值，然后比较二者是否相等，如：

模板默认值可以用来达到参数'''别称（alias）'''的效果。例如，{{nowiki|(((username!(((用户名!(((用戶名!(((使用者名稱!))))))))))))}}。但是，一般不建议使用参数别称。

替换引用是指保存页面时，那么使用该模板的页面被保存时，相关代码就会被替换为模板的内容。替换引用有三种形式：

'''嵌入包含（transclusion）'''是指在页面中显示另一个页面（通常是模板）的内容。假如，A页面中有代码{{tlx|B}}，则页面“A”嵌入包含了“Template:B”，页面A称为目标页，页面B称为来源页。

{{nowiki|<tag:noinclude>}}、{{nowiki|<tag:includeonly>}}和{{nowiki|<tag:onlyinclude>}}可以用来控制哪些内容被嵌入包含。

* {{tag|noinclude}}内的部分，在源页面自身会显示，但是在目标页面被嵌入包含时不会显示。

* {{tag|includeonly}}内的部分，在源页面自身不会显示，但是在目标页面被嵌入包含时会显示。

* {{tag|onlyinclude}}若存在，则该标签以外的部分在目标页面被嵌入包含时都不会显示，且其外部的{{tag|includeonly}}将会无效。

{{mbox|text=

你应该会注意到，模板在嵌入包含文档时会充分利用此代码。模板代码中，往往会出现{{tag|noinclude|content=<nowiki>{{doc}}</nowiki>|highlight=1}}，这样在模板页面自身会出现模板文档，但是嵌入包含该模板时，不会将整个文档嵌入包含进去。类似的，文档中的模板[[Help:分类|分类]]链接也会被{{tag|includeonly|highlight=1}}包含，这样文档自身不会加入分类，但当模板嵌入包含该文档时，则会将模板加入这些分类。

}}

[[Category:求闻百科帮助]]