Template:Chart

From Tempest Rising Wiki
Jump to navigation Jump to search
Template documentation
Note: portions of the template sample may not be visible without values provided.
View or edit this documentation. (About template documentation)
Editors can experiment in this template's sandbox and test case pages.

This is a template for rendering simple diagrams consisting of boxes and connecting lines based loosely on an ASCII art-like syntax. The trees are displayed as HTML tables using CSS attributes, and may contain wiki markup within the boxes. This implementation was based on the familytree template.

Example usage

This code:

{{chart/start}}
{{chart| | | | GrMa |~|y|~| GRP | | GrMa=Old Lady Gibson|GRP=Doctor Henry}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | MOM |y| DAD | |HAROLD| MOM=Mom|DAD=Dad|HAROLD=Harold}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| JOE | | ME  | | SIS | | | JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}}
{{chart/end}}

Produces this:

GrandmaGrandpa
MomDadHarold
My brother JoeMe!My little sister

Parameters

<unnamed 1> up to <unnamed 50>

This parameter defines the content of one chart "box" in a row of up to 50 chart boxes. In any given row, each chart box requires a uniquely named parameter.

(default: "2")
rowspan

This parameter defines the number of cells all chart boxs in a given row will extend. Each default chart box is 2 cells long, and spacings between chart boxes are 2 cells long.

(default: "2")
rowspan_<unnamed1> up to rowspan_<unnamed50>

This parameter defines the number of cells any individual chart box in a row will extend. Each default chart box is 2 cells long, and spacings between chart boxes are 2 cells long.

(default: "6")
colspan

This parameter defines the number of cells all chart boxes in a given column will extend. Each chart box is 6 cells wide, and spacings between chart boxes are 2 cells wide.

(default: "6")
colspan_<unnamed1> up to colspan_<unnamed50>

This parameter defines the number of cells any individual chart box in a row will extend. Each default chart box is 2 cells long, and spacings between chart boxes are 2 cells long.

(default: "2")
border

This parameter defines the size in pixels of the border of all chart boxes in any given row.

(default: "2")
border_<unnamed1> up to border_<unnamed50>

This parameter defines the size in pixels of the border of any individual chart box.

boxstyle

This parameter defines any CSS styling of all chart boxes in any given row.

boxstyle_<unnamed1> up to boxstyle_<unnamed50>

This parameter defines any CSS styling of any individual chart box.

style

When used in the {{chart/start}} template, this parameter defines any CSS styling of all chart boxes in the entire chart template.

class

When used in the {{chart/start}} template, this parameter applies any predefined Common CSS class styling of all chart boxes in the entire chart template, or all chart boxes in any given row, when used in the {{Chart}} template.

class_<unnamed1> up to class_<unnamed50>

This parameter applies any predefined Common CSS class styling of any individual chart box.

Usage

This template produces one row in a family tree table. The template accepts up to 50 unnamed parameters describing the contents of the table. Each parameter specifies a tile or a box.

  • Tiles are line drawing symbols consisting of horizontal and vertical lines and various corners and crossings thereof. Tiles are specified using one- or two-character symbols: for the most common tiles, that character is more or less approximate the shape of the tile in appearance. A special case of a tile is the empty tile, specified by a single space character. A table of available tiles is given below.
Solid lines:
,
  .
  `
  '
 
^
  v
  (
  )
 
-
  !
  +
 
 
Dashed lines:
F
  7
  L
  J
 
A
  V
  C
  D
 
~
  :
  %
 
 
Dotted lines:
S
  T
  Y
  Z
 
W
  M
  G
  H
 
P
  Q
  R
 
 
Mixed:
*
  d
  c
        a
  k
  l
        a2
  k2
  l2
 
t
  y
  h
        b
  m
  n
        b2
  m2
  n2
 
f
  e
  i
  j
  o
  p
  q
  r
  o2
  p2
  q2
  r2
 
  • Boxes can contain wiki markup. The content of each box is specified using additional named parameters appended to the template call. Each box is three tiles wide and normally has a black border two pixels wide. Boxes can have any name that is a valid template parameter name, subject to a minimum of two alphabetical characters.

Style attributes

The appearance of the boxes may be controlled by the following optional template parameters:

  • border specifies the width of the box border in pixels,
  • boxstyle can be used to append CSS declarations directly to the box style attributes.

For example, the following code:

{{chart/start}}
{{chart|border=0|boxstyle=background:#dfd; color:#111;| | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}}
{{chart|border=0|boxstyle=background:#dfd; color:#111;| | |,|-|^|-|.| | }}
{{chart|border=0|boxstyle=background:#dfd; color:#111;| | FOO | | BAR | |FOO=Box 3|BAR=Box 4}}
{{chart/end}}

produces this chart:

Box 1Box 2
Box 3Box 4

Style attributes can even be set for individual boxes, as in the example below:

{{chart/start}}
{{chart| | | | |CLEAR| | | | |CLEAR=Clear box}}
{{chart| |,|-|-|'|!|`|-|-|.| }}
{{chart|RED  |~|GREEN|~|BLUE |RED=Red box|GREEN=Green box|BLUE=Blue box
|boxstyle_RED  =background-color: #faa; color: #111;
|boxstyle_GREEN=background-color: #afa; color: #111;
|boxstyle_BLUE =background-color: #aaf; color: #111;
}}
{{chart/end}}

which produces this:

Clear box
Red boxGreen boxBlue box

NOTE: When specifying style attributes for individual named boxes, make sure the box names are aligned to the left side of the area reserved for them in the template call (as in "|RED  |" instead of "| RED |" in the example above), otherwise the template will end up looking for a style parameter with spaces in its name.

The {{chart/start}} template also accepts an optional style parameter that can be used to set CSS styles for the entire diagram.