2,273
edits
Template:Family tree/doc: Difference between revisions
no edit summary
Aigle Phos (talk | contribs) No edit summary |
Aigle Phos (talk | contribs) No edit summary |
||
| Line 7: | Line 7: | ||
| image = [[File:Edit-copy purple-wikit.svg|40px]] | | image = [[File:Edit-copy purple-wikit.svg|40px]] | ||
| type = move | | type = move | ||
| text = When editing extremely large diagram with | | text = When editing extremely large diagram with Family tree it is possible that you would be unable to submit the content due to [[Wikipedia:template limits]]. In that case please consider migrating your diagram to {{tl|Chart}} which generates lower preprocessor node count. | ||
}} | }} | ||
This is a template for rendering simple [[ | This is a template for rendering simple [[Family tree]]s consisting of boxes and connecting lines based 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. | ||
==Example usage== | ==Example usage== | ||
This code: | This code: | ||
<pre style="overflow:auto;"> | <pre style="overflow:auto;"> | ||
{{ | {{Family tree/start |summary=I have a brother Joe and a little sister: my mom married my dad, and my dad's parents were Grandma and Grandpa; they had another child, Aunt Daisy.}} | ||
{{ | {{Family tree | | | | GMa |~|y|~| GPa | | GMa=Gladys|GPa=Sydney}} | ||
{{ | {{Family tree | | | | | | | |)|-|-|-|.| }} | ||
{{ | {{Family tree | | | MOM |y| DAD | |DAISY| MOM=Mom|DAD=Dad|DAISY=[[Aunt Daisy]]}} | ||
{{ | {{Family tree | |,|-|-|-|+|-|-|-|.| | | }} | ||
{{ | {{Family tree | JOE | | ME | | SIS | | | JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}} | ||
{{ | {{Family tree/end}} | ||
</pre> | </pre> | ||
Produces this: | Produces this: | ||
{{ | {{Family tree/start |summary=I have a brother Joe and a little sister: my mom married my dad, and my dad's parents were Grandma and Grandpa; they had another child, Aunt Daisy.}} | ||
{{ | {{Family tree | | | | GMa |~|y|~| GPa | | GMa=Gladys|GPa=Sydney}} | ||
{{ | {{Family tree | | | | | | | |)|-|-|-|.| }} | ||
{{ | {{Family tree | | | MOM |y| DAD | |DAISY| MOM=Mom|DAD=Dad|DAISY=[[Aunt Daisy]]}} | ||
{{ | {{Family tree | |,|-|-|-|+|-|-|-|.| | | }} | ||
{{ | {{Family tree | JOE | | ME | | SIS | | | JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}} | ||
{{ | {{Family tree/end}} | ||
== Parameters == | == Parameters == | ||
The {{para|summary|<var>text</var>}} parameter of the {{tl| | The {{para|summary|<var>text</var>}} parameter of the {{tl|Family tree/start}} template should be used to describe the overall layout of the tree. This summary is for [[Wikipedia:Accessibility|accessibility]]: it is read aloud to visually impaired readers who use [[screen reader]]s, and is invisible to sighted readers. | ||
The {{tl| | The {{tl|Family tree}} template produces one row in a Family tree table. The template accepts up to 80 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. | * '''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. | ||
| Line 42: | Line 42: | ||
|+ '''Solid lines:''' | |+ '''Solid lines:''' | ||
|- | |- | ||
| <big><tt>,</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>,</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|,}}{{Family tree/end}} | ||
| <big><tt>v</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>v</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|v}}{{Family tree/end}} | ||
| <big><tt>.</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>.</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|.}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>)</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>)</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|)}}{{Family tree/end}} | ||
| <big><tt>+</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>+</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|+}}{{Family tree/end}} | ||
| <big><tt>(</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>(</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|(}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>`</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>`</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|`}}{{Family tree/end}} | ||
| <big><tt>^</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>^</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|^}}{{Family tree/end}} | ||
| <big><tt>'</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>'</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|'}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>-</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>-</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|-}}{{Family tree/end}} | ||
| <big><tt>!</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>!</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|!}}{{Family tree/end}} | ||
| <big><tt> </tt></big> ||style="border:1px solid gray"| {{ | | <big><tt> </tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree| }}{{Family tree/end}} | ||
|} | |} | ||
{| style="float:left;margin-left:1em" | {| style="float:left;margin-left:1em" | ||
|+ '''Dashed lines:''' | |+ '''Dashed lines:''' | ||
|- | |- | ||
| <big><tt>F</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>F</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|F}}{{Family tree/end}} | ||
| <big><tt>V</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>V</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|V}}{{Family tree/end}} | ||
| <big><tt>7</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>7</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|7}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>D</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>D</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|D}}{{Family tree/end}} | ||
| <big><tt>%</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>%</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|%}}{{Family tree/end}} | ||
| <big><tt>C</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>C</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|C}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>L</tt></big> ||style="border: 1px solid gray"| {{ | | <big><tt>L</tt></big> ||style="border: 1px solid gray"| {{Family tree/start}}{{Family tree|L}}{{Family tree/end}} | ||
| <big><tt>A</tt></big> ||style="border: 1px solid gray"| {{ | | <big><tt>A</tt></big> ||style="border: 1px solid gray"| {{Family tree/start}}{{Family tree|A}}{{Family tree/end}} | ||
| <big><tt>J</tt></big> ||style="border: 1px solid gray"| {{ | | <big><tt>J</tt></big> ||style="border: 1px solid gray"| {{Family tree/start}}{{Family tree|J}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>~</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>~</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|~}}{{Family tree/end}} | ||
| <big><tt>:</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>:</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|:}}{{Family tree/end}} | ||
| <big><tt> </tt></big> ||style="border:1px solid gray"| {{ | | <big><tt> </tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree| }}{{Family tree/end}} | ||
|} | |} | ||
{|style="float:left;margin-left:1em" | {|style="float:left;margin-left:1em" | ||
|+ '''Mixed (1):''' | |+ '''Mixed (1):''' | ||
|- | |- | ||
| <big><tt>r</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>r</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|r}}{{Family tree/end}} | ||
| <big><tt>y</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>y</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|y}}{{Family tree/end}} | ||
| <big><tt>n</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>n</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|n}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>]</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>]</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|]}}{{Family tree/end}} | ||
| <big><tt>#</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>#</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|#}}{{Family tree/end}} | ||
| <big><tt>[</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>[</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|[}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>c</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>c</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|c}}{{Family tree/end}} | ||
| <big><tt>h</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>h</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|h}}{{Family tree/end}} | ||
| <big><tt>j</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>j</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|j}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>~</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>~</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|~}}{{Family tree/end}} | ||
| <big><tt>!</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>!</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|!}}{{Family tree/end}} | ||
| <big><tt> </tt></big> ||style="border:1px solid gray"| {{ | | <big><tt> </tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree| }}{{Family tree/end}} | ||
|} | |} | ||
{|style="float:left;margin-left:1em" | {|style="float:left;margin-left:1em" | ||
|+ '''Mixed (2):''' | |+ '''Mixed (2):''' | ||
|- | |- | ||
| <big><tt>p</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>p</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|p}}{{Family tree/end}} | ||
| <big><tt>u</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>u</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|u}}{{Family tree/end}} | ||
| <big><tt>q</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>q</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|q}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>}</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>}</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|}|}}{{Family tree/end}} | ||
| <big><tt>*</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>*</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|*}}{{Family tree/end}} | ||
| <big><tt>{</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>{</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|{|}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>b</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>b</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|b}}{{Family tree/end}} | ||
| <big><tt>t</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>t</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|t|}}{{Family tree/end}} | ||
| <big><tt>d</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>d</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|d}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>-</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>-</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|-}}{{Family tree/end}} | ||
| <big><tt>:</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>:</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|:}}{{Family tree/end}} | ||
| <big><tt> </tt></big> ||style="border:1px solid gray"| {{ | | <big><tt> </tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree| }}{{Family tree/end}} | ||
|} | |} | ||
{|style="float:left;margin-left:1em" | {|style="float:left;margin-left:1em" | ||
| Line 119: | Line 119: | ||
|- | |- | ||
| || | | || | ||
| <big><tt>T</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>T</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|T}}{{Family tree/end}} | ||
|- | |- | ||
| <big><tt>G</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>G</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|G}}{{Family tree/end}} | ||
| <big><tt>X</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>X</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|X}}{{Family tree/end}} | ||
| <big><tt>K</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>K</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|K}}{{Family tree/end}} | ||
| <big><tt>k</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>k</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|k}}{{Family tree/end}} | ||
|- | |- | ||
| || | | || | ||
| <big><tt>U</tt></big> ||style="border:1px solid gray"| {{ | | <big><tt>U</tt></big> ||style="border:1px solid gray"| {{Family tree/start}}{{Family tree|U}}{{Family tree/end}} | ||
|} | |} | ||
<br clear="left" /> | <br clear="left" /> | ||
| Line 138: | Line 138: | ||
<pre style="overflow:auto;"> | <pre style="overflow:auto;"> | ||
{{ | {{Family tree/start |summary=Box 1 married to Box 2, with children Box 3 and Box 4}} | ||
{{ | {{Family tree|border=0|boxstyle=background:#dfd;| | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}} | ||
{{ | {{Family tree|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }} | ||
{{ | {{Family tree|border=0|boxstyle=background:#dfd;| | FOO | | BAR | |FOO=Box 3|BAR=Box 4}} | ||
{{ | {{Family tree/end}} | ||
</pre> | </pre> | ||
produces a result like this: | produces a result like this: | ||
{{ | {{Family tree/start |summary=Box 1 married to Box 2, with children Box 3 and Box 4}} | ||
{{ | {{Family tree|border=0|boxstyle=background:#dfd;| | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}} | ||
{{ | {{Family tree|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }} | ||
{{ | {{Family tree|border=0|boxstyle=background:#dfd;| | FOO | | BAR | |FOO=Box 3|BAR=Box 4}} | ||
{{ | {{Family tree/end}} | ||
Style attributes can even be set for individual boxes, as in the example below: | Style attributes can even be set for individual boxes, as in the example below: | ||
<pre style="overflow:auto;"> | <pre style="overflow:auto;"> | ||
{{ | {{Family tree/start |White box with three children Red box, Green box, Blue box, all married to each other}} | ||
{{ | {{Family tree| | | | |WHITE| | | | |WHITE=White box | ||
|boxstyle_WHITE = background-color: #fff; | |boxstyle_WHITE = background-color: #fff; | ||
}} | }} | ||
{{ | {{Family tree| |,|-|-|'|!|`|-|-|.| }} | ||
{{ | {{Family tree|RED |~|GREEN|~|BLUE |RED=Red box|GREEN=Green box|BLUE=Blue box | ||
|boxstyle_RED = background-color: #faa; | |boxstyle_RED = background-color: #faa; | ||
|boxstyle_GREEN = background-color: #afa; | |boxstyle_GREEN = background-color: #afa; | ||
|boxstyle_BLUE = background-color: #aaf; | |boxstyle_BLUE = background-color: #aaf; | ||
}} | }} | ||
{{ | {{Family tree/end}} | ||
</pre> | </pre> | ||
which produces the output: | which produces the output: | ||
{{ | {{Family tree/start |White box with three children Red box, Green box, Blue box, all married to each other}} | ||
{{ | {{Family tree| | | | |WHITE| | | | |WHITE=White box | ||
|boxstyle_WHITE = background-color: #fff; | |boxstyle_WHITE = background-color: #fff; | ||
}} | }} | ||
{{ | {{Family tree| |,|-|-|'|!|`|-|-|.| }} | ||
{{ | {{Family tree|RED |~|GREEN|~|BLUE |RED=Red box|GREEN=Green box|BLUE=Blue box | ||
|boxstyle_RED =background-color: #faa; | |boxstyle_RED =background-color: #faa; | ||
|boxstyle_GREEN=background-color: #afa; | |boxstyle_GREEN=background-color: #afa; | ||
|boxstyle_BLUE =background-color: #aaf; | |boxstyle_BLUE =background-color: #aaf; | ||
}} | }} | ||
{{ | {{Family tree/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. | '''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| | The {{tl|Family tree/start}} template also accepts an optional ''style'' parameter that can be used to set CSS styles for the entire table. | ||
==See also== | ==See also== | ||
* {{tl|chart}} – supports more complex | * {{tl|chart}} – supports more complex Family trees | ||
* [[User:GregU/ | * [[User:GregU/Family tree.js|Family tree.js]] – tool to easily create or update diagrams using these templates | ||
* [http://godskingsandheroes.info/gedcom2wiki/convert.htm gedcom2wiki service] – online service to convert gedcom files to wiki | * [http://godskingsandheroes.info/gedcom2wiki/convert.htm gedcom2wiki service] – online service to convert gedcom files to wiki Family tree template markup | ||
* [[Wikipedia: | * [[Wikipedia:Family trees]] – other methods | ||
<includeonly> | <includeonly> | ||