“教程:使用模板”的版本间的差异
跳到导航
跳到搜索
标签:撤销 |
|||
第3行: | 第3行: | ||
=使用模板= | =使用模板= | ||
+ | |||
在页面'''源代码'''中的适当位置插入模版代码,用一堆双大括号围住模版名称(无需添加Template:),即可引用模版内容。 | 在页面'''源代码'''中的适当位置插入模版代码,用一堆双大括号围住模版名称(无需添加Template:),即可引用模版内容。 | ||
+ | <pre> | ||
+ | {{ 模版 }} | ||
+ | </pre> | ||
+ | ==不同的模版格式== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
使用模版时可以添加参数调整模版的内容,例如,使用国家模版时可以使用“国名”指定国家名称。 | 使用模版时可以添加参数调整模版的内容,例如,使用国家模版时可以使用“国名”指定国家名称。 | ||
===无参数=== | ===无参数=== | ||
+ | |||
直接显示模版内容。 | 直接显示模版内容。 | ||
第28行: | 第23行: | ||
+ | ===未命名参数=== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
可以向模版中依次传入参数,在不同情况下让模版显示不同内容。 | 可以向模版中依次传入参数,在不同情况下让模版显示不同内容。 | ||
模版名与参数之间、参数与参数之间,使用竖线隔开。 | 模版名与参数之间、参数与参数之间,使用竖线隔开。 | ||
第41行: | 第32行: | ||
</pre> | </pre> | ||
+ | ===命名参数=== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
传入参数时也可以用等号指定特定参数的值,在这种情况下,顺序不会影响最终显示效果。 | 传入参数时也可以用等号指定特定参数的值,在这种情况下,顺序不会影响最终显示效果。 | ||
第54行: | 第40行: | ||
</pre> | </pre> | ||
+ | ===参数很多的情况下=== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
可以在模版内换行使源代码更容易阅读。 | 可以在模版内换行使源代码更容易阅读。 | ||
第70行: | 第51行: | ||
}} | }} | ||
</pre> | </pre> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==注意事项== | ==注意事项== | ||
第83行: | 第58行: | ||
==本Wiki中的模板== | ==本Wiki中的模板== | ||
+ | |||
=创建模版= | =创建模版= | ||
+ | |||
在模板(Template)名字空间中创建的页面可以自动成为模版。 | 在模板(Template)名字空间中创建的页面可以自动成为模版。 | ||
第90行: | 第67行: | ||
</pre> | </pre> | ||
+ | ==获取参数信息== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
可以使用三重大括号在文本中插入参数的值。 | 可以使用三重大括号在文本中插入参数的值。 | ||
第103行: | 第75行: | ||
</pre> | </pre> | ||
+ | ===获取未命名参数=== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
可以直接使用数字引用特定位置上的参数。 | 可以直接使用数字引用特定位置上的参数。 | ||
第117行: | 第84行: | ||
+ | ===指定参数默认值=== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
如果模版使用者没有提供某个参数的值,可以在编写模版的时候指定一个默认值,防止模版出错。 | 如果模版使用者没有提供某个参数的值,可以在编写模版的时候指定一个默认值,防止模版出错。 | ||
第129行: | 第92行: | ||
</pre> | </pre> | ||
+ | ==制作规范== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
直接面向作者的模版,例如国家信息、作者信息、提示信息等,请使用中文命名,并使用中文参数名。 | 直接面向作者的模版,例如国家信息、作者信息、提示信息等,请使用中文命名,并使用中文参数名。 | ||
第141行: | 第99行: | ||
{{ 国家信息 | 国名=废狗帝国 }} | {{ 国家信息 | 国名=废狗帝国 }} | ||
</pre> | </pre> | ||
− | |||
− | |||
− | |||
− | |||
便于模板编写者使用而制作的模版,例如信息栏、侧边栏等,请使用英语命名(驼峰式命名规范),并使用英文参数名。 | 便于模板编写者使用而制作的模版,例如信息栏、侧边栏等,请使用英语命名(驼峰式命名规范),并使用英文参数名。 | ||
第151行: | 第105行: | ||
{{ SideBar | title=This Is Title | content=This is content }} | {{ SideBar | title=This Is Title | content=This is content }} | ||
</pre> | </pre> | ||
− | |||
− | |||
− | |||
==注意事项== | ==注意事项== |
2020年11月25日 (三) 16:12的版本
模板(Template)是MediaWiki提供的自动替换功能。将常用内容定义为模版后,可以在条目中引用。使用模版有利于维护条目内容,如果需要更改模版的内容,只需在模版页中更改,就能显示在所有引用该模版的页面中。
使用模板
在页面源代码中的适当位置插入模版代码,用一堆双大括号围住模版名称(无需添加Template:),即可引用模版内容。
{{ 模版 }}
不同的模版格式
使用模版时可以添加参数调整模版的内容,例如,使用国家模版时可以使用“国名”指定国家名称。
无参数
直接显示模版内容。
{{ 这是一个无参数模版 }}
未命名参数
可以向模版中依次传入参数,在不同情况下让模版显示不同内容。 模版名与参数之间、参数与参数之间,使用竖线隔开。
{{ 模版 | 第一个参数 | 第二个参数 }}
命名参数
传入参数时也可以用等号指定特定参数的值,在这种情况下,顺序不会影响最终显示效果。
{{ 国家信息 | 国名=废狗帝国 | 首都=废狗岛 | 国家格言=从萝莉到萝莉 }}
参数很多的情况下
可以在模版内换行使源代码更容易阅读。
{{国家信息 |国名=废狗帝国 |首都=废狗岛 |国家格言=从萝莉到萝莉 }}
注意事项
- 大括号、竖线和等于号必须使用半角符号(英语标点),使用中文标点会导致模版格式错误。中英文标点中的竖线很容易混淆,如果使用模版时格式总是出错,可以尝试把所有竖线都修改一下。
- 本页面中的例子仅用于说明模版使用方法,不代表实际的模版参数。
本Wiki中的模板
创建模版
在模板(Template)名字空间中创建的页面可以自动成为模版。
Template:国家信息
获取参数信息
可以使用三重大括号在文本中插入参数的值。
这是上文{{{参数名}}}这是下文
获取未命名参数
可以直接使用数字引用特定位置上的参数。
这是第一个参数: {{{ 1 }}}
指定参数默认值
如果模版使用者没有提供某个参数的值,可以在编写模版的时候指定一个默认值,防止模版出错。
{{{ 当这个参数名没有指定值的时候 | 自动填入这个值 }}}
制作规范
直接面向作者的模版,例如国家信息、作者信息、提示信息等,请使用中文命名,并使用中文参数名。
{{ 国家信息 | 国名=废狗帝国 }}
便于模板编写者使用而制作的模版,例如信息栏、侧边栏等,请使用英语命名(驼峰式命名规范),并使用英文参数名。
{{ SideBar | title=This Is Title | content=This is content }}
注意事项
- �MediaWiki中模板的命名空间为“模板”,但容易误打成“模版”,实际创建的时候可以使用英文"Template"避免放错名字空间。
- 模板中可以使用HTML标签,但部分标签和属性可能无法正常使用。
- 建议尽量使用命名参数。