View source for Template:Ahnentafel-tree/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

== Usage ==
This template uses the {{tlx|tree list}} template to build an ancestry tree using [[Ahnentafel]] numbering. Currently, it will create a tree down to 511 Ahnentafel places. However, it can be filled out to any arbitrary number. To do this, add:
<pre>
 {{Ahnentafel-tree
 |r_1=''subject''
 |r_2=''father''
 |r_3=''mother''
 |r_4=''paternal father''
 ...
 |r_7='''maternal grand mother''
 ...
 |r_511=''6th great-grandmother'' (generation 9)
 }}
</pre>
For compatability with {{tlx|Ahnentafel}}, <code>r_1 ... r_511</code> can be substituted with unnamed parameters: <code>1 ... 511</code>
<pre>
 {{Ahnentafel-tree
 |1=''subject''
 |2=''father''
 |...
</pre>
:—&nbsp;or&nbsp;—
<pre>
 {{Ahnentafel-tree
 |''subject''
 |''father''
 |...
</pre>

If you only wanted to display down to the level of parents, then this will suffice:
<pre>
 {{Ahnentafel-tree
 |title=Parents of subject
 |color_1=translucent
 |color_2=translucenti
 |r_1=''subject''
 |r_2=''father''
 |r_3=''mother''
 }}
</pre>
and the rest of the tree will not be displayed:
 {{Ahnentafel-tree
 |title=Parents of subject
 |color_1=translucent
 |color_2=translucent
 |r_1=''subject''
 |r_2=''father''
 |r_3=''mother''
 }}

If the male of a couple is given without the female, then a blank will be inserted as a placeholder for the female; and likewise, for a missing male, when only the female is given. This is to keep the tree properly lined up, having the correct indentation. 

If neither male nor female are added, the couple will not appear. 

The template is not idiot-proof; if you do not add a couple, but do add their ancestors, you will probably break the layout of the tree. Instead, leave them "blank" by typing dashes as placeholders whenever you have no information about a given person, but you do have info on that person's ancestors. (This can sometimes happen for wives; eg, "a daughter of Lord such and such".) 

Note: There seems to be a bug in the underlying software, and the link from subject to mother breaks the tree graphic when there are more than about 6 generations (something to do with the flat number of entries, rather than the depth in generations).

===Additional parameters to alter the look and feel===
 |title=''title'' — defaults to "Ancestry of PAGENAME"
 |expanded=on  — defaults to off can be set to "on"
Sets background colour (''translucent'' for no colour)=
 |color_1=''colour'' — defaults to {{Ahnentafel-tree/bc|#fcc;|background #fcc;}}
 |color_2=''colour'' — defaults to {{Ahnentafel-tree/bc|silver|background silver}} 
 |color_3=''colour'' — defaults to {{Ahnentafel-tree/bc|#ffc;|background #ffc;}}
 |color_4=''colour'' — defaults to {{Ahnentafel-tree/bc|#bfc;|background #bfc;}}
 |color_5=''colour'' — defaults to {{Ahnentafel-tree/bc|#9fe;|background #9fe;}}
 |color_6=''colour'' — defaults to {{Ahnentafel-tree/bc|#ffc;|background #ffc;}}
 |color_7=''colour'' — defaults to {{Ahnentafel-tree/bc|#bfc;|background #bfc;}}
 |color_8=''colour'' — defaults to {{Ahnentafel-tree/bc|#9fe;|background #9fe;}}
 |color_9=''colour'' — defaults to {{Ahnentafel-tree/bc|translucent|background translucent}}

==Sub templates==
*<nowiki>{{</nowiki>[[Template:Ahnentafel-tree/main|Ahnentafel-tree/main]]|...<nowiki>}}</nowiki> — main template for Ahnentafel-tree this allows default values to be set for parameters (such as colours) then to be used within the sub template.
*<nowiki>{{</nowiki>[[Template:Ahnentafel-tree/bc|Ahnentafel-tree/bc]]|''colour''|''text''<nowiki>}}</nowiki> — for background colour
*{{tl|Ahnentafel-tree/couple}} — see {{tl|Ahnentafel-tree/couple/doc}} for a description of the six unnamed parameters.

==See also ==
*[[Wikipedia:Family trees]] — for alternatives
*{{tlx|Ahnentafel/doc}}
*{{tlx|Chart}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Ahnentafel formatting templates‎|Tree]]
}}</includeonly>