Vorlage:Dmbox/doc: Unterschied zwischen den Versionen

ZIM HilfeWiki - das Wiki
 
imported>Oetterer
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 1: Zeile 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
{{high-risk}}
+
<!-- Categories where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]) -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
+
{{Uses TemplateStyles|Template:Dmbox/styles.css}}
 +
{{Mbox templates}}
  
{{mbox templates}}
+
This is the {{tl|Dmbox}} (['''D''']isambiguation footer ['''m''']essage ['''box''']) [[WP:MTM|metatemplate]].
This is the {{tl|dmbox}} or '''disambiguation footer message box''' meta-template.
 
  
It is used to build disambiguation and [[Wikipedia:Disambiguation#Set index articles|set index article]] boxes.  
+
It is used to build [[WP:disambiguation|disambiguation]] and [[Wikipedia:set index article|set index article]] message boxes.  
  
This template works similarly to {{tl|ambox}} and mostly uses the same parameters. The main differences are that this box uses the disambiguation style and only has two "type" settings.
+
This template works similarly to {{tl|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 ===
 
=== Usage ===
Zeile 31: Zeile 31:
 
{{dmbox
 
{{dmbox
 
| type      = setindex
 
| type      = setindex
| image    = {{nowrap| [[Image:Shuttle.png|20px]] [[Image:List gray.png|20px]] }}
+
| image    = {{nowrap| [[File:{{Image mapper|Shuttle}}|20px]] [[File:{{Image mapper|DAB list gray}}|20px]] }}
| textstyle = color: red; font-weight: bold; font-style: normal;
 
 
| text      = The message body text.
 
| text      = The message body text.
 
}}
 
}}
Zeile 39: Zeile 38:
 
{{dmbox
 
{{dmbox
 
| type      = setindex
 
| type      = setindex
| image    = {{nowrap| [[Image:Shuttle.png|20px]] [[Image:List gray.png|20px]] }}
+
| image    = {{nowrap| [[File:{{Image mapper|Shuttle}}|20px]] [[File:{{Image mapper|DAB list gray}}|20px]] }}
| textstyle = color: red; font-weight: bold; font-style: normal;
 
 
| text      = The message body text.
 
| text      = The message body text.
 
}}
 
}}
Zeile 57: Zeile 55:
 
{{dmbox
 
{{dmbox
 
| type = setindex
 
| type = setindex
| imageright = [[Image:Shuttle.png|21px]]  
+
| imageright = [[File:{{Image mapper|Shuttle}}|33px|link=|alt=]]  
| text  = type = setindex <br> imageright = <nowiki>[[Image:Shuttle.png|21px]]</nowiki>
+
| text  = type = setindex <br> imageright = <nowiki>[[File:Shuttle.svg|33px|link=|alt=]]</nowiki>
 
}}
 
}}
  
 
{{dmbox
 
{{dmbox
 
| type = setindex
 
| type = setindex
| imageright = [[Image:Shuttle.png|21px]]
+
| imageright = [[File:{{Image mapper|Shuttle}}|33px|link=|alt=]]
 
| text  =  
 
| text  =  
 
This article includes a [[Wikipedia:WikiProject Ships/Guidelines#Index pages|list of ships]] with the same or similar names. If an [[Special:Whatlinkshere/{{NAMESPACE}}:{{PAGENAME}}|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.
 
This article includes a [[Wikipedia:WikiProject Ships/Guidelines#Index pages|list of ships]] with the same or similar names. If an [[Special:Whatlinkshere/{{NAMESPACE}}:{{PAGENAME}}|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.
Zeile 74: Zeile 72:
 
{{dmbox
 
{{dmbox
 
| type  = disambig / setindex
 
| type  = disambig / setindex
| image = none / [[Image:Some image.png|40px]]
+
| image = none / [[File:Some image.svg|40px|link=|alt=]]
| imageright = [[Image:Some image.png|40px]]
+
| imageright = [[File:Some image.svg|40px|link=|alt=]]
| style = CSS values
 
| textstyle = CSS values
 
 
| text  = The message body text.  
 
| text  = The message body text.  
 
| nocat = {{{nocat|}}} / true
 
| nocat = {{{nocat|}}} / true
Zeile 83: Zeile 79:
 
</pre>
 
</pre>
  
'''type'''
+
{{Para|type}}
:If no '''type''' parameter is given the template defaults to type '''disambig'''.
+
:If no {{Para|type}} parameter is given the template defaults to type {{code snippet|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.)
+
:{{code snippet|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".)
+
:{{code snippet|setindex}} = Does ''not'' trigger the disambig editintro when editing a page. (Because this instead sets the CSS id "setindexbox".)
  
'''nocat'''
+
{{Para|nocat}}
:'''true''' = Stops this template from categorizing. Useful for instance when only testing or demonstrating this template. Templates that use this template should forward '''nocat''', so they too understand nocat. So always add this:
+
:{{code snippet|true}} = [[Wikipedia:Category suppression|Stops this template from categorizing]]. Useful for tests and demonstrations. Dmbox templates should forward {{para|nocat}}, so they too have the option to suppress categories. Thus, it is recommended that Dmbox templates always add something similar to this:
 
::<code><nowiki>nocat = {{{nocat|}}}</nowiki></code>
 
::<code><nowiki>nocat = {{{nocat|}}}</nowiki></code>
  
'''image'''
+
{{Para|image}}
:'''No parameter''' = If no '''image''' parameter is given, the template uses the default disambig or setindex image, depending on the '''type''' parameter.
+
:''<span style="color:gray">[No parameter]</span>'' = If no {{Para|image}} parameter is given, the template uses the default {{para|disambig}} or {{para|setindex}} image, depending on the {{Para|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. (But the message box can handle images of any size.) For example:
+
:''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:
::<code><nowiki>image = [[Image:Shuttle.png|30px]]</nowiki></code>
+
::<code><nowiki>image = [[File:Schooner.svg|30px|link=|alt=]]</nowiki></code>
:'''none''' = Means that no image is used.
+
:<code>none</code> = Means that no image is used.
  
'''imageright'''
+
{{Para|imageright}}
:'''No parameter''' = If no '''imageright''' parameter is given then no image is shown on the right side.
+
:'''No parameter''' = If no {{Para|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. (But the message box can handle images of any size.) For example:
+
:'''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:
::<code><nowiki>imageright = [[Image:Nuvola apps bookcase.png|40px]]</nowiki></code>
+
::<code><nowiki>imageright = [[File:Nuvola apps bookcase.png|40px|alt=Books icon]]</nowiki></code>
 
:'''Anything''' = Any other object that you want to show on the right side.
 
:'''Anything''' = Any other object that you want to show on the right side.
  
'''style'''
+
{{Para|text}}
:Optional [[wpen:Cascading Style Sheets|CSS]] values used by the entire message box table. Without quotation marks <code>" "</code> but with the ending semicolons <code>;</code>. For example:
 
::<code>style = margin-bottom: 0.2em;</code>
 
 
 
'''textstyle'''
 
:Optional [[wpen:Cascading Style Sheets|CSS]] values used by the text cell. For example:
 
::<code>textstyle = text-align: center;</code>
 
 
 
'''text'''
 
 
:The message body text. This message box has ''italic'' text as default, thus no need to manually set that.
 
:The message body text. This message box has ''italic'' text as default, thus no need to manually set that.
  
 
=== Technical details ===
 
=== Technical details ===
This template currently uses hard coded styles and class names. Later it will only use CSS classes making it easier to skin. (In the meantime it can be skinned by using the "<code>!important</code>" keyword.)
 
 
 
If you need to use special characters in the text parameter then you need to escape them like this:  
 
If you need to use special characters in the text parameter then you need to escape them like this:  
  
Zeile 130: Zeile 116:
 
}}
 
}}
 
</pre>
 
</pre>
 
 
{{dmbox
 
{{dmbox
 
| text  = <div>
 
| text  = <div>
Zeile 138: Zeile 123:
 
</div>
 
</div>
 
}}
 
}}
 +
For more technical details see the [[Template talk:Dmbox|talk page]]. Since this template works almost exactly like {{tl|ambox}}, {{tl|tmbox}}, {{tl|imbox}}, {{tl|cmbox}} and {{tl|ombox}} their talk pages and related pages might also contain more details.
  
 
+
===See also===
Internally, this meta-template uses HTML markup instead of wiki markup for the table code. That is the usual way we make meta-templates since wiki markup has several drawbacks. For instance it makes it harder to use [[metawiki:Help:ParserFunctions|parser functions]] and special characters in parameters.
 
 
 
For more technical details see the talk page. Since this template works almost exactly like {{tl|ambox}}, {{tl|tmbox}}, {{tl|imbox}}, {{tl|cmbox}} and {{tl|ombox}} their talk pages and related pages might also contain more details.
 
 
 
=== See also ===
 
 
{{Mbox templates see also}}
 
{{Mbox templates see also}}
  
 
Other pages:
 
Other pages:
 
+
* [[Wikipedia:Disambiguation]], which includes a section explaining [[Wikipedia:Disambiguation#Set index articles|set index articles]].
* [[Wikipedia:Disambiguation]] – Also has a section explaining [[Wikipedia:Disambiguation#Set index articles|set index articles]].
 
 
* [[Wikipedia:WikiProject Disambiguation]]
 
* [[Wikipedia:WikiProject Disambiguation]]
  
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
+
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
+
<!-- Categories below this line, please; interwikis at Wikidata -->
 
[[Category:Message box templates]]
 
[[Category:Message box templates]]
 
[[Category:Exclude in print]]
 
[[Category:Exclude in print]]
}}</includeonly>
+
</includeonly>

Aktuelle Version vom 22. September 2022, 17:42 Uhr

Message box
meta-templates
templatecontext
{{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[Quelltext bearbeiten]

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[Quelltext bearbeiten]

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 sample text.
sample text = 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.).
sample text = Does not trigger the disambig editintro when editing a page. (Because this instead sets the CSS id "setindexbox".)

|nocat=

sample text = 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[Quelltext bearbeiten]

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[Quelltext bearbeiten]

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:


Cookies helfen uns bei der Bereitstellung des ZIM HilfeWikis. Bei der Nutzung vom ZIM HilfeWiki werden die in der Datenschutzerklärung beschriebenen Cookies gespeichert.