Edytujesz Szablon:Familytree/opis

en szablon służy do łatwego renderowania Drzew genealogicznych, za pomocą parametrów przypominających ASCII-Art. Drzewo jest wyświetlane za pomocą tabeli HTML i atrybutów CSS. Może też zawierać formatowanie wiki.

==Przykładowe użycie==
Ten kod:
<pre><nowiki>
{{familytree/start}}
{{familytree | | | | BB  |~|y|~| DD  | | BB=Babcia|DD=Dziadek}}
{{familytree | | | | | | | |)|-|-|-|.| }}
{{familytree | | | MM  |y| TT  | |LUSIA| MM=Mama|TT=Tata|LUSIA=Ciocia Lusia}}
{{familytree | |,|-|-|-|+|-|-|-|.| | | }}
{{familytree | JAS | | JA  | | SS  | | | JAS=Mój brat, Jaś|JA='''Ja!'''|SS=Moja mała siostra}}
{{familytree/end}}
</nowiki></pre>
Daje:

{{familytree/start}}
{{familytree | | | | BB  |~|y|~| DD  | | BB=Babcia|DD=Dziadek}}
{{familytree | | | | | | | |)|-|-|-|.| }}
{{familytree | | | MM  |y| TT  | |LUSIA| MM=Mama|TT=Tata|LUSIA=Ciocia Lusia}}
{{familytree | |,|-|-|-|+|-|-|-|.| | | }}
{{familytree | JAS | | JA  | | SS  | | | JAS=Mój brat, Jaś|JA='''Ja!'''|SS=Moja mała siostra}}
{{familytree/end}}


Przykładowe drzewo genealogiczne (szczególnie dla historyków):

{{familytree/start}}
{{familytree| X16 |.| | | | | | | | | | | | | | | |X16=Szesnaście}}
{{familytree| | | |)| X8  |.| | | | | | | | | | | |X8=Osiem}}
{{familytree| X17 |'| | | |!| | | | | | | | | | | |X17=Siedemnaście}}
{{familytree| | | | | | | |)| X4  |.| | | | | | | |X4=Cztery}}
{{familytree| X18 |.| | | |!| | | |!| | | | | | | |X18=Osiemnaście}}
{{familytree| | | |)| X9  |'| | | |!| | | | | | | |X9=Dziewięć}}
{{familytree| X19 |'| | | | | | | |!| | | | | | | |X19=Dziewiętnaście}}
{{familytree| | | | | | | | | | | |)| X2  |.| | | |X2=Dwa}}
{{familytree| X20 |.| | | | | | | |!| | | |!| | | |X20=Dwadzieścia}}
{{familytree| | | |)| X10 |.| | | |!| | | |!| | | |X10=Dziesięć}}
{{familytree| X21 |'| | | |!| | | |!| | | |!| | | |X21=Dwadzieścia jeden}}
{{familytree| | | | | | | |)| X5  |'| | | |!| | | |X5=Pięć}}
{{familytree| X22 |.| | | |!| | | | | | | |!| | | |X22=Dwadzieścia dwa}}
{{familytree| | | |)| X11 |'| | | | | | | |!| | | |X11=Jedenaście}}
{{familytree| X23 |'| | | | | | | | | | | |!| | | |X23=Dwadzieścia trzy}}
{{familytree| | | | | | | | | | | | | | | |)| X1  |X1='''Jeden'''}}
{{familytree| X24 |.| | | | | | | | | | | |!| | | |X24=Dwadzieścia cztery}}
{{familytree| | | |)| X12 |.| | | | | | | |!| | | |X12=Dwanaście}}
{{familytree| X25 |'| | | |!| | | | | | | |!| | | |X25=Dwadzieścia pięć}}
{{familytree| | | | | | | |)| X6  |.| | | |!| | | |X6=Sześć}}
{{familytree| X26 |.| | | |!| | | |!| | | |!| | | |X26=Dwadzieścia sześć}}
{{familytree| | | |)| X13 |'| | | |!| | | |!| | | |X13=Trzynaście}}
{{familytree| X27 |'| | | | | | | |!| | | |!| | | |X27=Dwadzieścia siedem}}
{{familytree| | | | | | | | | | | |)| X3  |'| | | |X3=Trzy}}
{{familytree| X28 |.| | | | | | | |!| | | | | | | |X28=Dwadzieścia osiem}}
{{familytree| | | |)| X14 |.| | | |!| | | | | | | |X14=Czternaście}}
{{familytree| X29 |'| | | |!| | | |!| | | | | | | |X29=Dwadzieścia dziewięć}}
{{familytree| | | | | | | |)| X7  |'| | | | | | | |X7=Siedem}}
{{familytree| X30 |.| | | |!| | | | | | | | | | | |X30=Trzydzieści}}
{{familytree| | | |)| X15 |'| | | | | | | | | | | |X15=Piętnaście}}
{{familytree| X31 |'| | | | | | | | | | | | | | | |X31=Trzydzieści jeden}}
{{familytree/end}}

==Parametry==
Ten szablon tak naprawdę wyświetla jeden wiersz w tabeli z drzewem genealogicznym. Pozwala na użycie do 99 nienazwanych parametrów, opisujących zawartość tabeli. Każdy parametr oznacza '''linię''' lub '''pudełko'''.

*Parametry typu '''linia''' dają fragmenty zawierające różne poziome, pionowe linie, oraz rogi i skrzyżowania. Są ustawiane pojedynczym znakiem, który mniej lub bardziej przypomina kształt wynikowy. Specjalnym typem są '''puste miejsca''', ustawiane pojedynczą spacją. Tabelka działających poleceń znajduje się poniżej.


{|style="float:left;margin-left:1em"
|+ '''Linie ciągłe:'''
|-
| <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}} 
| <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"
|+ '''Linie przerywane:'''
|-
| <big><tt>F</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|F}}
{{familytree/end}}
| <big><tt>V</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|V}}
{{familytree/end}}
| <big><tt>7</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|7}}
{{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>C</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|C}}
{{familytree/end}}
|-
| <big><tt>L</tt></big> ||style="border: 1px solid gray"|
{{familytree/start}}
{{familytree|L}}
{{familytree/end}}
| <big><tt>A</tt></big> ||style="border: 1px solid gray"|
{{familytree/start}}
{{familytree|A}}
{{familytree/end}}
| <big><tt>J</tt></big> ||style="border: 1px solid gray"|
{{familytree/start}}
{{familytree|J}}
{{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"
|+ '''Mieszane:'''
|-
| <big><tt>r</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|r}}
{{familytree/end}}
| <big><tt>y</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|y}}
{{familytree/end}}
| <big><tt>n</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|n}}
{{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>c</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|c}}
{{familytree/end}}
| <big><tt>h</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|h}}
{{familytree/end}}
| <big><tt>j</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|j}}
{{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"
|+ '''Mieszane:'''
|-
| <big><tt>p</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|p}}
{{familytree/end}}
| <big><tt>u</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|u}}
{{familytree/end}}
| <big><tt>q</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|q}}
{{familytree/end}}
|-
| <big><tt>E</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|E|}}
{{familytree/end}}
| <big><tt>*</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|*}}
{{familytree/end}}
| <big><tt>3</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|3|}}
{{familytree/end}}
|-
| <big><tt>b</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|b}}
{{familytree/end}}
| <big><tt>t</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|t|}}
{{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}}
|}
{|style="float:left;margin-left:1em"
|+ '''Różne'''
|-
| ||
| <big><tt>T</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|T}}
{{familytree/end}}
|-
| <big><tt>G</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|G}}
{{familytree/end}}
| <big><tt>X</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|X}}
{{familytree/end}}
| <big><tt>K</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|K}}
{{familytree/end}}
| <big><tt>k</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|k}}
{{familytree/end}}
|-
| ||
| <big><tt>U</tt></big> ||style="border:1px solid gray"|
{{familytree/start}}
{{familytree|U}}
{{familytree/end}}
|}
<br clear="left" />

*Parametry typu '''pudełko''' mogą zawierać tekst i formatowanie wiki. Ich zawartość jest ustalana dodatkowymi, nazwanymi parametrami, dodawanymi do wywołania szablonu. Każde pudełko ma szerokość '''trzech pól typu linia''', i ma obramowanie na 2 pixele. Pudełka mogą mieć dowolną nazwę, która jest prawidłową nazwą parametru w szablonie, lecz nazwy jednoznakowe powinny być unikane, gdyż mogą powodować konflikty z symbolami linii.

==Atrybuty stylu==
Szablon familytree ma opcjonalny parametr ''style'', można za jego pomocą ustalić style dla całej tabelki.

----

Wygląd pudełek może być kontrolowany dzięki opcjonalnym parametrom ''border'' i ''boxstyle''. Pierwszy ustala grubość obramowania w pixelach, a drugi - pozwala na dodanie specjalnych stylów CSS do danego pudełka. Na przykład, poniższy kod:

<pre><nowiki>
{{familytree/start}}
{{familytree|border=0|boxstyle=background:#dfd;| |  a  |y|  b  | |a=Pudełko 1|b=Pudełko 2}}
{{familytree|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }}
{{familytree|border=0|boxstyle=background:#dfd;| |  c  | |  d  | |c=Pudełko 3|d=Pudełko 4}}
{{familytree/end}}
</nowiki></pre>

daje taki wynik:

{{familytree/start}}
{{familytree|border=0|boxstyle=background:#dfd;| |  a  |y|  b  | |a=Pudełko 1|b=Pudełko 2}}
{{familytree|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }}
{{familytree|border=0|boxstyle=background:#dfd;| |  c  | |  d  | |c=Pudełko 3|d=Pudełko 4}}
{{familytree/end}}

Style mogą być też ustalane dla poszczególnych pudełek, w ten sposób:

'''UWAGA:''' Kiedy chcesz ustawić style dla pojedynczych pudełek, upewnij się, że ich nazwy są wyrównane '''do lewej strony''' miejsca dla nich (jak "<code>|CZE&nbsp;&nbsp;|</code>" zamiast "<code>|&nbsp;CZE&nbsp;|</code>" w przykładzie poniżej). W przeciwnym razie szablon będzie szukał parametrów ze spacją.

<pre><nowiki>
{{familytree/start}}
{{familytree| | | | |BIA  | | | | |BIA=Białe pudełko}}
{{familytree| |,|-|-|'|!|`|-|-|.| }}
{{familytree|CZE  |~|ZIE  |~|NIE  |CZE=Czerwone pudełko|ZIE=Zielone pudełko|NIE=Niebieskie pudełko
|boxstyle_CZE=background-color: #faa;
|boxstyle_ZIE=background-color: #afa;
|boxstyle_NIE=background-color: #aaf;
}}
{{familytree/end}}
</nowiki></pre>

co daje:

{{familytree/start}}
{{familytree| | | | |BIA  | | | | |BIA=Białe pudełko}}
{{familytree| |,|-|-|'|!|`|-|-|.| }}
{{familytree|CZE  |~|ZIE  |~|NIE  |CZE=Czerwone pudełko|ZIE=Zielone pudełko|NIE=Niebieskie pudełko
|boxstyle_CZE=background-color: #faa;
|boxstyle_ZIE=background-color: #afa;
|boxstyle_NIE=background-color: #aaf;
}}
{{familytree/end}}

<includeonly>
<!-- DODAJ KATEGORIE PONIŻEJ TEJ LINII -->
[[Kategoria: Szablony do tworzenia drzew genealogicznych]]

<!-- DODAJ INTERWIKI PONIŻEJ TEJ LINII -->
</includeonly>
[[Kategoria:Szablony]]