Userbadge
(→Using tables) |
m (→Using the Userboxes template) |
||
Line 118: | Line 118: | ||
|} | |} | ||
- | + | == Using the Userboxes template == | |
{{Userboxes|align=right|toptext=Example 1 | {{Userboxes|align=right|toptext=Example 1 | ||
{{Userbadge/irssi}} | {{Userbadge/irssi}} |
Revision as of 19:30, 1 October 2008
A userbadge is a small colored box (see examples to the right) designed to appear on a DareNET Wiki user's page as a communicative notice about the user.
In This Guide: |
Using Existing Userbadges
Userbadges are for the use of users on their own user pages. It is considered uncivil to place any userbadges on any other user's page(s) without their permission. However, userboxes may be placed on non-mainspace talk/discussion pages by anyone.
Syntax
The standard syntax for adding a userbadge to your user page (also known as transclusion) is:
{{Userbadge/name_of_badge}}
Optional Substitution
You may decide to substitute the template code onto your user page using the syntax {{subst:Userbage/name_of_box}}. The use of "subst:" will ensure that the template is always displayed in its form when you add it to your user page, i.e. it will not reflect subsequent edits to the template. This method will lead to large amounts of code on your user page.
Constructing a Userbadge
How to construct the box
There are a number of box types to select from when deciding to make a userbadge. The most commonly used design is the "Standard box". It has one square shaped area on the left ("id") and a rectangular area on the right ("info").
For ease of use, userbadges are made using maker-templates that have a number of parameters. Once the maker-template is saved, it is automatically transformed to HTML.
Template Parameters | Meaning | Value type |
---|---|---|
border-c | The border color of the userbox. | CSS color value (#hex or color name) |
border-s | The border size of the userbox. | Width in pixels |
id-c | The background color of the id box. | CSS color value |
id-s | The font size of the id box. | Size in PostScript points |
id-fc | The font color of the id box text. | CSS color value |
id-p | The distance between border and content of id box. | CSS padding width value. px, pt |
id-lh | The distance between text lines of id box. | CSS relative line height/length value. em |
info-c | The background color of info box. | CSS color value |
info-s | The font size of info box. | Size in PostScript points |
info-fc | The font color of info box. | CSS color value |
info-p | The distance between border and content of info box. | CSS padding width value. px, pt |
info-lh | The distance between text lines of info box. | CSS relative line height/length value. em |
id | This is the content of the id box. | Free-form |
info | This is the content of info box. | Free-form |
The id and info boxes can include text, links, and images using the usual wiki syntax. Generally, the id box will contain a few letters or a 43px image, while the info box will contain a sentence with a link or two.
Userbadge types
Code | Appearance | |||
---|---|---|---|---|
Standard box | ||||
{{Userbox |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |info-c=#039 |info-s=8 |info-fc=#fff |id=ID |info=Content}}
or {{Userbox |side-box colour |main box colour |side-box content |main box content}} |
| |||
Reverse box | ||||
{{Userbox-r |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |info-c=#039 |info-s=8 |info-fc=#fff |id=ID |info=Content}}
or {{Userbox-r |side-box colour |main box colour |side-box content |main box content}} |
| |||
Double box | ||||
{{Userbox-2 |border-c=#000 |border-s=1 |id1-c=#fff |id1-s=12 |id1-fc=#000 |id2-c=#000 |id2-s=12 |id2-fc=#fff |info-c=#039 |info-s=8 |info-fc=#fff |id1=ID 1 |id2=ID 2 |info=Content}}
or {{Userbox-2 |side-box 1 colour |main box colour |side-box 1 content |message |side-box 2 content |border colour |side-box 2 colour |main box font-colour |box border thickness}}
|
| |||
Mini box | ||||
{{Userbox-m |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |id=ID}}
or {{Userbox-m |box colour |box content}} |
|
Using the Userboxes template
Example 1
|
There is a box to group userbadges together. For example, the box to the right is created using the following list:
{{Userboxes|align=right|toptext=Example 1}}
{{Userbadge/irssi}}
{{Userbadge/firefox_user}}}}
NOTE: The extra }} at the end of the last basge. They're the closing tags for the grouping box.
Using tables
Another alternative would be to use a table for your userbadges.
For example:
{| style="margin: 1em auto 1em auto" | {{Userbadge/irssi}} {{Userbadge/friendly}} |- | {{Userbadge/pillage}} {{Userbadge/ps cs3}} |}
Would produce the following:
| ||