User:Willscrlt/UBX/ClanBox/doc

User:Willscrlt/UBX/ClanBox and User:Willscrlt/UBX/Clan are interrelated userbox templates for displaying your Scottish clan affiliation on your user page.

User:Willscrlt/UBX/ClanBox is a customized userbox that is preformatted to display the text "This user is of Clan ___" on a dark leather-brown background. There is room for up to two images, with the intention of having the clan badge or crest appear on the left, and the clan tartan appear on the right. If no left image is specified, the word "Clan" will appear instead. There is also room to provide your sept and the clan motto. All the usual userbox attributes (border, background, and text colors and sizes, etc.) are overrideable if you dislike the default choices.

User:Willscrlt/UBX/Clan is a "smart" userbox that requires one attribute, your last name (actually, your clan or sept name if your last name is different), and tries to determine all of the information needed to determine your clan, sept, badge or crest, tartan, and motto for you automagically. If your clan or sept is not recognized by the template, then you should use the generic ClanBox template instead. The other alternative is to edit the Clan template and add your clan and sept information to the template so it is recognized, which would help other people, too. To do it's "magic", the Clan template uses parser functions and other esoteric template logic. Please test your changes in a sandbox before committing them to the live template to be sure your updates do not break anything. 

Clan - For recognized clan names
This template currently only recognizes the clans and septs of Clan Cameron, Clan Campbell, Clan Murray, and Clan Spalding. Simply enter your last name (or the name of your clan or sept if your last name is different), and the userbox should display the correct information. If not, you can override it using the attributes shown for ClanBox below. &#123;User:Willscrlt/UBX/Clan&#124;Name of clan only}&#125;

ClanBox - For all other clan names
This only works when the article is named "Clan Name". Enter just the name of the clan, without the word "Clan", and do not wikilink it. Sept names are not recognized unless they have their own article titled "Clan Name". &#123;{User:Willscrlt/UBX/ClanBox &#124; clan = Name }&#125;
 * Super-simple

See the next section for details on each attribute. All attributes, except  are optional. &#123;{User:Willscrlt/UBX/ClanBox &#124; clan     = &#124; article  = &#124; sept     = &#124; motto    = &#124; img1     = &#124; img1-s   = &#124; img2     = &#124; img2-s   = &#124; border2-c = }&#125;
 * Standard attributes

To override any default used by either template, add as many of the following custom attributes as you like. All attributes, except  are optional. &#123;{User:Willscrlt/UBX/ClanBox &#124; clan     = Name of clan (without the word "Clan"); do not wikilink it &#124; article  = Article name only if not "Clan __"; do not wikilink it &#124; sept     = Sept name if applicable; can be wikilinked &#124; motto    = the motto; can be wikilinked &#124; img1     = left image (usually the clan badge or crest); do not include "File:" &#124; img1-s   = left image width in pixels (px) (optional, defaults to 40) &#124; img2     = right image (usually the clan tartan); do not include "File:" &#124; img2-s   = right image width in pixels (px) (optional, defaults to 40) &#124; border2-c = border color around right image (optional, defaults to no border) &#124; border-c = border color for the userbox (optional, defaults to dark brown) &#124; id-c     = background color for the left image (optional, defaults to brown) &#124; id2-c    = background color for the right image (optional, defaults to brown) &#124; info-c   = background color for the center text (optional, defaults to brown) &#124; id-fc    = text color for the left image area if no image (opt., def=tan) &#124; id2-fc   = text color for the right image area if no image (opt., def=tan) &#124; info-fc  = text color for the center text (optional, defaults to goldenrod) &#124; link-fc  = linked text color for the center text (optional, defaults to gold) &#124; id-s     = text size in points (pt) for the left if no image (opt., def=12) &#124; id2-s    = text size in points (pt) for the right if no image (opt., def=12) &#124; info-s   = text size in points (pt) for the center (optional, defaults to 8) &#124; id       = completely override the left side with your own content &#124; id2      = completely override the right side with your own content &#124; info     = completely override the center with your own content }&#125;
 * All options
 * Note: If you find yourself overriding a large number of default options, it probably is easier on the server and on you to customize one of my standard userboxes instead.

Examples
 User:Willscrlt/UBX/Clan

 Cameron

 MacChlerich

 Campbell

 Conochie

 Murray

 Morray

 Spalding

