User:Pee Tern/Sandbox/Template/Family tree chart/doc

Function

Purpose

The {{family tree chart}} template presents family trees, either horizontally or vertically, either in line format or boxed name format.

A single compound family may consist of one person, with up to three bonding relationships, including a primary bonded partner, who can have up to two other bonded relationships. The single person or any of their bonded relationships, and any of the primary bonded partner's relationships, can each have up to 10 childen. The maximum compound family can therefore consist of 6 parents and 50 children.

A family tree is constructed by substituting single family members with their family, for example, replacing a parent with their family with them as a child.

Characteristics such as person to person relationship type, person to family relationship type, and dates can also be provided. Different characteristics automatically present with different graphical styles.

There is no restriction on the width or depth of a family tree chart (other than that defined by the Wiki software processing the template instantiation).

Presentation

The family tree chart may be floated to the left or right, or centered.

It may optionally have a border placed around it.

Style attibutes may be set, for example the font style or colour or background colour.

There are also two major variations to the layout. The layout may be in a line format or names may be boxed. The chart may be laid out horizontally or vertically.

A lineage in each family may be highlighted.

Some examples using different combinations of presentation options, and types of family structures are shown below.

A childless family is:

parent1     parent2

parent1       parent2

A sole parent family is:

parent1       child1 of parents 1 2       child2 of parents 1 2     child 10 of parents 1 2

parent1         child1 of parents 1 2           child2 of parents 1 2         child 10 of parents 1 2

A simple family is:

parent1       child1 of parents 1 2 parent2

parent1         child1 of parents 1 2     parent2

The general presentation for a family is:

spouseB of parent1     child1 of parents 1 B     child2 of parents 1 B     up to 10 children of 1 B   spouseA of parent1     child1 of parents 1 A     child2 of parents 1 A     up to 10 children of 1 A   parent1       child1 of parents 1 2 parent2       child2 of parents 1 2     up to 10 children of 1 2 spouseA of parent2       child1 of parents 2 A     child2 of parents 2 A     up to 10 children of 2 A spouseB of parent2       child1 of parents 2 B     child2 of parents 2 B     up to 10 children of 2 B

spouseB of parent1       child1 of parents 1 B       spouseA of parent1       child1 of parents 1 A       parent1         child1 of parents 1 2     parent2       spouseA of parent2         child1 of parents 2 A     spouseB of parent2         child1 of parents 2 B

spouseB of parent1       spouseA of parent1       parent1       parent2       spouseA of parent2       spouseB of parent2         child1 of parents 1 B         child2 of parents 1 B         up to 10 children of 1 B         child1 of parents 1 A         child2 of parents 1 A         up to 10 children of 1 A         child1 of parents 1 2         child2 of parents 1 2         up to 10 children of 1 2         child1 of parents 2 A         child2 of parents 2 A         up to 10 children of 2 A         child1 of parents 2 B         child2 of parents 2 B         up to 10 children of 2 B

Characteristics such as:

Legend
Child relationships (relfam/relfamdt)				Person events
	Biological	b.	date born	b.	date born	dob
	Adopted	a.	date adopted	d.	date deceased	dod
	Fostered	f.	date fostered
Spouse relationships (rel/reldt)				Relationship events (relstat/relstatdt)
	Married	m.	date married	d.	date divorced
	De facto	df.	date de facto commenced	s.	date separated
	Casual	c.	date causual commenced	c.	date ceased

can be placed into the presentation, for example:

a.4/3/1943 spouseB of parent1 b.3/3/1943 d.5/6/1987 c.7/8/1970 b.8/9/1971 child1 of parents 1 B d.7/8/1972   b.9/10/1972 child2 of parents 1 B   b.10/10/1972 up to 10 children of 1 B   b.6/6/1946 spouseA of parent1 d.11/11/1973 m.6/8/1970 a. child1 of parents 1 A b.1/1/1964 d.1/1/1994   a.7/9/1970 child2 of parents 1 A b.2/2/1964   f.8/10/1971 up to 10 children of 1 A b.3/3/1964   parent1     b.3/4/1967 child1 of parents 1 2 b.2/3/1946 parent2 m.1/4/1966 d.5/7/1969   b.4/5/1968 child2 of parents 1 2   b.5/6/1969 up to 10 children of 1 2 b.4/4/1944 spouseA of parent2 df.1/4/1970 s.6/8/1973   b.2/5/1971 child1 of parents 2 A   b.3/6/1972 child2 of parents 2 A   b.4/7/1973 up to 10 children of 2 A b.5/5/1945 spouseB of parent2 c.7/8/1974   b.9/10/1975 child1 of parents 2 B   b.10/11/1976 child2 of parents 2 B   b.11/12/1977 up to 10 children of 2 B

a.4/3/1943 spouseB of parent1 b.3/3/1943 d.5/6/1987 c.7/8/1970   b.8/9/1971 child1 of parents 1 B d.7/8/1972 df.       b.9/10/1972 child2 of parents 1 B       b.10/10/1972 up to 10 children of 1 B       b.6/6/1946 spouseA of parent1 d.11/11/1973 m.6/8/1970   a. child1 of parents 1 A b.1/1/1964 d.1/1/1994       a.7/9/1970 child2 of parents 1 A b.2/2/1964       f.8/10/1971 up to 10 children of 1 A b.3/3/1964 df.1/4/1991       parent1       b.3/4/1967 child1 of parents 1 2     b.2/3/1946 parent2 m.1/4/1966 d.5/7/1969     b.4/5/1968 child2 of parents 1 2       b.5/6/1969 up to 10 children of 1 2     b.4/4/1944 spouseA of parent2 df.1/4/1970 s.6/8/1973     b.2/5/1971 child1 of parents 2 A       b.3/6/1972 child2 of parents 2 A       b.4/7/1973 up to 10 children of 2 A     b.5/5/1945 spouseB of parent2 c.7/8/1974     b.9/10/1975 child1 of parents 2 B       b.10/11/1976 child2 of parents 2 B       b.11/12/1977 up to 10 children of 2 B     Legend Child relationships Person events           Biological    b. date born       b. date born dob           Adopted    a. date adopted       d. date deceased dod           Fostered    f. date fostered   Spouse relationships Relationship events           Married    m. date married       d. date divorced           De facto    df. date de facto commenced       s. date separated           Casual    c. date causual commenced       c. date ceased      Lineage is from parent to child.

Deficiencies

Bondings between relations

Because the template only allows single paths between any person, people who are a related cannot be non redundantly placed into both their familial relationship and their bonded relationship. Cousins who marry cannot be minimally represented.

Work around

To work around this problem make two separate person instances where required and after each name parameter use {{family tree chart/dopple}}, for example:

|par2 = Cousin Cousin   

and elswhere:

|par1 = Cousin Cousin   

Usage

The template is a colour/color friendly template. All parmeter names and parameter values accept either spelling, except the style parameter.

Skeleton

{{User:Pee Tern/Sandbox/Template/Family tree chart
|par1 = 
|par1dob = 
|par1dod = 
|par1relfam = 
|par1relfamdt = 
|par1fam = 

|par2 = 
|par2dob = 
|par2dod = 
|par2rel = 
|par2reldt = 
|par2relstat = 
|par2relstatdt = 
|par2relfam  = 
|par2relfamdt = 
|par2fam = 

|kid12_1 = 
|kid12_1dob = 
|kid12_1dod = 
|kid12_1relfam = 
|kid12_1relfamdt = 
|kid12_1rel = 
|kid12_1reldt = 
|kid12_1relstat = 
|kid12_1relstatdt = 
|kid12_1fam = 
(...up to _10...)

(similarly replacing par2 with par1A, par1B, par2A, par2B, and kid12 with kid1A, kid1B, kid2A, kid2B)

|lineagepar = 
|lineagekid = 
|lineagecolour = 

|boxed = 
|border = 
|float = 
|direction = 
|style = 

}}

Parameters

Parameter Name	Required	Description	Values
Person parameters
par1	yes	Name of a parent in the family. There must be at least one parent.	Optionally linked text.
par2, parNX	no	Name of further parents in the family. par1X are other bonded relationships with par1. par2X are other bonded relationships with par2. There can be two further partners for each of par1 and par2, X can be A and B. Up to a total of 6 parents can be specified for the one compound family, 1, 2, 1A, 1B, 2A, 2B.	Optionally linked text.
kidNX_n	no	Name of a child of parent N and parent NX. Up to 10 children can be specified for each parent couple, 1B, 1A, 12, 2A, 2B, that is n can be from 1 to 10, for example kid12_1 (Child 1 of parent 1 and parent 2) or kid2A_3(child 3 of parent 2 and parent 2A.	Optionally linked text.
...dob	no	Date of birth for the person	Date format text.
...dod	no	Date of death for the person	Date format text.
...relfam	no	The relationship of the person to their family. Defaults to born if dob is provided. This parameter only applies to parents when tree building.	Text, one of == born, adopted, fostered.
...relfamdt	no	Commencement date of the relationship to the person's family. This parameter only applies to parents when tree building.	Date format text.
...rel	no	Relationship between parents. This parameter only applies to children when tree building.	Text, one of == married, de facto, casual.
...reldt	no	Commencement date of the relationship between parents. This parameter only applies to children when tree building.	Date format text.
...relstatus	no	Status of the relationship between parents. This parameter only applies to children when tree building.	Text, one of == divorced, separated, ceased.
...relstatusdt	no	Date of relationship status between parents. This parameter only applies to children when tree building.	Date format text.
lineagepar	no	The parameter name of the parent which is part of a lineage. Causes the relevant parent name to be bolded, and box if boxed, and relationship lines all to be coloured as per lineagecolour. There is no default lineage, nor is one required.	A parent parameter name.
lineagekid	no	The parameter name of the child which is part of a lineage. Causes the relevant child name to be bolded, and box if boxed, and relationship lines all to be coloured as per lineagecolour. There is no default lineage, nor is one required.	A kid parameter name.
lineagecolour	no	The colour to show the lineage in. The default is 'blue'.	Any valid colour name or encoding.
lineagetext	no	Displays a legend entry below the family tree chart with the colour annotated by the text.
Tree building parameters
parNXfam	no	Set to a family chart to build a family tree. This causes the parent parNX to be replaced by the family chart for the parent parNX.	A {{family tree chart}} instantiation, with a child's parameters set to the replaced parent, parNX,'s parameter values.
kidNX_nfam	no	Set to a family chart to build a family tree. This causes the child kidNX_n to be replaced by the family chart for the child kidNX_n.	A {{family tree chart}} instantiation, with a parent's parameters set to the replaced child, kidNX_n,'s parameter values.
Style and layout parameters
boxed	no	Set to 'yes' to place a box around each person's name. Defaults to 'no'. All other values equate to 'no'.	Text == yes.
border	no	Set to 'yes' to place a border around the family tree chart. Defaults to 'no'. All other values equate to 'no'.	Text == yes.
dir, direction	no	Set to 'vertical' to present the family tree chart vertically. Defaults to 'horizontal'. All values not equivalent to vertical equate to 'horizontal'.	Text == vertical.
legend	no	Set to 'yes' to place a legend under the family tree chart showing the meaning of the relationship lines and abbreviations. Set to 'hide' to provide a collapsed legend. All other values equate to 'no'.	Text, one of == yes, hide.
style	no	Set to any CSS value string. For example, allows families within a family tree chart to be colour highlighted.	CCS format text elements, separated by semicolons, but do not enclose in double quotes.
float	no	Float the family tree chart either left or right. Default is no float. If set to center the family tree chart is centered.	Text, one of == right, left, center.

Method

Start by constructing separate family tree charts for each family, for example:

Using the youngest family's tree chart as a base, for each ancestor add their family tree chart to the relevant ancestor data using the relevant fam parameter and copy the ancestor's data to the child data in their own family, that is:

|par2 = Parent2
|par2rel = married
|par2reldt = 23/4/1959

becomes:

|par2 = Parent 2
|par2dob = 4/5/1937
|par2rel = married
|par2reldt = 23/4/1959
|par2fam = 

{{{par1}}}

Examples

My brother Joe

Grandpa	Grandma
Dad	Aunt Daisy

Dad	Mom
My brother Joe	Me	My little sister

Grandpa       Grandma           Dad   m.       Aunt Daisy	Mom
My brother Joe	Me	My little sister

Charlotte Brabantina of Nassau

b.1455 Count John V of Nassau-Dillenburg d.1516     b.1487 Count William I of Nassau-Dillenburg d.1559 m. b.1466 Landgravine Elisabeth of Hesse-Marburg d.1523       b.1533 Prince William of Orange d.1584 m. b.1467 Botho VIII of Stolberg-Wernigerode d.1538     b.1506 Countess Juliana of Stolberg-Wernigerode d.1580 m. b.1482 Anna of Epstein-Königstein d.1538           Charlotte Brabantina of Nassau b.1473 Louis de Bourbon-Vendome d.1520     b.1513 Louis de Bourbon-Montpensier d.1582 m. b.1482 Louise de Bourbon-Montpensier d.1561       b.1547 Charlotte of Bourbon d.1582 m. b.before 1524 Jacqueline de Longwy-Bar d.1561

b.1455 Count John V of Nassau-Dillenburg d.1516     b.1487 Count William I of Nassau-Dillenburg d.1559 m. b.1466 Landgravine Elisabeth of Hesse-Marburg d.1523       b.1533 Prince William of Orange d.1584 m. b.1467 Botho VIII of Stolberg-Wernigerode d.1538     b.1506 Countess Juliana of Stolberg-Wernigerode d.1580 m. b.1482 Anna of Epstein-Königstein d.1538           Charlotte Brabantina of Nassau b.1473 Louis de Bourbon-Vendome d.1520     b.1513 Louis de Bourbon-Montpensier d.1582 m. b.1482 Louise de Bourbon-Montpensier d.1561       b.1547 Charlotte of Bourbon d.1582 m. b.before 1524 Jacqueline de Longwy-Bar d.1561

b.1455 Count John V of Nassau-Dillenburg d.1516       b.1487 Count William I of Nassau-Dillenburg d.1559 m.     b.1466 Landgravine Elisabeth of Hesse-Marburg d.1523         b.1533 Prince William of Orange d.1584 m.     b.1467 Botho VIII of Stolberg-Wernigerode d.1538       b.1506 Countess Juliana of Stolberg-Wernigerode d.1580 m.     b.1482 Anna of Epstein-Königstein d.1538             Charlotte Brabantina of Nassau     b.1473 Louis de Bourbon-Vendome d.1520       b.1513 Louis de Bourbon-Montpensier d.1582 m.     b.1482 Louise de Bourbon-Montpensier d.1561         b.1547 Charlotte of Bourbon d.1582 m.     b.before 1524 Jacqueline de Longwy-Bar d.1561

Barack Obama

b.1936 Lolo Soetoro d.1987     b.1970 Maya Soetoro       b.1918 Stanley Dunham d.1982       b.1942 Ann Dunham d.1995 m.     b.1922 Madelyn Payne d.2/11/2008         b.1961 Barack Obama m.     Habiba Akumu       b.1936 Barack Obama Sr. d.1982 m.     b.1895 Onyango Obama d.1979       b.1922 Sarak Ogwel       b.1944 Omar Obama       b.1952 Zeituni Onyango       b.circa 1950s Yusuf Obama       b.circa 1950s Said Obama       b.circa 1940 Kezia Grace       b.1958 M Abongo Obama       b.1960 Auma Obama       b.1968 Obo Obama       b.1970 Bernard Obama     b.circa 1940s Ruth Nidesand         Mark Nidesandjo         David Nidesandjo d.circa 1987       b.1998 Malia Ann Obama     b.1935 Fraser Robinson III d.1991       b.1962 Craig Robinson     b.7/1937 Marian Shields       b.1964 Michelle Robinson m.3/8/1992       b.2001 Natasha (Sasha) Obama

b.1936   Lolo Soetoro d.1987     b.1918   Stanley Dunham d.1982       b.1922 Madelyn Payne d.2/11/2008         b.1942 Ann Dunham d.1995   m.       Habiba Akumu       b.1895 Onyango Obama d.1979       b.1922 Sarak Ogwel         b.1936 Barack Obama Sr. d.1982   m.       b.1944 Omar Obama       b.1952 Zeituni Onyango       b.circa 1950s Yusuf Obama       b.circa 1950s Said Obama       b.circa 1940 Kezia Grace       b.circa 1940s Ruth Nidesand       b.1970   Maya Soetoro       b.1961 Barack Obama   m.       b.1958 M Abongo Obama       b.1960 Auma Obama       b.1968 Obo Obama       b.1970 Bernard Obama         Mark Nidesandjo         David Nidesandjo d.circa 1987

b.1935   Fraser Robinson III d.1991       b.7/1937 Marian Shields         b.1962 Craig Robinson       b.1964 Michelle Robinson   m.3/8/1992

b.1998 Malia Ann Obama

b.2001 Natasha (Sasha) Obama

Mixing boxed and not boxed, and with a lineage

{{{par1}}}