Difference between revisions of "Template:Notice/doc"
m (SVG can't be used on this wiki) |
m (Switching to sections to aid modifications, and fixing a small bug) |
||
(7 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{SPW|is not on|name=Notice}} | {{SPW|is not on|name=Notice}} | ||
− | + | <includeonly> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
[[Category:Wikia Help templates]] | [[Category:Wikia Help templates]] | ||
</includeonly><noinclude> | </includeonly><noinclude> | ||
[[Category:Template documentation]] | [[Category:Template documentation]] | ||
</noinclude> | </noinclude> | ||
+ | <dl> | ||
+ | ==<dt>Description</dt>== | ||
+ | <dd>A simple notice box.</dd> | ||
+ | |||
+ | ==<dt>Dependencies</dt>== | ||
+ | <dd> | ||
+ | *Uses [[:File:Gtk-ok.png]] as default image. | ||
+ | *Uses for this documentation: | ||
+ | **{{t|SPW}} = Wikia specific to link back to original. | ||
+ | **{{t|t}} = To show clickable template mentions. | ||
+ | **{{t|para}} = To show parameter usage. | ||
+ | **{{t|-}} and {{t|Lorem ipsum}} = To format the output of the samples. | ||
+ | </dd> | ||
+ | |||
+ | ==<dt>Syntax</dt>== | ||
+ | <dd>Type <code>{{t|Notice|parameters}}</code> somewhere.</dd> | ||
+ | ===<dt>Parameters</dt>=== | ||
+ | <dd> | ||
+ | *<i>Recommended</i>: {{para|type}} | ||
+ | *:Notice box header text. | ||
+ | *:Default: {{para|type|<var>Header text</var>}} | ||
+ | *<i>Recommended</i>: {{para|info}} | ||
+ | *:Notice box additional info. | ||
+ | *:Default: {{para|type|<var>Explanation</var>}} | ||
+ | *<i>Optional</i>: {{para|image}} | ||
+ | *:Notice box symbol image. | ||
+ | *:Provide the image-filename with extension, or use {{para|image|no}} to completely remove/inhibit the image part. | ||
+ | *:Default: {{para|image|<var>Gtk-ok.png</var>}} | ||
+ | *<i>Optional</i>: {{para|imageSize}} | ||
+ | *:Notice box symbol image-size. | ||
+ | *:Provide the image-size including the unit, eg: <code>px</code>, part. | ||
+ | *:Default: {{para|imageSize|<var>50px</var>}} | ||
+ | *<i>Optional</i>: {{para|border}} | ||
+ | *:Notice box left-border-bar definition. | ||
+ | *:Use {{para|border|<var>definition</var>}}, where <code><var>definition</var></code> is a valid custom definition for the [http://www.w3schools.com/cssref/pr_border-left.asp CSS property <code>border-left</code>]. | ||
+ | *:Or use {{para|border|preset}}, where <code>preset</code> is one of the predefined names below<nowiki>:</nowiki> | ||
+ | *:*<span style="background-color:#b22222;"> </span> red ⇒ <code>10px solid #b22222</code> | ||
+ | *:*<span style="background-color:#f28500;"> </span> orange ⇒ <code>10px solid #f28500</code> | ||
+ | *:*<span style="background-color:#f4c430;"> </span> yellow ⇒ <code>10px solid #f4c430</code> | ||
+ | *:*<span style="background-color:#9932cc;"> </span> purple ⇒ <code>10px solid #9932cc</code> | ||
+ | *:*<span style="background-color:#1e90ff;"> </span> blue ⇒ <code>10px solid #1e90ff</code> | ||
+ | *:*<span style="background-color:#228b22;"> </span> green ⇒ <code>10px solid #228b22</code> | ||
+ | *:*<span style="background-color:#bba;"> </span> gray ⇒ <code>10px solid #bba</code> | ||
+ | *:Default: {{para|border|blue}} | ||
+ | *:<i>You don't need to provide the <code>;</code> at the end to properly terminate the definition(s) because it will be appended automatically for proper functionality.</i> | ||
+ | *<i>Optional</i>: {{para|float|side}} | ||
+ | *:Float the Notice box. | ||
+ | *:Where <code>side</code> can be one of: <i>(Case insensitive)</i> | ||
+ | *:*<code>l</code> or <code>left</code> | ||
+ | *:*<code>r</code> or <code>right</code> | ||
+ | *:*<code>n</code> or <code>none</code> | ||
+ | *:When anything else is provided it will be treated as <b><code>none</code></b>. | ||
+ | *:<span style="color:red;"><b>When used</b> it alters the <u>default value</u> for <code>styleWidth</code></span> of {{para|style}}<sup>(see below)</sup> as following when the effective floating is: | ||
+ | *:*left ⇒ <code>25%</code> | ||
+ | *:*right ⇒ <code>25%</code> | ||
+ | *:*none ⇒ <code>50%</code> | ||
+ | *<i>Optional</i>: {{para|style|<var>inline-CSS;</var>}} | ||
+ | *:Completely override the inline-CSS used in the [http://www.w3schools.com/tags/att_global_style.asp style-attribute] of the table that generates the Notice box. | ||
+ | *:Where <code><var>inline-CSS;</var></code> defaults to: | ||
+ | *:<code>font-size:{{{styleFontSize}}}; width:{{{styleWidth}}}; margin:{{{styleMargin}}}; border:{{{styleBorder}}}; border-collapse:{{{styleBorderCollapse}}}; background-color:{{{styleBackgroundColor}}}; border-left:{{{border}}}</code> | ||
+ | *:To override parts of the default shown above you can use: <i>(defaults shown as value)</i> | ||
+ | *:*{{para|styleFontSize|95%}} | ||
+ | *:*{{para|styleWidth|80%}} <i>(Default value is altered when {{para|float}}<sup>(see above)</sup> is used.)</i> | ||
+ | *:*{{para|styleMargin|0 auto}} | ||
+ | *:*{{para|styleBorder|1px #aaa solid}} | ||
+ | *:*{{para|styleBorderCollapse|collapse}} | ||
+ | *:*{{para|styleBackgroundColor|#eee}} | ||
+ | </dd> | ||
+ | |||
+ | ==<dt>Sample output</dt>== | ||
+ | <dd><dl> | ||
+ | ===Sample:1=== | ||
+ | <dt style="font-family:monospace,Courier; font-weight:normal; border:2px solid teal; border-radius:1em;"> | ||
+ | <nowiki>{{Notice|type=Notice box|info=Does not use the {{t|Ambox}} template and could be considered a simpler alternative, since it doesn't have a CSS dependency.}}</nowiki> | ||
+ | </dt> | ||
+ | <dd>gives...</dd> | ||
+ | <dd style="border:2px solid teal; border-radius:1em;">{{Notice|type=Notice box|info=Does not use the {{t|Ambox}} template and could be considered a simpler alternative, since it doesn't have a CSS dependency.}}</dd> | ||
+ | ===Sample:2=== | ||
+ | <dt style="font-family:monospace,Courier; font-weight:normal; border:2px solid teal; border-radius:1em;"> | ||
+ | <nowiki>{{Notice|styleWidth=50%|type=Notice box|info={{Lorem ipsum|1|&ldquo;|&rdquo;}} }}</nowiki> | ||
+ | </dt> | ||
+ | <dd>gives...</dd> | ||
+ | <dd style="border:2px solid teal; border-radius:1em;">{{Notice|styleWidth=50%|type=Notice box|info={{Lorem ipsum|1|“|”}} }}</dd> | ||
+ | ===Sample:3=== | ||
+ | <dt style="font-family:monospace,Courier; font-weight:normal; border:2px solid teal; border-radius:1em;"> | ||
+ | <nowiki>{{Lorem ipsum|1|&ldquo;|&rdquo;}}</nowiki><br/> | ||
+ | <nowiki>{{Notice|float=N|type=Notice box|info={{Lorem ipsum|1|&ldquo;|&rdquo;}} }}</nowiki><br/> | ||
+ | <nowiki>{{Lorem ipsum|2|&ldquo;|&rdquo;}}{{-}}</nowiki> | ||
+ | </dt> | ||
+ | <dd>gives...</dd> | ||
+ | <dd style="border:2px solid teal; border-radius:1em;">{{Lorem ipsum|1|“|”}} | ||
+ | {{Notice|float=N|type=Notice box|info={{Lorem ipsum|1|“|”}} }} | ||
+ | {{Lorem ipsum|2|“|”}}{{-}}</dd> | ||
+ | ===Sample:4=== | ||
+ | <dt style="font-family:monospace,Courier; font-weight:normal; border:2px solid teal; border-radius:1em;"> | ||
+ | <nowiki>{{Lorem ipsum|1|&ldquo;|&rdquo;}}</nowiki><br/> | ||
+ | <nowiki>{{Notice|float=Left|type=Notice box|info={{Lorem ipsum|1|&ldquo;|&rdquo;}} }}</nowiki><br/> | ||
+ | <nowiki>{{Lorem ipsum|2|&ldquo;|&rdquo;}}{{-}}</nowiki> | ||
+ | </dt> | ||
+ | <dd>gives...</dd> | ||
+ | <dd style="border:2px solid teal; border-radius:1em;">{{Lorem ipsum|1|“|”}} | ||
+ | {{Notice|float=Left|type=Notice box|info={{Lorem ipsum|1|“|”}} }} | ||
+ | {{Lorem ipsum|2|“|”}}{{-}}</dd> | ||
+ | ===Sample:5=== | ||
+ | <dt style="font-family:monospace,Courier; font-weight:normal; border:2px solid teal; border-radius:1em;"> | ||
+ | <nowiki>{{Lorem ipsum|1|&ldquo;|&rdquo;}}</nowiki><br/> | ||
+ | <nowiki>{{Notice|float=Right|type=Notice box|info={{Lorem ipsum|1|&ldquo;|&rdquo;}} }}</nowiki><br/> | ||
+ | <nowiki>{{Lorem ipsum|2|&ldquo;|&rdquo;}}{{-}}</nowiki> | ||
+ | </dt> | ||
+ | <dd>gives...</dd> | ||
+ | <dd style="border:2px solid teal; border-radius:1em;">{{Lorem ipsum|1|“|”}} | ||
+ | {{Notice|float=Right|type=Notice box|info={{Lorem ipsum|1|“|”}} }} | ||
+ | {{Lorem ipsum|2|“|”}}{{-}}</dd> | ||
+ | |||
+ | </dl></dd> | ||
+ | |||
+ | ==<dt>See also</dt>== | ||
+ | <dd> | ||
+ | *{{t|Ambox}} | ||
+ | </dd> | ||
+ | |||
+ | </dl> |
Latest revision as of 07:11, 29 April 2016
This template was copied from Template:Notice on Wikia Templates. That wiki should periodically be checked for a new version of this template. |
- Description
- A simple notice box.
- Dependencies
-
- Uses File:Gtk-ok.png as default image.
- Uses for this documentation:
- {{SPW}} = Wikia specific to link back to original.
- {{t}} = To show clickable template mentions.
- {{para}} = To show parameter usage.
- {{-}} and {{Lorem ipsum}} = To format the output of the samples.
- Syntax
- Type
{{Notice|parameters}}
somewhere. - Parameters
-
- Recommended:
|type=
- Notice box header text.
- Default:
|type=Header text
- Recommended:
|info=
- Notice box additional info.
- Default:
|type=Explanation
- Optional:
|image=
- Notice box symbol image.
- Provide the image-filename with extension, or use
|image=no
to completely remove/inhibit the image part. - Default:
|image=Gtk-ok.png
- Optional:
|imageSize=
- Notice box symbol image-size.
- Provide the image-size including the unit, eg:
px
, part. - Default:
|imageSize=50px
- Optional:
|border=
- Notice box left-border-bar definition.
- Use
|border=definition
, wheredefinition
is a valid custom definition for the CSS propertyborder-left
. - Or use
|border=preset
, wherepreset
is one of the predefined names below:- red ⇒
10px solid #b22222
- orange ⇒
10px solid #f28500
- yellow ⇒
10px solid #f4c430
- purple ⇒
10px solid #9932cc
- blue ⇒
10px solid #1e90ff
- green ⇒
10px solid #228b22
- gray ⇒
10px solid #bba
- red ⇒
- Default:
|border=blue
- You don't need to provide the
;
at the end to properly terminate the definition(s) because it will be appended automatically for proper functionality.
- Optional:
|float=side
- Float the Notice box.
- Where
side
can be one of: (Case insensitive)l
orleft
r
orright
n
ornone
- When anything else is provided it will be treated as
none
. - When used it alters the default value for
styleWidth
of|style=
(see below) as following when the effective floating is:- left ⇒
25%
- right ⇒
25%
- none ⇒
50%
- left ⇒
- Optional:
|style=inline-CSS;
- Completely override the inline-CSS used in the style-attribute of the table that generates the Notice box.
- Where
inline-CSS;
defaults to: font-size:{{{styleFontSize}}}; width:{{{styleWidth}}}; margin:{{{styleMargin}}}; border:{{{styleBorder}}}; border-collapse:{{{styleBorderCollapse}}}; background-color:{{{styleBackgroundColor}}}; border-left:{{{border}}}
- To override parts of the default shown above you can use: (defaults shown as value)
|styleFontSize=95%
|styleWidth=80%
(Default value is altered when|float=
(see above) is used.)|styleMargin=0 auto
|styleBorder=1px #aaa solid
|styleBorderCollapse=collapse
|styleBackgroundColor=#eee
- Recommended:
- Sample output
- {{Notice|type=Notice box|info=Does not use the {{t|Ambox}} template and could be considered a simpler alternative, since it doesn't have a CSS dependency.}}
- gives...
Notice box Does not use the {{Ambox}} template and could be considered a simpler alternative, since it doesn't have a CSS dependency.- {{Notice|styleWidth=50%|type=Notice box|info={{Lorem ipsum|1|“|”}} }}
- gives...
-
{{Lorem ipsum|1|“|”}}
{{Notice|float=N|type=Notice box|info={{Lorem ipsum|1|“|”}} }}
{{Lorem ipsum|2|“|”}}{{-}} - gives...
- “Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.”
“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.”
“Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.”
-
{{Lorem ipsum|1|“|”}}
{{Notice|float=Left|type=Notice box|info={{Lorem ipsum|1|“|”}} }}
{{Lorem ipsum|2|“|”}}{{-}} - gives...
- “Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.”
“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.”
“Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.”
-
{{Lorem ipsum|1|“|”}}
{{Notice|float=Right|type=Notice box|info={{Lorem ipsum|1|“|”}} }}
{{Lorem ipsum|2|“|”}}{{-}} - gives...
- “Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.”
“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.”
“Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.”
Sample:1
Sample:2
Sample:3
Sample:4
Sample:5
- See also
-
- {{Ambox}}