Template:CatWeight/doc: Difference between revisions

Latest revision as of 23:02, 6 May 2009

This template creates an category weight bar that can be indented up to six times via parameter value. It can also be colour coded, a weight can be defined, and you can add a message describing the weight choice.

Features

Indentation of up to 6 levels, colours, and weight ranges.

Syntax

The template can have 3 or 4 parameters:

{{catWeight|<colour>|<weight>|<text>}} - Default mode, no indentation.
{{catWeight|<#>|<colour>|<weight>|<text>}} - Define indentation via <#> parameter.

       <#> =  Number 0 (min) to 6 (max), defines indentation level.

  <colour> =  Define the colour type of the info box:
                 onoff      = yellow-ish... use to match {{catWeightInfo|onoff}}
                 worstcase  = red-ish... use to match {{catWeightInfo|worstcase}}
                 amount     = green-ish... use to match {{catWeightInfo|amount}}
                 misc       = purple-ish... (fun, testing), the default colour!
              For the most current list of available <colour>s, see CatWcolBackground 
              or CatWcolFrame template.  

  <weight> =  The category weight denominator (not word-wrapped), range:
                 1 for "+"  to  6 for "***"
                 1-5 for "+ to **+"
                 1-6 for "+ to ***"
              For a complete list of available <weight>s (and ranges), see the CatWweight template.

    <text> =  The descriptive text for that weight level.

  <weight> =  The category weight denominator (not word-wrapped), range:
   <w>          1 for "+"  to  6 for "***"
                1-5 for "+ to **+"
                1-6 for "+ to ***"

Examples

The Weights

Category Weight Weight "emtpy" for <color> = misc, <weight> = 0.

Category Weight + Weight + for <color> = amount, <weight> = 1.

Category Weight * Weight * for <color> = worstcase, <weight> = 2.

Category Weight *+ Weight *+ for <color> = onoff, <weight> = 3.

Category Weight ** Weight ** for <color> = blue, <weight> = 4.

Category Weight **+ Weight **+ for <color> = misc, <weight> = 5.

Category Weight *** Weight *** for <weight> = 6.

Category Weight + to **+ Weight + to **+ for <weight> = 1-5.

Category Weight + to *** Weight + to *** for <weight> = 1-6.

Indentation

{{catWeight|0|onoff|0|'''No''' indentation or weight.}}

Category Weight No indentation or weight.

{{catWeight|1|worstcase|1|'''One''' indentation and weight.}}

Category Weight + One indentation and weight.

{{catWeight|2|amount|2|Level '''two''' indentation and weight!}}

Category Weight * Level two indentation and weight!

{{catWeight|6|misc|6|Maximum indentation level of '''six''', same weight!}}

Category Weight *** Maximum indentation level of six, same weight!

Test the Code

Should more code testing be required see the Template:CatWeight/Test Code page.

@@ Line 1: / Line 1: @@
 {{TOCright}}
-==Documentation for this template==
 This template creates an ''category weight bar'' that can be indented up to six times via parameter value. It can also be colour coded, a weight can be defined, and you can add a message describing the weight choice.
-{{eyecatch|1|Features|Intentation up to 6 levels, colours, and weight ranges.}}
+{{eyecatch|1|Features|Indentation of up to 6 levels, colours, and weight ranges.}}
-==Alternative names==
-* <tt><nowiki>{{catWeight|<colour>|<weight>|<text>}}</nowiki></tt>
-* <tt><nowiki>{{CatWeight|<colour>|<weight>|<text>}}</nowiki></tt>  - alternate spelling of template
-* <tt><nowiki>{{catWeight|<#>|<colour>|<weight>|<text>}}</nowiki></tt>
-* <tt><nowiki>{{CatWeight|<#>|<colour>|<weight>|<text>}}</nowiki></tt> - alternate spelling of template
 ==Syntax==
 The template can have '''3''' or '''4 parameters''':
-#'''<tt><nowiki>{{catWeight|<colour>|<weight>|<text>}}</nowiki></tt>''' - Default mode, no indentation.
+#{{m|catWeight|<colour>|<weight>|<text>}} - Default mode, no indentation.
-#'''<tt><nowiki>{{catWeight|<#>|<colour>|<weight>|<text>}}</nowiki></tt>''' - Define indentation via <#> parameter.
+#{{m|catWeight|<#>|<colour>|<weight>|<text>}} - Define indentation via <#> parameter.
          '''<#>''' =  Number '''0''' (min) to '''6''' (max), defines indentation level.
     '''<colour>''' =  Define the colour type of the info box:
-                   '''onoff'''      = red-ish... use to match <nowiki>{{catWeightInfo|onoff}}</nowiki>
+                   '''onoff'''      = yellow-ish... use to match <nowiki>{{catWeightInfo|onoff}}</nowiki>
-                   '''worstcase'''  = yellow-ish... use to match <nowiki>{{catWeightInfo|worstcase}}</nowiki>
+                   '''worstcase'''  = red-ish... use to match <nowiki>{{catWeightInfo|worstcase}}</nowiki>
                    '''amount'''     = green-ish... use to match <nowiki>{{catWeightInfo|amount}}</nowiki>
                    '''misc'''       = purple-ish... (fun, testing), the '''default''' colour!
+               For the most current list of available <colour>s, see [[Template:CatWcolBackground|CatWcolBackground]]
+               or [[Template:CatWcolFrame|CatWcolFrame]] template.
     '''<weight>''' =  The category weight denominator (not word-wrapped), range:
@@ Line 28: / Line 21: @@
                    '''1-5''' for "+ to **+"
                    '''1-6''' for "+ to ***"
+               For a complete list of available <weight>s (and ranges), see the '''[[Template:CatWweight|CatWweight]]''' template.
       '''<text>''' =  The descriptive text for that weight level.
-{{eyecatch|1|Note|Only the '''<#>''' values '''1''' to '''6''' are actually checked, any '''other values''' (e.g. 0 or abc) yield '''no indentation''' at all, and are treated the same as <tt><nowiki>{{eyecatch|info|text}}</nowiki></tt>!}}
+   '''<weight>''' =  The category weight denominator (not word-wrapped), range:
+    '''<w>'''          '''1''' for "+"  to  '''6''' for "***"
+                 '''1-5''' for "+ to **+"
+                 '''1-6''' for "+ to ***"
 ==Examples==
 ===The Weights===
-{{catWeight|misc|0|Weight <tt>   </tt> for <tt><nowiki><color> = misc, <weight> = 0</nowiki></tt>.}}
+{{catWeight|misc|0|Weight <tt>"emtpy"</tt> for <tt><nowiki><color> = misc, <weight> = 0</nowiki></tt>.}}
 {{catWeight|amount|1|Weight <tt>+  </tt> for <tt><nowiki><color> = amount, <weight> = 1</nowiki></tt>.}}
 {{catWeight|worstcase|2|Weight <tt>*  </tt> for <tt><nowiki><color> = worstcase, <weight> = 2</nowiki></tt>.}}
 {{catWeight|onoff|3|Weight <tt>*+ </tt> for <tt><nowiki><color> = onoff, <weight> = 3</nowiki></tt>.}}
-{{catWeight|misc|4|Weight <tt>** </tt> for <tt><nowiki><weight> = 4</nowiki></tt>.}}
+{{catWeight|blue|4|Weight <tt>** </tt> for <tt><nowiki><color> = blue, <weight> = 4</nowiki></tt>.}}
-{{catWeight|misc|5|Weight <tt>**+</tt> for <tt><nowiki><weight> = 5</nowiki></tt>.}}
+{{catWeight|misc|5|Weight <tt>**+</tt> for <tt><nowiki><color> = misc, <weight> = 5</nowiki></tt>.}}
 {{catWeight|misc|6|Weight <tt>***</tt> for <tt><nowiki><weight> = 6</nowiki></tt>.}}
 {{catWeight|misc|1-5|Weight <tt>+ to **+</tt> for <tt><nowiki><weight> = 1-5</nowiki></tt>.}}