Template:Dmbox/sandbox

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

This is the template sandbox page for Template:Dmbox (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template is used on 471,000+ pages, or roughly 1% of all pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses TemplateStyles:

Template:Dmbox/styles.css

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

It is used to build disambiguation and set index article message boxes, such as {{Disambiguation}} and {{Ship index}}.

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[edit]

Simple usage example:

{{dmbox | text = Some text.}}

Some text.

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

Some text.

Complex example:

{{dmbox
| type      = setindex
| image     = [[File:Schooner.svg|30px|link=|alt=]] [[File:DAB list gray.svg|30px|alt=Disambiguation icon]]
| text      = The message body text.
}}

The message body text.

Some other parameter combinations:

No type and no image given (default)

No type and image=none – No image is used and the text uses the whole message box area.

type = setindex
imageright = [[File:Schooner.svg|33px|link=|alt=]]

This article includes a list of ships with the same or similar names. If an internal link for a specific ship referred you to this page, you may wish to change the link to point directly to the intended ship article, if one exists.

Parameters[edit]

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.) And adds Category:All disambiguation pages and Category:All article disambiguation pages.

setindex = Does not trigger the {{disambig editintro}} when editing a page. (Because this instead sets the CSS id "setindexbox".) And adds Category:All set index articles.

|nocat=

true = Stops this template from categorizing. Useful for tests and demonstrations. Dmbox templates should forward^{[when defined as?]} |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[edit]

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>
}}

Equal sign = and a start and end brace { } work fine as they are. But here is a pipe | and two end braces }}. And now a pipe and end braces |}}.

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.

Usage[edit]

Parameters[edit]

Technical details[edit]

See also[edit]