Template:Mbox/doc: Difference between revisions

Revision as of 22:36, 22 January 2015

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Mbox.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာမန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha / ўзбекча ∙ Tiếng Việt ∙ 中文 ∙ 中文（简体） ∙ 中文（繁體） ∙ 中文（臺灣） ∙ +/−

This is used to create message boxes.

Usage

{{Mbox
|text =
|type =
|image =
|imageright =
|textstyle =
|style =
}}

Template parameters

Parameter	Description	Default	Status
`text`	The text to be displayed.	empty	optional
`type`	Changes the color depending on the message needed. Each has its own preset image.	notice	optional
`image`	Override the image ("none" for no image).	depend on style	optional
`imageright`	Show an image on the right side.	empty	optional
`textstyle`	Override default style of text (e.g. centering - "align:left" / "align:right" / "align:center").	empty	optional
`style`	Override in custom style overrides for the template using CSS.	empty	optional
`lang`	Set the language of the text – it's important for right-to-left languages: their image is on the right and imageright is on the left.	empty	optional

Template data

Parameter text is empty

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Wikipedia's help about TemplateData • Commons-specific information

This is used to create message boxes.

Template parameters
This template prefers block formatting of parameters.
	Description	Type	Status
`image`	Override the image ("none" for no image). Default depend on style	Page name	optional
`imageright`	Show an image on the right side.	Page name	optional
`lang`	Set the language of the text – it's important for right-to-left languages: their image is on the right and imageright is on the left.	String	optional
`style`	Override in custom style overrides for the template using CSS.	String	optional
`text`	The text to be displayed.	Line	optional
`textstyle`	Override default style of text (e.g. centering - "align:left" / "align:right" / "align:center").	String	optional
`type`	Changes the color depending on the message needed. Each has its own preset image. Default notice	String	optional

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

Localization

This template is not intended to be localized.

Examples

warning – for speedy deletion and other serious notices

serious – for deletion notices

issue – for larger issues

query – for minor issues

style – for cleanup (only difference is different icon)

license – for licenses (please note, the icon is an example, templates will still use their current icons where applicable)

legal – for legal disclaimers such as {{Trademark}}

protection – for protection notices

honor – for honors such as featured image

growth – for other "good" notices

move – for move requests

message

notice (default)

The style is different on categories. It uses {{Cmbox}} instead.

@@ Line 2: / Line 2: @@
   |1        = text
   |1d-en    = The text to be displayed.
   |1label   = <!-- A (very) brief name for the parameter. -->
   |1aliases = <!-- List of aliases, separated by / (a slash) -->
   |1type    = string/line
@@ Line 10: / Line 10: @@
   |2        = type
   |2d-en    = Changes the color depending on the message needed. Each has its own preset image.
   |2label   = <!-- A (very) brief name for the parameter. -->
   |2aliases = <!-- List of aliases, separated by / (a slash) -->
   |2type    = string
@@ Line 18: / Line 18: @@
   |3        = image
   |3d-en    = Override the image ("none" for no image).
   |3label   = <!-- A (very) brief name for the parameter. -->
   |3aliases = <!-- List of aliases, separated by / (a slash) -->
   |3type    = string/wiki-page-name
@@ Line 26: / Line 26: @@
   |4        = imageright
   |4d-en    = Show an image on the right side.
   |4label   = <!-- A (very) brief name for the parameter. -->
   |4aliases = <!-- List of aliases, separated by / (a slash) -->
   |4type    = string/wiki-page-name
   |4def     = <!-- default value for the parameter -->
   |4stat    = <!-- required, optional or optional-; optional- means it is optional and omitted in the usage-sample -->
   -
   |5        = textstyle
   |5d-en    = Override default style of text (e.g. centering - "align:left" / "align:right" / "align:center").
   |5label   = <!-- A (very) brief name for the parameter. -->
   |5aliases = <!-- List of aliases, separated by / (a slash) -->
   |5type    = string
@@ Line 42: / Line 42: @@
   |6        = style
   |6d-en    = Override in custom style overrides for the template using CSS.
   |6label   = <!-- A (very) brief name for the parameter. -->
   |6aliases = <!-- List of aliases, separated by / (a slash) -->
   |6type    = string
@@ Line 50: / Line 50: @@
   |7        = lang
   |7d-en    = Set the language of the text – it's important for right-to-left languages: their image is on the right and imageright is on the left.
   |7label   = <!-- A (very) brief name for the parameter. -->
   |7aliases = <!-- List of aliases, separated by / (a slash) -->
   |7type    = string
@@ Line 62: / Line 62: @@
   |placement =
   |usage-notes =
   |type =
   |example =
   |example-value =
   |i18n-method = -
   |i18n-desc =
   |i18n-mediawiki-msg =
   |i18n-subpage =
   |seealso =
   |setscats =
   |print = multi
   |shorthand =
   |relieson =
   |mustbesubst =
   |useTemplateData = 1
 }}
-==Examples==
+== Examples ==
 {{mbox
-|text=warning - for speedy deletion and other serious notices
+|text=warning – for speedy deletion and other serious notices
 |type=warning
 }}
 {{mbox
-|text=serious - for deletion notices
+|text=serious – for deletion notices
 |type=serious
 }}
 {{mbox
-|text=issue - for larger issues
+|text=issue – for larger issues
 |type=issue
 }}
 {{mbox
-|text=query - for minor issues
+|text=query – for minor issues
 |type=query
 }}
 {{mbox
-|text=style - for cleanup (only difference is different icon)
+|text=style – for cleanup (only difference is different icon)
 |type=style
 }}
 {{mbox
-|text=notice
+|text=license – for licenses (please note, the icon is an example, templates will still use their current icons where applicable)
-|type=notice
-}}
-{{mbox
-|text=license - for licenses (please note, the icon is an example, templates will still use their current icons where applicable)
 |type=license
 }}
 {{mbox
-|text=legal - for legal disclaimers such as {{tl|Trademark}}
+|text=legal – for legal disclaimers such as {{tl|Trademark}}
 |type=legal
 }}
 {{mbox
-|text=protection - for protection notices
+|text=protection – for protection notices
 |type=protection
 }}
 {{mbox
-|text=honor - for honors such as featured image
+|text=honor – for honors such as featured image
 |type=honor
 }}
 {{mbox
-|text=growth - for other "good" notices
+|text=growth – for other "good" notices
 |type=growth
 }}
 {{mbox
-|text=move - for move requests
+|text=move – for move requests
 |type=move
+}}
+{{mbox
+|text=message
+|type=message
+}}
+{{mbox
+|text=notice (default)
+|type=
 }}

commons>Perhelion