“教程:使用模板”的版本间的差异

来自iFx Wiki
跳到导航 跳到搜索
第3行: 第3行:
  
 
=使用模板=
 
=使用模板=
 +
在页面'''源代码'''中的适当位置插入模版代码,用一堆双大括号围住模版名称(无需添加Template:),即可引用模版内容。
 +
 +
 +
 +
 +
<pre>{{ 模版 }}</pre>
 +
 +
在使用可视化编辑器时也可以使用这个按钮添加代码:
 +
 +
 +
[[文件:VizEditorAddTemplate.png|none|baseline|frameless]]
  
在页面'''源代码'''中的适当位置插入模版代码,用一堆双大括号围住模版名称(无需添加Template:),即可引用模版内容。
 
  
<pre>
 
{{ 模版 }}
 
</pre>
 
  
 
==不同的模版格式==
 
==不同的模版格式==
 
 
使用模版时可以添加参数调整模版的内容,例如,使用国家模版时可以使用“国名”指定国家名称。
 
使用模版时可以添加参数调整模版的内容,例如,使用国家模版时可以使用“国名”指定国家名称。
  
 
===无参数===
 
===无参数===
 
 
直接显示模版内容。
 
直接显示模版内容。
  
第21行: 第26行:
 
{{ 这是一个无参数模版 }}
 
{{ 这是一个无参数模版 }}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>{{ 这是一个无参数模版 }}</pre>
 +
  
  
 
===未命名参数===
 
===未命名参数===
 
 
可以向模版中依次传入参数,在不同情况下让模版显示不同内容。
 
可以向模版中依次传入参数,在不同情况下让模版显示不同内容。
 
模版名与参数之间、参数与参数之间,使用竖线隔开。
 
模版名与参数之间、参数与参数之间,使用竖线隔开。
第31行: 第40行:
 
{{ 模版 | 第一个参数 | 第二个参数 }}
 
{{ 模版 | 第一个参数 | 第二个参数 }}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>{{ 模版 | 第一个参数 | 第二个参数 }}</pre>
 +
 +
  
 
===命名参数===
 
===命名参数===
 
 
传入参数时也可以用等号指定特定参数的值,在这种情况下,顺序不会影响最终显示效果。
 
传入参数时也可以用等号指定特定参数的值,在这种情况下,顺序不会影响最终显示效果。
  
第39行: 第53行:
 
{{ 国家信息 | 国名=废狗帝国 | 首都=废狗岛 | 国家格言=从萝莉到萝莉 }}
 
{{ 国家信息 | 国名=废狗帝国 | 首都=废狗岛 | 国家格言=从萝莉到萝莉 }}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>{{ 国家信息 | 国名=废狗帝国 | 首都=废狗岛 | 国家格言=从萝莉到萝莉 }}</pre>
 +
 +
  
 
===参数很多的情况下===
 
===参数很多的情况下===
 
 
可以在模版内换行使源代码更容易阅读。
 
可以在模版内换行使源代码更容易阅读。
  
第51行: 第70行:
 
}}
 
}}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>{{国家信息|国名=废狗帝国|首都=废狗岛|国家格言=从萝莉到萝莉}}</pre>
 +
 +
  
 
==注意事项==
 
==注意事项==
第58行: 第83行:
  
 
==本Wiki中的模板==
 
==本Wiki中的模板==
 
 
=创建模版=
 
=创建模版=
 
 
在模板(Template)名字空间中创建的页面可以自动成为模版。
 
在模板(Template)名字空间中创建的页面可以自动成为模版。
  
第66行: 第89行:
 
Template:国家信息
 
Template:国家信息
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>Template:国家信息</pre>
 +
 +
  
 
==获取参数信息==
 
==获取参数信息==
 
 
可以使用三重大括号在文本中插入参数的值。
 
可以使用三重大括号在文本中插入参数的值。
  
第74行: 第102行:
 
这是上文{{{参数名}}}这是下文
 
这是上文{{{参数名}}}这是下文
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>这是上文{{{参数名}}}这是下文</pre>
 +
 +
  
 
===获取未命名参数===
 
===获取未命名参数===
 
 
可以直接使用数字引用特定位置上的参数。
 
可以直接使用数字引用特定位置上的参数。
  
第82行: 第115行:
 
这是第一个参数: {{{ 1 }}}
 
这是第一个参数: {{{ 1 }}}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>这是第一个参数: {{{ 1 }}}</pre>
 +
  
  
 
===指定参数默认值===
 
===指定参数默认值===
 
 
如果模版使用者没有提供某个参数的值,可以在编写模版的时候指定一个默认值,防止模版出错。
 
如果模版使用者没有提供某个参数的值,可以在编写模版的时候指定一个默认值,防止模版出错。
  
第91行: 第128行:
 
{{{ 当这个参数名没有指定值的时候 | 自动填入这个值 }}}
 
{{{ 当这个参数名没有指定值的时候 | 自动填入这个值 }}}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>{{{ 当这个参数名没有指定值的时候 | 自动填入这个值 }}}</pre>
 +
 +
  
 
==制作规范==
 
==制作规范==
 
 
直接面向作者的模版,例如国家信息、作者信息、提示信息等,请使用中文命名,并使用中文参数名。
 
直接面向作者的模版,例如国家信息、作者信息、提示信息等,请使用中文命名,并使用中文参数名。
  
第99行: 第141行:
 
{{ 国家信息 | 国名=废狗帝国 }}
 
{{ 国家信息 | 国名=废狗帝国 }}
 
</pre>
 
</pre>
 +
 +
 +
 +
<pre>{{ 国家信息 | 国名=废狗帝国 }}</pre>
  
 
便于模板编写者使用而制作的模版,例如信息栏、侧边栏等,请使用英语命名(驼峰式命名规范),并使用英文参数名。
 
便于模板编写者使用而制作的模版,例如信息栏、侧边栏等,请使用英语命名(驼峰式命名规范),并使用英文参数名。
第105行: 第151行:
 
{{ SideBar | title=This Is Title | content=This is content }}
 
{{ SideBar | title=This Is Title | content=This is content }}
 
</pre>
 
</pre>
 +
<pre>{{ SideBar | title=This Is Title | content=This is content }}</pre>
 +
 +
  
 
==注意事项==
 
==注意事项==

2020年11月25日 (三) 16:12的版本

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


使用模板

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



{{ 模版 }}

在使用可视化编辑器时也可以使用这个按钮添加代码:


VizEditorAddTemplate.png


不同的模版格式

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

无参数

直接显示模版内容。

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


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


未命名参数

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

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


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


命名参数

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

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


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


参数很多的情况下

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

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


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


注意事项

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

本Wiki中的模板

创建模版

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

Template:国家信息


Template:国家信息


获取参数信息

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

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


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


获取未命名参数

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

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


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


指定参数默认值

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

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


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


制作规范

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

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


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

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

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


注意事项

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