Template:Chart/doc - Revision history

Iversia: Added some more documentation.

2012-08-13T15:42:08Z

Added some more documentation.

Iversia at 19:20, 9 August 2012

2012-08-09T19:20:20Z

Iversia at 19:18, 9 August 2012

2012-08-09T19:18:28Z

Iversia: /* See also */

2012-08-09T19:09:18Z

‎See also

Iversia at 19:25, 3 August 2012

2012-08-03T19:25:30Z

Iversia: 1 revision

2012-08-03T18:15:55Z

1 revision

71.36.125.252 at 17:52, 11 June 2011

2011-06-11T17:52:03Z

New page

<includeonly>{{esoteric}}</includeonly>
<noinclude>{{documentation subpage}}</noinclude>

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 [[Cascading Style Sheets|CSS]] attributes, and may contain arbitrary [[wiki markup]] within the boxes. This implementation was based on the {{tl|familytree}} template.

==Example usage==
This code:
<pre><nowiki>
{{chart/start}}
{{chart| | | |GrMa |~|y|~| GRP | |GrMa=Grandma|GRP=Grandpa}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | MOM |y| DAD | |DAISY|MOM=Mom|DAD=Dad|DAISY=[[Aunt Daisy]]}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| JOE | | ME | | SIS | | |JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}}
{{chart/end}}
</nowiki></pre>
Produces this:

{{chart/start}}
{{chart| | | |GrMa |~|y|~| GRP | |GrMa=Grandma|GRP=Grandpa}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | MOM |y| DAD | |DAISY|MOM=Mom|DAD=Dad|DAISY=[[Aunt Daisy]]}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| JOE | | ME | | SIS | | |JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}}
{{chart/end}}

==Parameters==
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.

{| style="float: left; margin-left: 1em;"
|+ '''Solid lines:'''
|-
| <big><tt>,</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|,}}{{chart/end}} ||  
| <big><tt>.</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|.}}{{chart/end}} ||  
| <big><tt>`</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|`}}{{chart/end}} ||  
| <big><tt>'</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|'}}{{chart/end}} ||  
|-
| <big><tt>^</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|^}}{{chart/end}} ||  
| <big><tt>v</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|v}}{{chart/end}} ||  
| <big><tt>(</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|(}}{{chart/end}} ||  
| <big><tt>)</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|)}}{{chart/end}} ||  
|-
| <big><tt>-</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|-}}{{chart/end}} ||  
| <big><tt>!</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|!}}{{chart/end}} ||  
| <big><tt>+</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|+}}{{chart/end}} ||  
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart| }}{{chart/end}} ||  
|}
{| style="float: left; margin-left: 1em;"
|+ '''Dashed lines:'''
|-
| <big><tt>F</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|F}}{{chart/end}} ||  
| <big><tt>7</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|7}}{{chart/end}} ||  
| <big><tt>L</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|L}}{{chart/end}} ||  
| <big><tt>J</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|J}}{{chart/end}} ||  
|-
| <big><tt>A</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|A}}{{chart/end}} ||  
| <big><tt>V</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|V}}{{chart/end}} ||  
| <big><tt>C</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|C}}{{chart/end}} ||  
| <big><tt>D</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|D}}{{chart/end}} ||  
|-
| <big><tt>~</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|~}}{{chart/end}} ||  
| <big><tt>:</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|:}}{{chart/end}} ||  
| <big><tt>%</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|%}}{{chart/end}} ||  
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart| }}{{chart/end}} ||  
|}
{| style="float: left; margin-left: 1em;"
|+ '''Dotted lines:'''
|-
| <big><tt>S</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|S}}{{chart/end}} ||  
| <big><tt>T</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|T}}{{chart/end}} ||  
| <big><tt>Y</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|Y}}{{chart/end}} ||  
| <big><tt>Z</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|Z}}{{chart/end}} ||  
|-
| <big><tt>W</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|W}}{{chart/end}} ||  
| <big><tt>M</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|M}}{{chart/end}} ||  
| <big><tt>G</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|G}}{{chart/end}} ||  
| <big><tt>H</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|H}}{{chart/end}} ||  
|-
| <big><tt>P</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|P}}{{chart/end}} ||  
| <big><tt>Q</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|Q}}{{chart/end}} ||  
| <big><tt>R</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|R}}{{chart/end}} ||  
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart| }}{{chart/end}} ||  
|}
{| style="float: left; margin-left: 1em;"
|+ '''Mixed:'''
|-
| <big><tt>*</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|*}}{{chart/end}} ||  
| <big><tt>d</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|d}}{{chart/end}} ||  
| <big><tt>c</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|c}}{{chart/end}} ||  
|   ||   ||  
| <big><tt>a</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|a}}{{chart/end}} ||  
| <big><tt>k</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|k}}{{chart/end}} ||  
| <big><tt>l</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|l}}{{chart/end}} ||  
|   ||   ||  
| <big><tt>a2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|a2}}{{chart/end}} ||  
| <big><tt>k2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|k2}}{{chart/end}} ||  
| <big><tt>l2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|l2}}{{chart/end}} ||  
|-
| <big><tt>t</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|t}}{{chart/end}} ||  
| <big><tt>y</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|y}}{{chart/end}} ||  
| <big><tt>h</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|h}}{{chart/end}} ||  
|   ||   ||  
| <big><tt>b</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|b}}{{chart/end}} ||  
| <big><tt>m</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|m}}{{chart/end}} ||  
| <big><tt>n</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|n}}{{chart/end}} ||  
|   ||   ||  
| <big><tt>b2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|b2}}{{chart/end}} ||  
| <big><tt>m2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|m2}}{{chart/end}} ||  
| <big><tt>n2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|n2}}{{chart/end}} ||  
|-
| <big><tt>f</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|f}}{{chart/end}} ||  
| <big><tt>e</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|e}}{{chart/end}} ||  
| <big><tt>i</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|i}}{{chart/end}} ||  
| <big><tt>j</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|j}}{{chart/end}} ||  
| <big><tt>o</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|o}}{{chart/end}} ||  
| <big><tt>p</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|p}}{{chart/end}} ||  
| <big><tt>q</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|q}}{{chart/end}} ||  
| <big><tt>r</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|r}}{{chart/end}} ||  
| <big><tt>o2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|o2}}{{chart/end}} ||  
| <big><tt>p2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|p2}}{{chart/end}} ||  
| <big><tt>q2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|q2}}{{chart/end}} ||  
| <big><tt>r2</tt></big> || style="border: 1px solid gray;" | {{chart/start}}{{chart|r2}}{{chart/end}} ||  
|}
<br clear="left" />

*'''Boxes''' can contain arbitrary [[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 arbitrary [[Cascading Style Sheets|CSS]] declarations directly to the box style attributes.
For example, the following code:

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

produces this chart:

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

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

<pre><nowiki>
{{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;
|boxstyle_GREEN=background-color: #afa;
|boxstyle_BLUE =background-color: #aaf;
}}
{{chart/end}}
</nowiki></pre>

which produces this:

{{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;
|boxstyle_GREEN=background-color: #afa;
|boxstyle_BLUE =background-color: #aaf;
}}
{{chart/end}}

'''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 "<code>|RED  |</code>" instead of "<code>| RED |</code>" in the example above), otherwise the template will end up looking for a style parameter with spaces in its name.

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

==Migration from familytree==
The {{tl|chart}} template is largely compatible with the earlier {{tl|familytree}} template. However, to use the additional functionality offered with this template, diagrams must be updated to use {{tl|chart}} instead. Many {{tl|familytree}} diagrams can be altered to use {{tl|chart}} and its sub-templates simply by replacing the wikitext <tt>familytree</tt> with <tt>chart</tt>. A few of the "mixed" tiles had to be renamed, and {{tl|familytree}} diagrams using these tiles will have to make a few changes. Additionally, two new "mixed" tiles have been added, joining solid lines to dashed lines. The following table summarises the differences:
{| class="notwikitable" style="text-align:center;" border="1" cellspacing="0" cellpadding="3"
!Tile!!{{tl|familytree}}!!{{tl|chart}}
|-
|{{chart/start}}{{chart|c}}{{chart/end}}||<tt>{</tt>||<tt>c</tt>
|-
|{{chart/start}}{{chart|d}}{{chart/end}}||<tt>}</tt>||<tt>d</tt>
|-
|{{chart/start}}{{chart|t}}{{chart/end}}||<tt>#</tt>||<tt>t</tt>
|-
|{{chart/start}}{{chart|e}}{{chart/end}}||<tt>[</tt>||<tt>e</tt>
|-
|{{chart/start}}{{chart|f}}{{chart/end}}||<tt>]</tt>||<tt>f</tt>
|-
|{{chart/start}}{{chart|i}}{{chart/end}}|| ||<tt>i</tt>
|-
|{{chart/start}}{{chart|j}}{{chart/end}}|| ||<tt>j</tt>
|}

Lastly, if any uses of the {{tl|familytree}} template end with <tt>|}}</tt>, that vertical bar should be removed, leaving the last cell in that row containing either some text or a space.

The familytree.js tool below can be used to convert between syntaxes. Just change the start tag when in edit view, then click "Art → Templates" to toggle back to wikitext view. The other templates will be updated to match.

==Errors==
* [[:Template:Chart/cellb]] will be caused by any instance of <code>|}}</code> change this to <code> }}</code>

* [[:Template:Chart/celltTemplate:Chart/cellb]] will be caused by any instance of <code>||</code> change this to <code>| |</code>

==See also==
* [[User:GregU/familytree.js|familytree.js]] – tool to easily create or update diagrams using these templates

<includeonly>
[[Category:Chart formatting templates|{{PAGENAME}}]]

[[zh:模板:Chart]]
</includeonly>

← Older revision		Revision as of 19:20, 9 August 2012
Line 1:		Line 1:
−	~~<includeonly>{{esoteric}}</includeonly>~~
−	~~<noinclude>{{documentation subpage}}</noinclude>~~
−
	==Example usage==		==Example usage==
	This code:		This code:

← Older revision		Revision as of 19:09, 9 August 2012
Line 186:		Line 186:

	* [[:Template:Chart/celltTemplate:Chart/cellb]] will be caused by any instance of <code>\|\|</code> change this to <code>\| \|</code>		* [[:Template:Chart/celltTemplate:Chart/cellb]] will be caused by any instance of <code>\|\|</code> change this to <code>\| \|</code>
−
−	~~==See also==~~
−	* [[User:GregU/familytree.js\|familytree.js]] – tool to easily create or update diagrams using these templates
−
−	~~<includeonly>~~
−	~~[[Category:Chart formatting templates\|{{PAGENAME}}]]~~
−
−	~~[[zh:模板:Chart]]~~
−	~~</includeonly>~~

← Older revision		Revision as of 19:25, 3 August 2012
Line 181:		Line 181:

	The {{tl\|chart/start}} template also accepts an optional ''style'' parameter that can be used to set CSS styles for the entire diagram.		The {{tl\|chart/start}} template also accepts an optional ''style'' parameter that can be used to set CSS styles for the entire diagram.
−
−	~~==Migration from familytree==~~
−	The {{tl\|chart}} template is largely compatible with the earlier {{tl\|familytree}} template. However, to use the additional functionality offered with this template, diagrams must be updated to use {{tl\|chart}} instead. Many {{tl\|familytree}} diagrams can be altered to use {{tl\|chart}} and its sub-templates simply by replacing the wikitext <tt>familytree</tt> with <tt>chart</tt>. A few of the "mixed" tiles had to be renamed, and {{tl\|familytree}} diagrams using these tiles will have to make a few changes. Additionally, two new "mixed" tiles have been added, joining solid lines to dashed lines. The following table summarises the differences:
−	~~{\| class="notwikitable" style="text-align:center;" border="1" cellspacing="0" cellpadding="3"~~
−	~~!Tile!!{{tl\|familytree}}!!{{tl\|chart}}~~
−	\|-
−	~~\|{{chart/start}}{{chart\|c}}{{chart/end}}\|\|<tt>{</tt>\|\|<tt>c</tt>~~
−	\|-
−	~~\|{{chart/start}}{{chart\|d}}{{chart/end}}\|\|<tt>}</tt>\|\|<tt>d</tt>~~
−	\|-
−	~~\|{{chart/start}}{{chart\|t}}{{chart/end}}\|\|<tt>#</tt>\|\|<tt>t</tt>~~
−	\|-
−	~~\|{{chart/start}}{{chart\|e}}{{chart/end}}\|\|<tt>[</tt>\|\|<tt>e</tt>~~
−	\|-
−	~~\|{{chart/start}}{{chart\|f}}{{chart/end}}\|\|<tt>]</tt>\|\|<tt>f</tt>~~
−	\|-
−	~~\|{{chart/start}}{{chart\|i}}{{chart/end}}\|\| \|\|<tt>i</tt>~~
−	\|-
−	~~\|{{chart/start}}{{chart\|j}}{{chart/end}}\|\| \|\|<tt>j</tt>~~
−	\|}
−
−	~~Lastly, if any uses of the {{tl\|familytree}} template end with <tt>\|}}</tt>, that vertical bar should be removed, leaving the last cell in that row containing either some text or a space.~~
−
−	The familytree.js tool below can be used to convert between syntaxes. Just change the start tag when in edit view, then click "Art → Templates" to toggle back to wikitext view. The other templates will be updated to match.

	==Errors==		==Errors==

@@ Line 121: / Line 121: @@
 <br clear="left" />
-*'''Boxes''' can contain arbitrary [[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.
+*'''Boxes''' can contain arbitrary [[Help:Formatting|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 arbitrary [[Cascading Style Sheets|CSS]] declarations directly to the box style attributes.
+* ''boxstyle'' can be used to append arbitrary CSS declarations directly to the box style attributes.
 For example, the following code:

@@ Line 1: / Line 1: @@
 <includeonly>{{esoteric}}</includeonly>
 <noinclude>{{documentation subpage}}</noinclude>
 ==Example usage==
@@ Line 181: / Line 177: @@
 The {{tl|chart/start}} template also accepts an optional ''style'' parameter that can be used to set CSS styles for the entire diagram.

← Older revision	Revision as of 18:15, 3 August 2012
(No difference)