Vorlage:Dmbox/doc

Message box meta-templates
template	context
{{Ambox}}	article
{{Cmbox}}	category
{{Imbox}}	image
{{Tmbox}}	talk
{{Fmbox}}	footer / header
{{Ombox}}	other pages
{{Asbox}}	article stub
{{Dmbox}}	disambiguation
base template
{{mbox}}

This is the {{Dmbox}} ([D]isambiguation footer [m]essage [box]) metatemplate.

It is used to build disambiguation and set index article message boxes.

This template works similarly to {{Ambox}} and mostly uses the same parameters. The main differences are that this box uses the disambiguation style and only has two "type" settings.

Usage

Simple usage example:

{{dmbox | text = Some text.}}

{{dmbox | type = setindex | text = Some text.}}

Complex example:

{{dmbox
| type      = setindex
| image     = {{nowrap| [[File:{{Image mapper|Shuttle}}|20px]] [[File:{{Image mapper|DAB list gray}}|20px]] }}
| text      = The message body text.
}}

Some other parameter combinations:

Parameters

List of all parameters:

{{dmbox
| type  = disambig / setindex
| image = none / [[File:Some image.svg|40px|link=|alt=]]
| imageright = [[File:Some image.svg|40px|link=|alt=]]
| text  = The message body text. 
| nocat = {{{nocat|}}} / true
}}

|type=

If no |type= parameter is given the template defaults to type disambig.

disambig = Makes it so the disambig editintro is displayed when editing a page with this template on. (Means that this template internally sets the CSS id "disambigbox". The id is used by the javascript in MediaWiki:Common.js to determine if a page is a disambiguation page or not.).

setindex = Does not trigger the disambig editintro when editing a page. (Because this instead sets the CSS id "setindexbox".)

|nocat=

true = Stops this template from categorizing. Useful for tests and demonstrations. Dmbox templates should forward |nocat=, so they too have the option to suppress categories. Thus, it is recommended that Dmbox templates always add something similar to this:

nocat = {{{nocat|}}}

|image=

[No parameter] = If no |image= parameter is given, the template uses the default |disambig= or |setindex= image, depending on the |type= parameter.

An image = Should be an image with usual wiki notation. 30px - 50px width are usually about right depending on the image height to width ratio. (Keep the width small; images in this template do not automatically shrink on mobile devices.) For example:

image = [[File:Schooner.svg|30px|link=|alt=]]

none = Means that no image is used.

|imageright=

No parameter = If no |imageright= parameter is given then no image is shown on the right side.

An image = Should be an image with usual wiki notation. 30px - 50px width are usually about right depending on the image height to width ratio. (Keep the width small; images in this template do not automatically shrink on mobile devices.) For example:

imageright = [[File:Nuvola apps bookcase.png|40px|alt=Books icon]]

Anything = Any other object that you want to show on the right side.

|text=

The message body text. This message box has italic text as default, thus no need to manually set that.

Technical details

If you need to use special characters in the text parameter then you need to escape them like this:

{{dmbox
| text  = <div>
Equal sign = and a start and end brace { } work fine as they are. 
But here is a pipe {{!}} and two end braces <nowiki>}}</nowiki>. 
And now a pipe and end braces <nowiki>|}}</nowiki>.
</div>
}}

For more technical details see the talk page. Since this template works almost exactly like {{ambox}}, {{tmbox}}, {{imbox}}, {{cmbox}} and {{ombox}} their talk pages and related pages might also contain more details.

See also

There are seven meta-templates in the Module:Message box family:

• {{ambox}} – For article message boxes.
• {{cmbox}} – For category message boxes.
• {{imbox}} – For file (image) page message boxes.
• {{fmbox}} – For header and footer message boxes.
• {{mbox}} – Has namespace detection, for message boxes that are used on several types of pages and thus need to change style depending on what page they are used on.
• {{ombox}} – For other pages message boxes.
• {{tmbox}} – For talk page message boxes.

Closely related meta-templates:

• {{asbox}} – For article stub message boxes.
• {{dmbox}} – For disambiguation and set index message boxes.

Other pages:

• Wikipedia:Disambiguation, which includes a section explaining set index articles.
• Wikipedia:WikiProject Disambiguation