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

Function

edit

Purpose

edit

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

edit

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:

edit

parent1  
 
parent2  
 

parent1  
 
 
parent2  
 
 

A sole parent family is:

edit

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:

edit

parent1  
 
  child1 of parents 1 2
parent2  
 

parent1  
 
 
  child1 of parents 1 2
   
parent2  
 
 

The general presentation for a family is:

edit

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:

edit
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
   
     Lineage is from parent to child.

Deficiencies

edit

Bondings between relations

edit

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
edit

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

edit

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

Skeleton

edit
{{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

edit
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

edit

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

edit

My brother Joe

edit

   
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
 

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
 
 
 
 

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

edit

{{{par1}}}