User:Star0/sandbox 2:修订间差异
无编辑摘要 |
无编辑摘要 |
||
第1行: | 第1行: | ||
本模板是 条 目 信 息框的元模板。用 于创 造文章 信 息框模板。此外本模板具有自由 选择 不同 颜 色、 显 示特定 预设图 片等功能。 | |||
'''请注意 | '''请注意''' : 这个模板只用于在条目名字空间使用的模板,其他名字空间使用的模板请不要使用。 | ||
== | ==常用参数== | ||
右 | 右 侧 的方框 内为本 模板最常用的 参数 。每 种参数 的 说 明如下: | ||
{| class="wikitable" align="right" style="background:transparent;" width="40%" | {| class="wikitable" align="right" style="background:transparent;" width="40%" | ||
! | !常用參數 | ||
|- | |- | ||
|<pre style="font-size:90%; "> | |<pre style="font-size:90%;"> | ||
{{Ambox | {{Ambox | ||
| name = | | name = | ||
第36行: | 第27行: | ||
|} | |} | ||
=== ''name'' === | === '''name''' === | ||
name参数指定模板的名字,不需要加上模板名字空间前缀。 | |||
本 | 本 参数应该 模板被移 动时 更新。本 参数 的指定有 两个 目的: | ||
如果 模板被错误 的 替 换 引用 (substituded) , 这个参数能让元模板显 示一段警告文字 , 将 可帮助编辑者修 复 问题 。 | |||
=== ''small'' === | 能让模板在模板页中更有效地展示,例如在没有填入日期的情况下自动显示日期,并能让模板准确分类。 | ||
=== subst === | |||
subst参数让元模板能检测此模板是否被错误替代引用的,并显示一段警告文字。完全复制上述方框中的代码即可。一般情况下,请勿更改本参数内容,直接复制上方的模板代码即可。 | |||
===''small''=== | |||
small参 数 可 让编辑 者在 条 目中使用模板 时输 入 <code>|small=left</code> 来产 生一 个 小型的模板。 | |||
{{ambox|nocat=true|small=left|text=這是一個靠左顯示的小型模板。}} | {{ambox|nocat=true|small=left|text=這是一個靠左顯示的小型模板。}} | ||
一般情 | 一般情 况 下本模板的 显 示效果如下: | ||
{{ambox|nocat=true|text=這是一個標準的訊息框格式。}} | {{ambox|nocat=true|text=這是一個標準的訊息框格式。}} 其他参数设置方式: | ||
* 如果模板 “ 永 远” 不 应 以 缩 小的方式 显 示, 请 在模板 源代码 中使用 <code>|small=no</code> 。 | |||
* 如果模板 | * 如果模板 应“总 是 ” 以 缩 小的方式 显 示, 请 在模板 源代码 中使用 <code>|small=left</code> 。 | ||
* 如果模板 | * 如果模板 “默认为缩 小 显 示 ” , 请 在模板 源代码 中使用 <code>|small=<nowiki>{{{small|left}}}</nowiki></code> 。可 让编辑 者在 条 目中 输 入 <code>|small=no</code> 参数时无 效。 | ||
* 如果模板 | |||
=== ''type'' === | ===''type''=== | ||
''type'' 参数能指定的模板 | ''type'' 参数能指定的模板 默认 的左侧直 条颜 色和图片。本 参数 的 选择并 非依 据编辑 者 对颜 色的偏好,而是根 据 模板 内讯 息的 类 型 来决 定。以下是七 种 可在 “<code>type</code> ”参数 中填入的值: | ||
{{ambox | {{ambox | ||
第94行: | 第86行: | ||
如果没有指定 ''type'' 参数,默认为 {{para|type|notice}}。 | 如果没有指定 ''type'' 参数,默认为 {{para|type|notice}}。 | ||
=== ''image'' === | ===''image''=== | ||
您可以使用 ''image'' | 您可以使用 ''image'' 参数来 指定模板中 显 示的 图 片。 图 片的指定 语 法 与维 基百科放置 图 片的 默认语 法相同( 参见 :如何放置 图 片)。一般 来说 , 图 片的 宽 度 约为 40-50px。 示 例如下: | ||
* {{ | * <nowiki>{{POV}}</nowiki> 中 参数设置为 <code>|image=<nowiki>[[File:Unbalanced scales.svg|40px|link=|alt=]]</nowiki></code> ,其 显 示效果如下: | ||
{{POV|time={{#time:c}}|nocat=true}} | {{POV|time={{#time:c}}|nocat=true}} | ||
請注意 : | |||
* 如果 没 有指定 图 片,模板 将会 配合 “type”参数 的 内 容 选择适当 的 图 片( 参见 :#type) | |||
* 如果 | * 如果 参数设置为 <code>|image=none</code> 时将 不 会显 示任何 图 片, 讯 息框 内将仅显 示文字。 | ||
* 如果 | * 如果 图 片 仅为装饰 功能, 并属于 公共领域,可如在 参数 中加上 "<code>|link=</code> ''以 产 生 连 往 图 片描述 页 的 链接 ,以及'' <code>|alt=</code>" 来产 生替代文字;以上 两种 做法可提升 页 面 亲 和力。 | ||
* 如果 | |||
=== ''sect'' === | ===''sect''=== | ||
许多条目 | 许多条目 讯 息模板开头文字为 “'''此条目⋯⋯''' ” ,如果此模板用于章节,则应该更适当地使用 “'''此章节⋯⋯''' ” 。其他可能性包括 “'''此列表⋯⋯''' ” 和 “'''此人物 传记 ⋯⋯''' ” 。 | ||
为了实现这个功能。请使用 | 为了实现这个功能。请使用 <code>|sect=<nowiki>{{{1|}}}</nowiki></code> 参数 。 这将 使 编辑 者能在第一 个无 名的 参数 中 输 入 “'''章 节'''' ”来 改 变 模板所指的 条 目部分。 | ||
在使用这个功能 | 在使用这个功能 时 ,在模板 源代码 中应移除开头的几个字(例如:本条目),否则会造成重复显示。 | ||
=== ''issue'' & ''fix'' === | ===''issue'' & ''fix''=== | ||
''issue'' 参数用于描述条目的问题。 | ''issue'' 参数用于描述条目的问题。 请尽 量保持文字 叙 述 简洁 有力( 约 在 10-20 个 字 内 ), 并 包含一 个链接 至有 关 的方 针与 指引 页 面。 | ||
''fix'' 参数包含描述如何改进条目的指导文字。文字 | ''fix'' 参数包含描述如何改进条目的指导文字。文字 内 容可比 ''issue'' 参数 中所填入的字 数 多,在大多 数 情 况 下, 请 保持在 两 句 话内叙 述完 毕 。 | ||
当 模板以 集成状态 (例如放置在 <nowiki>{{multiple issues}}</nowiki> 中)或小型 状态 (使用 <code>|small=left</code> 参数 ) 显 示 时 ,只有 ''issue'' 参数 中的文字 会显 示。例如在 <nowiki>{{citation style}}</nowiki> 模板中的 参数设置为 : | |||
* <code>|issue = | * <code>|issue = 本條目的<nowiki>'''</nowiki> 引用需要进行清理。<nowiki>'''</nowiki></code> | ||
* <code>| fix = | * <code>| fix = 参考文献应符合正确的<nowiki>[[Wikipedia:列明来源|引用]]</nowiki> 、<nowiki>[[Wikipedia:脚注|脚注]]</nowiki> 及<nowiki>[[Wikipedia:外部链接|外部链接]]</nowiki> 格式。</code> | ||
===''talk''=== | |||
{{ | 某些条目讯息框模板包含了一个通往其讨论页的链接,并让编辑者能指定相关议题所在的章节位置。如要达成这项功能,请 使用 ''talk'' 参数,使用方式为 <code>|talk=<nowiki>{{{talk|}}}</nowiki></code>。 | ||
这项参数将可被编辑者以下述方式 使用: | |||
* <code>|talk= 章节标题</code> - 链接可 通往 条目讨论页中 的 特 定章 节 。 例 如 :<code>|talk=西瓜</code> | |||
* <code>|talk=完整页面名称</code> - 链接将通往指定的页面。例如:<code>|talk=Talk:香蕉#西瓜</code> | |||
请注意 : | |||
* 当 模板中使用本 参数时 ,模板本身 将会显 示一 个 通往 讨论页 的 链接 ( 为 了 显 示支 持 此功能),但 仅 有在 参数 被 确实 定 义时 才 会 在 条 目中的模板 内显 示。 | |||
* | * 如果要 让 模板永 远显 示一 个 通往 讨论页 的 链接 , 请 使用 <code>|talk=<nowiki>{{{talk|#}}}</nowiki></code> 参数 。 | ||
* 如果要 | * 如果 讨论页 面不存在, 无论参数设置为 何,都 将 不 会显 示任何 链接 。 | ||
* 如果 | |||
=== ''date'' === | === ''date'' === | ||
将 ''date'' 直接 发 送至元模板可 让编辑 者(或 机 器人)自行 输 入模板被放置在 条 目中的日期。日期 将会 以 较 小的字 体 在主要文字 后显 示 。 | |||
在 ''cat'' 参数同时获得定义时,将 ''date'' 参数发送至元模板可实现将条目自动按月分类的功能 。 | |||
===''time''=== | |||
=== ''time'' === | |||
''time''和''date''用法差不多,但是time可以配合<nowiki>{{#time:c}}</nowiki>,例如: | ''time''和''date''用法差不多,但是time可以配合<nowiki>{{#time:c}}</nowiki>,例如: | ||
第157行: | 第142行: | ||
=== ''cat'' === | === ''cat'' === | ||
这个参数 定 义 了清理分 类 的名 称 。使用 <code>|cat=CATEGORY</code> 参数 : | |||
* | * 并 同 时 使用 <code>|date=DATE</code> , 则条 目 会 被自 动 分 类 至 '''Category:自DATE起CATEGORY''' 中。 | ||
* 若 | * 若 无 指定日期, 条 目 会 被自 动 分 类 至 '''Category:CATEGORY''' 中。 | ||
=== ''all'' === | === ''all'' === | ||
''all | ''all 参数 可用 来 指定所有包含模板之 条 目的分 类 。'' | ||
<br /> | |||
== | ==其他 参数== | ||
右 | 右 侧 方框 内 展示了此模版的所有 参数 。由 于几 乎不可能同 时 用到所有 参数 ,因此不建 议复制 此 处 的空白模版。 | ||
{| class="wikitable" align="right" style="background:transparent; width=40%" | {| class="wikitable" align="right" style="background:transparent; width=40%" | ||
!完整的所有參數 | !完整的所有參數 | ||
第204行: | 第190行: | ||
=== ''imageright'' === | === ''imageright'' === | ||
在 | 在 讯 息框右 侧显 示 图 片。填入方式 与 ''image'' 参数 相同, 默认为 不 显 示任何 图 片。 | ||
=== ''smallimage'' & ''smallimageright'' === | === ''smallimage'' & ''smallimageright'' === | ||
可在此 | 可在此 参数 指定模板 缩 小 显 示 后 所使用的 图 片。 仅 在定 义 <code>|small=left</code> 时 有效。 | ||
=== ''class'' === | === ''class'' === | ||
可自行定义使用在 | 可自行定义使用在 讯 息框 的CSS类 型 选择 器(Class)。 | ||
=== ''style'' & ''textstyle'' === | === ''style'' & ''textstyle'' === | ||
可 | 可 选择 定 义CSS样 式,不需加上引 号 <code>" "</code>,但必 须 在 结 尾加上分 号 <code>;</code>。 | ||
* ''style'' | |||
* ''textstyle'' | * ''style'' 为 套用至整 个讯 息框的 样 式 | ||
* ''textstyle'' 为仅 套用在文字上的 样 式 | |||
=== ''text'' & ''smalltext'' === | === ''text'' & ''smalltext'' === | ||
除了指定 ''issue'' 和 ''fix'' | 除了指定 ''issue'' 和 ''fix'' 参数 外,也可使用 ''text'' 参数来 定 义 要 显 示的文字(不建议使用''text'',不支持移动版) | ||
''smalltext'' | ''smalltext'' 则 用 来 定 义 要以 较 小字 体显 示的文字 | ||
=== 其他分 | === 其他分 类 相 关参数 === | ||
* ''cat2'' 和 ''cat3'' 可增加按月分类时所用的分类名称,用法与 ''#cat'' 参数 相同。 | |||
* ''all2'' 和 ''all3'' 可增加所有包含模板之条目 的 分类名称 , 用法与 ''#all'' 参数相同。 | |||
<pre> | ==技术细节== | ||
如果你需要在text参数中使用一些特殊字符的话,那么就需要像这样将它们换码:<pre> | |||
{{ambox | {{ambox | ||
| text = | | text = | ||
第247行: | 第233行: | ||
此模板使用CSS类来确定显示风格,因此可被更换到其他风格。 | 此模板使用CSS类来确定显示风格,因此可被更换到其他风格。 | ||
在此元模板内使用了HTML的表格标示法,而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法,因为维基式标示法存在一些缺陷。譬如,维基式标示法会加大 | 在此元模板内使用了HTML的表格标示法,而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法,因为维基式标示法存在一些缺陷。譬如,维基式标示法会加大模板扩展语法及参数中特殊字符使用的难度。 | ||
更多的技术细节参见 | 更多的技术细节参见 维基百科 页 面 。 |
2020年8月28日 (五) 18:56的版本
本模板是条目信息框的元模板。用于创造文章信息框模板。此外本模板具有自由选择不同颜色、显示特定预设图片等功能。
请注意:这个模板只用于在条目名字空间使用的模板,其他名字空间使用的模板请不要使用。
常用参数
右侧的方框内为本模板最常用的参数。每种参数的说明如下:
常用參數 |
---|
{{Ambox | name = | subst = <includeonly>{{subst:substcheck}}</includeonly> | small = {{{small|}}} | type = | image = | sect = {{{1|}}} | issue = | talk = {{{talk|}}} | fix = | date = {{{date|}}} | time = {{{time|}}} | cat = | all = }} |
name
name参数指定模板的名字,不需要加上模板名字空间前缀。
本参数应该模板被移动时更新。本参数的指定有两个目的:
如果模板被错误的替换引用(substituded),这个参数能让元模板显示一段警告文字,将可帮助编辑者修复问题。
能让模板在模板页中更有效地展示,例如在没有填入日期的情况下自动显示日期,并能让模板准确分类。
subst
subst参数让元模板能检测此模板是否被错误替代引用的,并显示一段警告文字。完全复制上述方框中的代码即可。一般情况下,请勿更改本参数内容,直接复制上方的模板代码即可。
small
small参数可让编辑者在条目中使用模板时输入 |small=left
来产生一个小型的模板。
這是一個靠左顯示的小型模板。 |
一般情况下本模板的显示效果如下:
這是一個標準的訊息框格式。 |
其他参数设置方式:
- 如果模板“永远”不应以缩小的方式显示,请在模板源代码中使用
|small=no
。 - 如果模板应“总是”以缩小的方式显示,请在模板源代码中使用
|small=left
。 - 如果模板“默认为缩小显示”,请在模板源代码中使用
|small={{{small|left}}}
。可让编辑者在条目中输入|small=no
参数时无效。
type
type 参数能指定的模板默认的左侧直条颜色和图片。本参数的选择并非依据编辑者对颜色的偏好,而是根据模板内讯息的类型来决定。以下是七种可在“type
”参数中填入的值:
type=speedy-请求快速刪除,如 {{delete}}。 |
type=delete-请求删除,如 {{afd}} 与 {{vfd}} 。 |
type=content-内容问题,如 {{POV}} 与 {{globalize}} 。 |
type=style-格式问题,如 {{cleanup}} 与 {{wikify}}。 |
type=move-合并、拆分及跨维基提议,如 {{split}} 与 {{splitsection}}。 |
type=protection-页面保护,如 {{Protected}}。 |
type=notice-条目注意,如 {{current}} 与 {{inuse}}。 |
如果没有指定 type 参数,默认为 |type=notice
。
image
您可以使用 image 参数来指定模板中显示的图片。图片的指定语法与维基百科放置图片的默认语法相同(参见:如何放置图片)。一般来说,图片的宽度约为 40-50px。示例如下:
- {{POV}} 中参数设置为
|image=[[File:Unbalanced scales.svg|40px|link=|alt=]]
,其显示效果如下:
此条目中立性有争议。内容、语调可能带有明显的个人观点或地方色彩。 (2024年12月19日) |
請注意:
- 如果没有指定图片,模板将会配合“type”参数的内容选择适当的图片(参见:#type)
- 如果参数设置为
|image=none
时将不会显示任何图片,讯息框内将仅显示文字。 - 如果图片仅为装饰功能,并属于公共领域,可如在参数中加上 "
|link=
以产生连往图片描述页的链接,以及|alt=
" 来产生替代文字;以上两种做法可提升页面亲和力。
sect
许多条目讯息模板开头文字为“此条目⋯⋯”,如果此模板用于章节,则应该更适当地使用“此章节⋯⋯”。其他可能性包括“此列表⋯⋯”和“此人物传记⋯⋯”。
为了实现这个功能。请使用 |sect={{{1|}}}
参数。这将使编辑者能在第一个无名的参数中输入“章节'”来改变模板所指的条目部分。
在使用这个功能时,在模板源代码中应移除开头的几个字(例如:本条目),否则会造成重复显示。
issue & fix
issue 参数用于描述条目的问题。请尽量保持文字叙述简洁有力(约在 10-20 个字内),并包含一个链接至有关的方针与指引页面。
fix 参数包含描述如何改进条目的指导文字。文字内容可比 issue 参数中所填入的字数多,在大多数情况下,请保持在两句话内叙述完毕。
当模板以集成状态(例如放置在 {{multiple issues}} 中)或小型状态(使用 |small=left
参数)显示时,只有 issue 参数中的文字会显示。例如在 {{citation style}} 模板中的参数设置为:
|issue = 本條目的'''引用需要进行清理。'''
| fix = 参考文献应符合正确的[[Wikipedia:列明来源|引用]]、[[Wikipedia:脚注|脚注]]及[[Wikipedia:外部链接|外部链接]]格式。
talk
某些条目讯息框模板包含了一个通往其讨论页的链接,并让编辑者能指定相关议题所在的章节位置。如要达成这项功能,请使用 talk 参数,使用方式为 |talk={{{talk|}}}
。
这项参数将可被编辑者以下述方式使用:
|talk=章节标题
- 链接可通往条目讨论页中的特定章节。例如:|talk=西瓜
|talk=完整页面名称
- 链接将通往指定的页面。例如:|talk=Talk:香蕉#西瓜
请注意:
- 当模板中使用本参数时,模板本身将会显示一个通往讨论页的链接(为了显示支持此功能),但仅有在参数被确实定义时才会在条目中的模板内显示。
- 如果要让模板永远显示一个通往讨论页的链接,请使用
|talk={{{talk|#}}}
参数。 - 如果讨论页面不存在,无论参数设置为何,都将不会显示任何链接。
date
将 date 直接发送至元模板可让编辑者(或机器人)自行输入模板被放置在条目中的日期。日期将会以较小的字体在主要文字后显示。
在 cat 参数同时获得定义时,将 date 参数发送至元模板可实现将条目自动按月分类的功能。
time
time和date用法差不多,但是time可以配合{{#time:c}},例如:
{{ambox|issue=内容|fix=附加文字|date={{subst:#time:c}}}}会显示为:
内容 (2024年12月19日) |
{{ambox|issue=内容|fix=附加文字|time={{subst:#time:c}}}}会显示为:
内容 (2024年12月19日) |
cat
这个参数定义了清理分类的名称。使用 |cat=CATEGORY
参数:
- 并同时使用
|date=DATE
,则条目会被自动分类至 Category:自DATE起CATEGORY 中。 - 若无指定日期,条目会被自动分类至 Category:CATEGORY 中。
all
all 参数可用来指定所有包含模板之条目的分类。
其他参数
右侧方框内展示了此模版的所有参数。由于几乎不可能同时用到所有参数,因此不建议复制此处的空白模版。
完整的所有參數 |
---|
{{Ambox | name = | subst = <includeonly>{{subst:substcheck}}</includeonly> | small = {{{small|}}} | type = | image = | imageright = | smallimage = | smallimageright = | class = | style = | textstyle = | sect = {{{1|}}} | issue = | talk = {{{talk|}}} | fix = | date = {{{date|}}} | time = {{{time|}}} | text = | smalltext = | cat = | all = | cat2 = | all2 = | cat3 = | all3 = }}<noinclude> {{Documentation}} </noinclude> |
imageright
在讯息框右侧显示图片。填入方式与 image 参数相同,默认为不显示任何图片。
smallimage & smallimageright
可在此参数指定模板缩小显示后所使用的图片。仅在定义 |small=left
时有效。
class
可自行定义使用在讯息框的CSS类型选择器(Class)。
style & textstyle
可选择定义CSS样式,不需加上引号 " "
,但必须在结尾加上分号 ;
。
- style 为套用至整个讯息框的样式
- textstyle 为仅套用在文字上的样式
text & smalltext
除了指定 issue 和 fix 参数外,也可使用 text 参数来定义要显示的文字(不建议使用text,不支持移动版)
smalltext 则用来定义要以较小字体显示的文字
其他分类相关参数
- cat2 和 cat3 可增加按月分类时所用的分类名称,用法与 #cat 参数相同。
- all2 和 all3 可增加所有包含模板之条目的分类名称,用法与 #all 参数相同。
技术细节
如果你需要在text参数中使用一些特殊字符的话,那么就需要像这样将它们换码:
{{ambox | text = 等号 = 与前后大括号{ }可以正常地使用。 但是管道符{{!}}与两个连着的后大括号<nowiki>}}</nowiki>则不能直接使用。 一起用同样要带nowiki标记<nowiki>|}}</nowiki>。 }}
等号 = 与前后大括号{ }可以正常地使用。
但是管道符|与两个连着的后大括号}}则不能直接使用。 一起用同样要带nowiki标记|}}。 |
此模板使用CSS类来确定显示风格,因此可被更换到其他风格。
在此元模板内使用了HTML的表格标示法,而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法,因为维基式标示法存在一些缺陷。譬如,维基式标示法会加大模板扩展语法及参数中特殊字符使用的难度。
更多的技术细节参见维基百科页面。