Template:Cmbox/doc

勤求古训,博采众方
信息框元模板
模板背景
{{Ambox}}条目
{{Cmbox}}分类
{{Imbox}}图片
{{Tmbox}}讨论
{{Fmbox}}页脚/标题
{{Ombox}}其他页面
{{Mbox}}自动侦测
消歧义

本模板是{{cmbox}}或 分类信息框(category message box)元模板。

它用于建立分类页面的信息框模板,如{{CatDiffuse}}等。它提供若干种不同的颜色,当无图像参数给出时使用预设图像,它还有其他特点。

该模板的工作与{{ambox}}几乎相同,并使用同样的参数。


用法

简单应用的例子:

{{cmbox | text = Some text.}}


复杂应用的例子:

{{cmbox
| type      = style
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 信息框的主体文字。
}}

分类信息框类别

以下范例使用了不同的type参数,但没有使用image参数,因而使用了各type(类型)所对应的预设圖像。

其他图片

上方显示的预设图像是十分方便的,但在很多情况下需要使用特别指定的图像。以下是一些使用image参数来指定其他图像的案例:

特殊设定

此外,还有一些其他的参数。

参数

所有参数的列表:

{{cmbox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[File:Some image.svg|40px]]
| imageright = [[File:Some image.svg|40px]]
| style = CSS values
| textstyle = CSS values
| text  = 信息正文文本。
}}

type

如果不指定type参数的话,会返回用于“条目注意”的预设类型notice的模板。这意味着会像上文中的简单应用那样产生一个蓝色的边框。

image

No parameter = 如果不指定image参数的话,会返回使用预设图像的模板。至于是哪张预设图像则取决于type参数。
An image = 应该是一幅带有常见维基符号的图像。通常为40px-50px的宽度,这取决于图像的长宽比。(但信息框可应付各种尺寸的图像。)例如:
image = [[File:Sub-arrows.svg|40px]]
none = 不使用图像。

imageright

No parameter = 如果不指定imageright参数的话,会返回右侧不带图像的模板。
An image = 应该是一幅带有常见维基符号的图像。通常为40px-50px的宽度,这取决于图像的长宽比。(但信息框可应付各种尺寸的图像。)例如:
imageright = [[File:Nuvola apps bookcase.png|40px]]
Anything = 任何你想在模板右侧显示的其他内容。

style

整个信息框表使用的可选CSS值。不带引号""。例如:
style = margin-bottom: 0.5em;

textstyle

文本单元格使用的可选CSS值。例如:
textstyle = text-align: center;

text

信息框的主体文字。

技术细节

如果你需要在text参数中使用一些特殊字符的话,那么就需要像这样将它们换码:

{{cmbox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号}}则不能直接使用。
一起用同样要带nowiki标记|}}。
</div>
}}

此模板使用CSS类来确定显示风格,因此可被更换到其他风格。

在此元模板内使用了HTML的表格标示法,而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法,因为维基式标示法存在一些缺陷。譬如,维基式标示法会加大模板扩展语法及参数中特殊字符使用的难度。

此元模板所用的缺省图片用的是png格式的,而不是svg格式。其主要原因是在处理MediaWiki为svg图片所渲染的透明背景时,一些老版本的网络浏览器会遇到一些麻烦。这里的png格式图片有手工优化过的透明背景颜色,因而在所有的浏览器中它们看上去都是好的。请注意,svg图标只会在一些老版本的浏览器中看上去有点不对头,因此只有那些非常广泛使用的图标才值得费些功夫去做那种手工优化。

更多的技术细节参见讨论页以及下方的#參見一节。

参见

在信息框(mbox)家族中的元模板:

  • {{ambox}}:用于条目信息框
  • {{tmbox}}:用于讨论页信息框
  • {{imbox}}:用于图像页信息框
  • {{cmbox}}:用于分类信息框
  • {{ombox}}:用于其他页面信息框
  • {{mbox}}:有名字空间探测功能。某些消息框会用在几类页面并因此需要依据所用在的页面来改变风格,这种情况下的消息框可以用此元模板。

有相近关系的元模板:

  • {{fmbox}}:用于页眉和页脚信息框
  • {{dmbox}}:用于消歧义以及设定索引信息框