imported>Fielran: corrected category from Template documentations to Template documentation

2023-06-26T21:41:10Z

corrected category from Template documentations to Template documentation

← Older revision		Revision as of 23:41, 26 June 2023
Line 1:		Line 1:
	[[Category:Template ~~documentations~~]]		[[Category:Template documentation]]

	This is a template for rendering simple [[wikipedia:family tree\|family tree]]s consisting of boxes and connecting lines based on an [[wikipedia:ASCII art\|ASCII art]]-like syntax. The trees are displayed as [[wikipedia:HTML\|HTML]] tables using [[wikipedia:Cascading Style Sheets\|CSS]] attributes, and may contain arbitrary [[wikipedia:wiki markup\|wiki markup]] within the boxes.		This is a template for rendering simple [[wikipedia:family tree\|family tree]]s consisting of boxes and connecting lines based on an [[wikipedia:ASCII art\|ASCII art]]-like syntax. The trees are displayed as [[wikipedia:HTML\|HTML]] tables using [[wikipedia:Cascading Style Sheets\|CSS]] attributes, and may contain arbitrary [[wikipedia:wiki markup\|wiki markup]] within the boxes.

imported>Jasca Ducato at 16:20, 24 April 2012

2012-04-24T16:20:22Z

← Older revision		Revision as of 18:20, 24 April 2012
Line 1:		Line 1:
	[[Category:Template documentations]]		[[Category:Template documentations]]

	~~his~~ is a template for rendering simple [[wikipedia:family tree\|family tree]]s consisting of boxes and connecting lines based on an [[wikipedia:ASCII art\|ASCII art]]-like syntax. The trees are displayed as [[wikipedia:HTML\|HTML]] tables using [[wikipedia:Cascading Style Sheets\|CSS]] attributes, and may contain arbitrary [[wikipedia:wiki markup\|wiki markup]] within the boxes.		This is a template for rendering simple [[wikipedia:family tree\|family tree]]s consisting of boxes and connecting lines based on an [[wikipedia:ASCII art\|ASCII art]]-like syntax. The trees are displayed as [[wikipedia:HTML\|HTML]] tables using [[wikipedia:Cascading Style Sheets\|CSS]] attributes, and may contain arbitrary [[wikipedia:wiki markup\|wiki markup]] within the boxes.

	==Example usage==		==Example usage==

imported>Jasca Ducato: Documentation for the new template

2012-04-23T21:18:31Z

Documentation for the new template

Páàjì titun

[[Category:Template documentations]]

his is a template for rendering simple [[wikipedia:family tree|family tree]]s consisting of boxes and connecting lines based on an [[wikipedia:ASCII art|ASCII art]]-like syntax. The trees are displayed as [[wikipedia:HTML|HTML]] tables using [[wikipedia:Cascading Style Sheets|CSS]] attributes, and may contain arbitrary [[wikipedia:wiki markup|wiki markup]] within the boxes.

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

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

==Parameters==

This template produces one row in a family tree table. The template accepts up to 99 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 single-character symbols that 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 supported tiles is given below.

{| style="float: left; margin-left: 1em;"
|+ '''Solid lines:'''
|-
| <big><tt>,</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|,}}{{familytree/end}} ||  
| <big><tt>.</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|.}}{{familytree/end}} ||  
| <big><tt>`</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|`}}{{familytree/end}} ||  
| <big><tt>'</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|'}}{{familytree/end}} ||  
|-
| <big><tt>^</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|^}}{{familytree/end}} ||  
| <big><tt>v</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|v}}{{familytree/end}} ||  
| <big><tt>(</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|(}}{{familytree/end}} ||  
| <big><tt>)</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|)}}{{familytree/end}} ||  
|-
| <big><tt>-</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|-}}{{familytree/end}} ||  
| <big><tt>!</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|!}}{{familytree/end}} ||  
| <big><tt>+</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|+}}{{familytree/end}} ||  
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree| }}{{familytree/end}} ||  
|}
{| style="float: left; margin-left: 1em;"
|+ '''Dashed lines:'''
|-
| <big><tt>F</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|F}}{{familytree/end}} ||  
| <big><tt>7</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|7}}{{familytree/end}} ||  
| <big><tt>L</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|L}}{{familytree/end}} ||  
| <big><tt>J</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|J}}{{familytree/end}} ||  
|-
| <big><tt>A</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|A}}{{familytree/end}} ||  
| <big><tt>V</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|V}}{{familytree/end}} ||  
| <big><tt>C</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|C}}{{familytree/end}} ||  
| <big><tt>D</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|D}}{{familytree/end}} ||  
|-
| <big><tt>~</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|~}}{{familytree/end}} ||  
| <big><tt>:</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|:}}{{familytree/end}} ||  
| <big><tt>%</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|%}}{{familytree/end}} ||  
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree| }}{{familytree/end}} ||  
|}
{| style="float: left; margin-left: 1em;"
|+ '''Mixed:'''
|-
| <big><tt>*</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|*}}{{familytree/end}} ||  
| <big><tt>}</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|}|}}{{familytree/end}} ||  
| <big><tt>{</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|{|}}{{familytree/end}} ||  
|-
| <big><tt>#</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|#}}{{familytree/end}} ||  
| <big><tt>y</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|y}}{{familytree/end}} ||  
| <big><tt>h</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|h}}{{familytree/end}} ||  
|-
| <big><tt>]</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|]}}{{familytree/end}} ||  
| <big><tt>[</tt></big> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|[}}{{familytree/end}} ||  
|}
<br clear="left" />

*'''Boxes''' can contain arbitrary [[wikipedia:wiki markup|wiki markup]]. The contents of boxes are specified using additional named parameters appended to the template call. Each box is '''three tiles wide''' and normally has a 2 pixels wide black border. Boxes can have any name that is a valid template parameter name, although single character names should be avoided to prevent conflicts with tile symbols.

==Style attributes==

The appearance of the boxes may be controlled by the optional template parameters ''border'' and ''boxstyle''. The former sets the width of the box border in pixels, while the latter can be used to append arbitrary [[wikipedia:Cascading Style Sheets|CSS]] declarations directly to the box style attributes. For example, the following code:

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

produces a result like this:

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

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

<pre><nowiki>
{{familytree/start}}
{{familytree| | | | |WHITE| | | | |WHITE=White box}}
{{familytree| |,|-|-|'|!|`|-|-|.| }}
{{familytree|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;
}}
{{familytree/end}}
</nowiki></pre>

which produces the output:

{{familytree/start}}
{{familytree| | | | |WHITE| | | | |WHITE=White box}}
{{familytree| |,|-|-|'|!|`|-|-|.| }}
{{familytree|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;
}}
{{familytree/end}}

'''NOTE:''' When specifying style attributes for individual named boxes, make sure the box names are aligned to the '''left''' side of 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|familytree/start}} template also accepts an optional ''style'' parameter that can be used to set CSS styles for the entire table.

<includeonly>

[[Category:Genealogy templates|{{PAGENAME}}]]
</includeonly>

Template:Familytree/doc - Revision history

imported>Fielran: corrected category from Template documentations to Template documentation

imported>Jasca Ducato at 16:20, 24 April 2012

imported>Jasca Ducato: Documentation for the new template