Template:Notice/doc: Difference between revisions
meta>Steel1943 →See also: removed all of the rest of the wikilinks - rest actually were for Template:Ambox |
meta>Sardanaphalus casing, removed heading, some text compression/rephrasing, code formatting, "image"→"file", Lorem ipsum, missing demospace |
||
Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE | <!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE AND INTERWIKIS TO WIKIDATA --> | ||
This is the {{tl|Notice}} message box. It should be used '''sparingly''' and only for '''significant''' information for which a more specific template doesn't exist. <!--[Also used in other namespaces:] Less important comments should as usual be put as text on the article's talk page instead. | |||
This is the {{tl| | |||
This | This message box can also be used on other pages, such as on the top of talk or project pages. There it can be used in a more relaxed way.--> | ||
This | This box automatically changes its style depending on what kind of page it appears; see {{tl|Mbox}} for details. | ||
===Articles=== | |||
== | : <code><nowiki>{{Notice |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}}</nowiki></code> produces: | ||
{{Notice|demospace=main|style=margin-bottom:1.0em; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
The box can be titled with an optional {{para|heading}} (or {{para|header}}) and {{para|style|text-align:center;}} can be added to center the text below it: | |||
: <code><nowiki>{{Notice |heading=Heading |style=text-align:center; |[[Lorem ipsum|Lorem ipsum </nowiki>''(etc)'']]}}</code> produces: | |||
{{Notice|demospace=main|style=margin-bottom:1.0em; |heading=Heading |style=text-align:center; |[[Lorem ipsum|Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.]]}} | |||
The message box can also take an {{para|image}} parameter, but this is discouraged in articles. For an example of its use, see below. | |||
{{ | |||
===Talk pages=== | |||
{{Notice|demospace= | On talk pages, <code><nowiki>{{Notice |Lorem ipsum </nowiki>''(etc)''}}</code> produces: | ||
{{Notice|demospace=talk|style=margin-bottom:1.0em; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
{{para||heading}}/{{para||header}} also works, as well as setting the talkpage-only parameter {{para|small|yes}}, which alters the template's appearance thus: | |||
{{Notice|demospace=talk|style=margin-bottom:1.0em; |small=yes |header=Header |style=text-align:center; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
: <code><nowiki>{{Notice |small=yes |header=Header |style=text-align:center; |Lorem ipsum </nowiki>''(etc)''}}</code> produces ...... | |||
{{clear}} | |||
Setting the {{para|image}} parameter changes the image shown on the lefthand side of the template. | |||
: <code><nowiki>{{Notice |image=Stop hand nuvola.svg |heading=Heading |Lorem ipsum </nowiki>''(etc)''}}</code> produces: | |||
{{Notice|demospace=talk|style=margin-bottom:1.0em; |image=Stop hand nuvola.svg |heading=Heading |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
(Note the effect of omitting {{para|style|text-align:center;}} here) | |||
===File and category pages=== | |||
<code><nowiki>{{Notice |Lorem ipsum </nowiki>''(etc)''}}</code> on a File: page would produce... {{Notice|demospace=image<!--file?-->|style=margin-bottom:1.0em; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} ... and, on a Category: page, would produce: {{Notice|demospace=category|style=margin-bottom:1.0em; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
===Other pages=== | |||
On other pages, such as those in the [[Wikipedia:User pages|User:]], [[Wikipedia:Wikipedia namespace|Wikipedia:]] and [[Wikipedia:Help namespace|Help:]] [[Wikipedia:Namespaces|namespaces]], <code><nowiki>{{Notice |Lorem ipsum </nowiki>''(etc)''}}</code> would produce: | |||
{{Notice|demospace=wikipedia|style=margin-bottom:1.0em; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
===External links and equals signs=== | |||
In most cases, external links can be used in the template without any complications. If a link{{aside|or any text}} contains one or more equals signs ("{{padlr|=}}"), however, everything before the first sign will be interpreted as the name of a parameter. To prevent this, name the text carrying the link as the first numbered parameter: | |||
: <code><nowiki>{{Notice |1=Any text/links including "=" should now be interpreted correctly.}}</nowiki></code> produces: | |||
{{Notice|style=margin-bottom:1.0em; |1=Any text/links including "=" should now be interpreted correctly.}} | |||
===Adding an image, shortcuts, etc on the righthand side=== | |||
=== | To add shortcuts, images, other templates, etc to the righthand side of the template, use {{para|imageright}}. For example, {{plaincode|<nowiki>{{Notice |imageright=[[File:Wiki letter w.svg|40px]] |Lorem ipsum </nowiki>''(etc)''<nowiki>}}</nowiki>}} produces: | ||
{{Notice|style=margin-bottom:1.0em; |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |imageright=[[File:Wiki letter w.svg|40px]]}} | |||
{{plaincode|<nowiki>{{Notice |imageright={{Shortcuts|You|Me}} |Lorem ipsum </nowiki>''(etc)''<nowiki>}}</nowiki>}} includes the {{tl|Shortcut}}s template providing links to [[You]] and [[Me]]: | |||
{{Notice|style=margin-bottom:1.0em; |imageright={{Shortcuts|You|Me}} |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
{{ | |||
< | |||
{{ | |||
{{ | |||
</ | |||
====Alternate shortcut option==== | ====Alternate shortcut option==== | ||
As an alternative to imageright, the {{para|shortcut}} (or {{para|shortcut1}}) and {{para|shortcut''N''}} parameters (where {{nowrap|N = 2}} to 5) may be used to display shortcuts. For instance, {{plaincode|<nowiki>{{Notice |shortcut1=Me |shortcut2=You |shortcut3=Them |shortcut4=Us |shortcut5=Everyone |Lorem ipsum </nowiki>''(etc)''<nowiki>}}</nowiki>}} produces: | |||
{{Notice|style=margin-bottom:1.0em; |shortcut1=Me |shortcut2=You |shortcut3=Them |shortcut4=Us |shortcut5=Everyone |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
''Note: If both imageright and any of the shorcut parameters are used, the contents of imageright will override the shortcut/s.''<br/>For example, {{plaincode|<nowiki>{{Notice |imageright=[[File:Wiki letter w.svg|40px]] |shortcut1=Me |shortcut2=You |shortcut3=Them |shortcut4=Us |shortcut5=Everyone |Lorem ipsum </nowiki>''(etc)''<nowiki>}}</nowiki>}} produces: | |||
{{Notice|style=margin-bottom:1.0em; |imageright=[[File:Wiki letter w.svg|40px]] |shortcut1=Me |shortcut2=You |shortcut3=Them |shortcut4=Us |shortcut5=Everyone |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}} | |||
{{ | |||
== See also == | == See also == | ||
* {{tl| | * {{tl|Consensus}} for notices relating to [[Wikipedia:Consensus|consensus]] about methods, procedures, editing, etc. | ||
* {{tl| | * {{tl|Warning}} for important warnings. | ||
* {{tl| | ** {{tl|Blackboxwarning}} for extremely important situations. | ||
* {{tl| | * {{tl|Caution}} for messages indicating e.g. that errors or misuse may have wide repercussions. | ||
* {{tl| | * {{tl|Ambox}}, the generic article [[Template:Mbox|messagebox]]. | ||
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | | |||
[[Category:Notice and warning templates | | <!-- CATEGORIES BELOW THIS LINE PLEASE; INTERWIKIS AT WIKIDATA --> | ||
[[Category:Notice and warning templates]] | |||
[[Category:Talk header templates]] | |||
<!--[[labconsole:Template:Notice]]--> | <!--[[labconsole:Template:Notice]]--> | ||
}}</includeonly> | }}</includeonly> |
Revision as of 12:13, 5 December 2014
This is a documentation subpage for Template:Notice. It may contain usage information, categories and other content that is not part of the original template page. |
This is the {{Notice}} message box. It should be used sparingly and only for significant information for which a more specific template doesn't exist.
This box automatically changes its style depending on what kind of page it appears; see {{Mbox}} for details.
Articles
{{Notice |Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.}}
produces:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
The box can be titled with an optional |heading=
(or |header=
) and |style=text-align:center;
can be added to center the text below it:
{{Notice |heading=Heading |style=text-align:center; |[[Lorem ipsum|Lorem ipsum (etc)]]}}
produces:
The message box can also take an |image=
parameter, but this is discouraged in articles. For an example of its use, see below.
Talk pages
On talk pages, {{Notice |Lorem ipsum (etc)}}
produces:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
|heading
/|header
also works, as well as setting the talkpage-only parameter |small=yes
, which alters the template's appearance thus:
Header Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
{{Notice |small=yes |header=Header |style=text-align:center; |Lorem ipsum (etc)}}
produces ......
Setting the |image=
parameter changes the image shown on the lefthand side of the template.
{{Notice |image=Stop hand nuvola.svg |heading=Heading |Lorem ipsum (etc)}}
produces:
File:Stop hand nuvola.svg | Heading Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
(Note the effect of omitting |style=text-align:center;
here)
File and category pages
{{Notice |Lorem ipsum (etc)}}
on a File: page would produce...
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
... and, on a Category: page, would produce:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
Other pages
On other pages, such as those in the User:, Wikipedia: and Help: namespaces, {{Notice |Lorem ipsum (etc)}}
would produce:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
External links and equals signs
In most cases, external links can be used in the template without any complications. If a linkTemplate:Aside contains one or more equals signs ("Template:Padlr"), however, everything before the first sign will be interpreted as the name of a parameter. To prevent this, name the text carrying the link as the first numbered parameter:
{{Notice |1=Any text/links including "=" should now be interpreted correctly.}}
produces:
Any text/links including "=" should now be interpreted correctly. |
Adding an image, shortcuts, etc on the righthand side
To add shortcuts, images, other templates, etc to the righthand side of the template, use |imageright=
. For example, Template:Plaincode produces:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
Template:Plaincode includes the {{Shortcut}}s template providing links to You and Me:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. | Template:Shortcuts |
Alternate shortcut option
As an alternative to imageright, the |shortcut=
(or |shortcut1=
) and |shortcutN=
parameters (where {{{1}}} to 5) may be used to display shortcuts. For instance, Template:Plaincode produces:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
Note: If both imageright and any of the shorcut parameters are used, the contents of imageright will override the shortcut/s.
For example, Template:Plaincode produces:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
See also
- {{Consensus}} for notices relating to consensus about methods, procedures, editing, etc.
- {{Warning}} for important warnings.
- {{Blackboxwarning}} for extremely important situations.
- {{Caution}} for messages indicating e.g. that errors or misuse may have wide repercussions.
- {{Ambox}}, the generic article messagebox.