Difference between revisions of "Template:Sign/Documentation"

From GodWiki
Jump to: navigation, search
m (Created page with "<noinclude> {{PAGENAME}}</noinclude> '''The Usage of this Template''' == Description == Parameters: *'''Title''' - the title (default: no ti…")
 
m
 
(39 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<noinclude> [[Category:Templates/Documents|{{PAGENAME}}]]</noinclude>
+
==Parameters==
'''The Usage of this Template'''  
+
===Global parameters===
== Description ==
+
; {{para|title}} : ''Optional'' - The title in '''bold''' of the sign (default: no title)
 +
 +
; {{para|text}} :  ''Required'' - The text content of the sign (default: a mess of lorem ipsum)
  
Parameters:  
+
; {{para|bgcolor|<var>Valid CSS color string</var>}} : ''Optional'' - The background color (default: <code>#fefefe</code>)
*'''Title''' - the title (default: no title)  
+
*'''Text''' - text (default: a mess of lorem ipsum)
+
; {{para|bordercolor|<var>Valid CSS color string</var>}} : ''Optional'' - The color of the left border (default: <code>#999</code>)
*'''Bgcolor''' - the background color in RGB format with no sign of # (default: fefefe)
+
*'''Bordercolor''' - Border color of the left (for harmony with the picture and the background; default: 999)  
+
; {{para|outerbordercolor|<var>Valid CSS color string</var>}} : ''Optional'' - The color of the top, right and bottom borders (default: <code>#AAB</code>)  
*'''Outerbordercolor''' - color of the top, right and bottom Boarders (default: AAB)
 
*'''Img''' - a picture without the prefix "Image:» (default: Important.png)
 
*'''Imgwidth''' - for non-standard images. It is advisable not to touch (default: 64)
 
*'''Cat''' - the category without the prefix "Category:» (default: none). Do not use directly in other patterns, otherwise the template will get this same category
 
*'''Height''' - the height of the template (default: auto)
 
*'''Width''' - the width of the template (default: 80%)
 
*'''Interval''' - the bottom margin in pixels (default: 1)  
 
  
 +
=== Picture parameters===
  
== Example ==
+
; {{para|img|<var>filename</var>}} : ''Optional'' - An image filename (default: <code>Important.png</code>)
  
<nowiki>
+
;{{para|imgwidth|<var>Valid width in <code>px</code> pixel units</var>}} : ''Optional'' - For non-standard images. (default: <code>64px</code>)
{{Die 
+
| Title = What a nice example!
+
;{{para|image-align}} : ''Optional'' - Override image <code>vertical-align</code> parameter: <code>top</code>, <code>bottom</code>, etc. (default: <code>middle</code>)
| Text = [[User:Spode|Spode]] is clearly a genius.
 
| Height = 80
 
| Bgcolor = C0C0C0
 
| Bordercolor = 404040
 
| Outerbordercolor = 000000
 
| Img = Napilnik.jpg
 
| Imgwidth = 64
 
}}</Nowiki>  
 
  
 +
;{{para|link|<var>Name of the targeted page</var>}} : ''Optional'' - the link of the picture of the <code>|img </code> parameter become the specified target.
 +
:* If the parameter is not called at all in the template, the link will be <code>File:<filename></code> by default.
 +
:* If the parameter is called but no target is provided (<code>link=</code>), the linking will be turn off.
  
Results in
+
;{{para|emoji|<var>Any emoji</var>}} : ''Optional'' - Display an emoji instead of the image.
 +
:* If an emoji is used, the picture will not be displayed even if <code>|img=</code> is used.
  
{{Die 
+
;{{para|emojiwidth|<var>X%</var>}} : ''Optional'' - The width of the emoji in percent (default: 300%)
| Title = What a nice example!
+
 
| Text = [[User:Spode|Spode]] is clearly a genius.
+
===Advanced parameters===
| Height = 80
+
 
| Bgcolor = C0C0C0
+
; {{para|height}} : ''Optional'' - the height of the template in CSS units (<code>rem</code>, <code>em</code>, <code>px</code>, etc.) (default: <code>auto</code>)
| Bordercolor = 404040
+
 
| Outerbordercolor = 000000
+
; {{para|width}} : ''Optional'' - the width of the template in CSS units (<code>rem</code>, <code>em</code>, <code>px</code>, etc.) (default: <code>100%</code>)
| Img = Fo55555.gif
+
 
| Imgwidth = 64
+
; {{para|interval}} : ''Optional'' - the bottom margin for the sign template in CSS units (<code>rem</code>, <code>em</code>, <code>px</code>, etc.) (default: <code>0.2rem</code>)
 +
 
 +
; {{para|style}} : ''Optional'' - any general CSS style parameters to be added to the table style. Takes valid CSS. End with a semicolon (<code>;</code>), '''DO NOT''' include quotation marks.
 +
 
 +
== Examples ==
 +
<pre><nowiki>
 +
{{Sign
 +
| title = What a nice example!
 +
| text = [[User:Spode|Spode]] is clearly a genius
 +
| bgcolor = #abcdef
 +
| img = Imbox notice.png
 +
| outerbordercolor = red
 +
| bordercolor = green
 +
| width = 50%
 +
}}
 +
</Nowiki></pre>
 +
'''Results in:'''
 +
{{Sign
 +
| title = What a nice example!
 +
| text = [[User:Spode|Spode]] is clearly a genius
 +
| bgcolor = #abcdef
 +
| img = Imbox notice.png
 +
| outerbordercolor = red
 +
| bordercolor = green
 +
| width = 50%
 +
}}
 +
<br>
 +
----
 +
----
 +
 
 +
<pre><nowiki>
 +
{{Sign
 +
| title = Another example
 +
| link= Template:Sign/Documentation
 +
| text = The picture will link to the documentation of this template
 +
| bgcolor = silver
 +
| outerbordercolor = black
 +
| bordercolor = purple
 +
| width = 50%
 
}}
 
}}
 +
</Nowiki></pre>
 +
  
 +
'''Results in:'''
  
 +
{{Sign
 +
| title = Another example
 +
| link= Template:Sign/Documentation
 +
| text = The picture's link will lead to the documentation of this template.
 +
| bgcolor = silver
 +
| outerbordercolor = black
 +
| bordercolor = purple
 +
| width = 50%
 +
}}
 +
 +
----
 +
----
 +
 +
<pre><nowiki>
 +
{{Sign
 +
| title = No link example
 +
| link=
 +
| text = The picture's linking is desactivated with <code>link=</code>
 +
| bgcolor = MediumSeaGreen
 +
| outerbordercolor = black
 +
| bordercolor = red
 +
| width = 50%
 +
}}
 +
</Nowiki></pre>
 +
 +
'''Results in:'''
 +
 +
{{Sign
 +
| title = No link example
 +
| link=
 +
| text = The picture's linking is desactivated with <code>link=</code>
 +
| bgcolor = MediumSeaGreen
 +
| outerbordercolor = black
 +
| bordercolor = red
 +
| width = 50%
 +
}}
 +
 +
----
 +
----
 +
 +
<pre><nowiki>
 +
{{Sign
 +
| title = Emoji example
 +
| emoji = 🐈
 +
| img = Example.jpg
 +
| text = Despite the image parameter being used, only the cat emoji is displayed.
 +
| bgcolor = Salmon
 +
| outerbordercolor = black
 +
| bordercolor = Blue
 +
| width = 50%
 +
}}
 +
</Nowiki></pre>
 +
 +
'''Results in:'''
 +
 +
{{Sign
 +
| title = Emoji example
 +
| emoji = 🐈
 +
| img = Example.jpg
 +
| text = Despite the image parameter being used, only the cat emoji is displayed.
 +
| bgcolor = Salmon
 +
| outerbordercolor = black
 +
| bordercolor = Blue
 +
| width = 50%
 +
}}
  
<!-- <noinclude>[[Category:Template:Documentation]]</noinclude> -->
+
<noinclude> [[Category:Templates/Documents|{{PAGENAME}}]]</noinclude>

Latest revision as of 13:00, 18 December 2019

Parameters

Global parameters

|title= 
Optional - The title in bold of the sign (default: no title)
|text= 
Required - The text content of the sign (default: a mess of lorem ipsum)
|bgcolor=Valid CSS color string 
Optional - The background color (default: #fefefe)
|bordercolor=Valid CSS color string 
Optional - The color of the left border (default: #999)
|outerbordercolor=Valid CSS color string 
Optional - The color of the top, right and bottom borders (default: #AAB)

Picture parameters

|img=filename 
Optional - An image filename (default: Important.png)
|imgwidth=Valid width in px pixel units 
Optional - For non-standard images. (default: 64px)
|image-align= 
Optional - Override image vertical-align parameter: top, bottom, etc. (default: middle)
|link=Name of the targeted page 
Optional - the link of the picture of the |img parameter become the specified target.
  • If the parameter is not called at all in the template, the link will be File:<filename> by default.
  • If the parameter is called but no target is provided (link=), the linking will be turn off.
|emoji=Any emoji 
Optional - Display an emoji instead of the image.
  • If an emoji is used, the picture will not be displayed even if |img= is used.
|emojiwidth=X% 
Optional - The width of the emoji in percent (default: 300%)

Advanced parameters

|height= 
Optional - the height of the template in CSS units (rem, em, px, etc.) (default: auto)
|width= 
Optional - the width of the template in CSS units (rem, em, px, etc.) (default: 100%)
|interval= 
Optional - the bottom margin for the sign template in CSS units (rem, em, px, etc.) (default: 0.2rem)
|style= 
Optional - any general CSS style parameters to be added to the table style. Takes valid CSS. End with a semicolon (;), DO NOT include quotation marks.

Examples

{{Sign 
| title = What a nice example!
| text = [[User:Spode|Spode]] is clearly a genius
| bgcolor = #abcdef
| img = Imbox notice.png
| outerbordercolor = red
| bordercolor = green
| width = 50%
}}

Results in:

Imbox notice.png

What a nice example!

Spode is clearly a genius




{{Sign 
| title = Another example
| link= Template:Sign/Documentation
| text = The picture will link to the documentation of this template
| bgcolor = silver
| outerbordercolor = black
| bordercolor = purple
| width = 50%
}}


Results in:

Important.png

Another example

The picture's link will lead to the documentation of this template.


{{Sign 
| title = No link example
| link= 
| text = The picture's linking is desactivated with <code>link=</code>
| bgcolor = MediumSeaGreen
| outerbordercolor = black
| bordercolor = red
| width = 50%
}}

Results in:

Important.png

No link example

The picture's linking is desactivated with link=


{{Sign 
| title = Emoji example
| emoji = 🐈
| img = Example.jpg
| text = Despite the image parameter being used, only the cat emoji is displayed.
| bgcolor = Salmon
| outerbordercolor = black
| bordercolor = Blue
| width = 50%
}}

Results in:

🐈

Emoji example

Despite the image parameter being used, only the cat emoji is displayed.