Plantilla:Tree chart/doc

Uso

Esta plantilla produce un gráfico en una fila tipo "árbol genealógico" que consiste en recuadros y líneas de conexión basadas libremente en una sintaxis similar al ASCII art. Está destinado a usarse junto con {{Tree chart/start}} y {{Tree chart/end}}. El gráfico se muestra como tablas HTML utilizando los atributos CSS, y puede contener wikitexto arbitrario dentro de los cuadros. Esta implementación se basó en la plantilla ahora obsoleta {{Árbol genealógico}}.

NOTA: La plantilla también funciona con el nombre abreviado de {{chart}}.

Ejemplo básico

Este código:

{{Tree chart/start|align=center|summary=Un ejemplo de árbol genealógico}}
{{Tree chart| | | |Aba |~|y|~| Abo | |Aba=Abuela|Abo=Abuelo}}
{{Tree chart| | | | | | | |)|-|-|-|.| }}
{{Tree chart| | | Mad |y| Pad | |DAISY|Mad=Madre|Pad=Padre|DAISY=[[Tía Daisy]]}}
{{Tree chart| |,|-|-|-|+|-|-|-|.| | | }}
{{Tree chart| JOE | | YO  | | HMA | | |JOE=Mi hermano Joe|YO='''¡Yo!'''|HMA=Mi hermana pequeña}}
{{Tree chart/end}}

produce esto:

Abuela

Abuelo

Madre

Padre

Tía Daisy

Mi hermano Joe

¡Yo!

Mi hermana pequeña

Este cuadro muestra visualmente la información de que tengo un hermano Joe y una hermana pequeña; mi madre se casó con mi padre; y los padres de mi padre eran abuela y abuelo; y los padres de mi padre tuvieron otro hijo, tía Daisy. El código anterior produce una tabla de tamaño 9 filas x 10 columnas como se muestra a continuación.

La estructura de la tabla creada usando el ejemplo anterior

Ejemplo básico colapsable

Este código usa {{chart top}}:

{{chart top|Un ejemplo de árbol genealógico}}
{{Tree chart/start|align=center}}
{{Tree chart| | | |Aba |~|y|~| Abo | |Aba=Abuela|Abo=Abuelo}}
{{Tree chart| | | | | | | |)|-|-|-|.| }}
{{Tree chart| | | Mad |y| Pad | |DAISY|Mad=Madre|Pad=Padre|DAISY=[[Tía Daisy]]}}
{{Tree chart| |,|-|-|-|+|-|-|-|.| | | }}
{{Tree chart| JOE | | YO  | | HMA | | |JOE=Mi hermano Joe|YO='''¡Yo!'''|HMA=Mi hermana pequeña}}
{{Tree chart/end}}
{{chart bottom}}

produce esto:

Un ejemplo de árbol genealógico

Abuela

Abuelo

Madre

Padre

Tía Daisy

Mi hermano Joe

¡Yo!

Mi hermana pequeña

Este cuadro muestra visualmente la información de que tengo un hermano Joe y una hermana pequeña; mi madre se casó con mi padre; y los padres de mi padre eran abuela y abuelo; y los padres de mi padre tuvieron otro hijo, tía Daisy.

Parámetros

La plantilla acepta cualquier número de parámetros sin nombre y cada parámetro especifica un box (recuadro) o un tile (conector).

Boxes (recuadros) pueden contener wikitexto arbitrario. El contenido de cada cuadro se especifica utilizando parámetros con nombre adicionales agregados a la llamada de plantilla. Cada recuadro tiene tres casillas de ancho y normalmente tiene un borde negro de dos píxeles de ancho. Los cuadros pueden tener cualquier nombre que sea un nombre de parámetro de plantilla válido, sujeto a un mínimo de dos caracteres alfabéticos.
Tiles (conectores) son símbolos de dibujo lineal utilizados para conectar los recuadros. Cada conector ocupa una casilla de ancho. Consisten en varios estilos de líneas horizontales y verticales junto con esquinas y cruces según sea necesario. Las fichas se especifican utilizando su nombre de uno o dos caracteres: para las fichas más comunes, ese carácter es más o menos aproximado a la apariencia de la ficha. Un caso especial es el conector vacío, especificado por un solo carácter de espacio. A continuación se muestra una tabla de conectores disponibles:

!

,

v

.

-

)

+

(

`

^

'

:

F

V

7

~

D

%

C

L

A

J

Q

S

M

T

P

H

R

G

Y

W

Z

fy

y

ye

f

t

e

fh

h

he

dj

j

jc

d

*

c

di

i

ic

kr

r

rl

k

a

l

kq

q

ql

kr2

r2

rl2

k2

a2

l2

kq2

q2

ql2

om

m

mp

o

b

p

on

n

np

om2

m2

mp2

o2

b2

p2

on2

n2

np2

T2

G2

X

K

l4

U

Atributos de estilo

La apariencia de los cuadros en una fila se puede controlar mediante los siguientes parámetros de plantilla opcionales:

border especifica el ancho del borde del cuadro en píxeles,
boxstyle se puede usar para agregar declaraciones arbitrarias CSS directamente a los atributos de estilo de caja. Por ejemplo, el siguiente código:

{{Tree chart/start}}
{{Tree chart|border=1|boxstyle=color:white; background:green; | | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}}
{{Tree chart| | |,|-|^|-|.| | }}
{{Tree chart|border=3|boxstyle=background:yellow; | | FOO | | BAR | |FOO=Box 3|BAR=Box 4}}
{{Tree chart/end}}

produce este cuadro:

Box 1

Box 2

Box 3

Box 4

Los atributos de estilo incluso se pueden establecer para cuadros individuales dentro de cada fila, como en el siguiente ejemplo:

{{Tree chart/start}}
{{Tree chart| | | | |CLEAR| | | | |CLEAR=Clear box}}
{{Tree chart| |,|-|-|'|!|`|-|-|.| }}
{{Tree chart|RED  |~|GREEN|~|BLUE |RED=Red box|GREEN=Green box|BLUE=Blue box
|boxstyle_RED  =color:white; background-color: red;
|boxstyle_GREEN=color:yellow; background-color: green;
|boxstyle_BLUE =color:white; background-color: blue;
}}
{{Tree chart/end}}

que produce esto:

Clear box

Red box

Green box

Blue box

Nota: Al especificar atributos de estilo para cuadros con nombre individuales, asegúrese de que los nombres de los cuadros estén alineados con el lado izquierdo del área reservada para ellos en la llamada de plantilla (como en "|RED |"en lugar de"| RED |" en el ejemplo anterior), de lo contrario, la plantilla terminará buscando un parámetro de estilo con espacios en su nombre.

La plantilla {{Tree chart/start}} también acepta un parámetro opcional |style= que se puede usar para establecer estilos CSS para todo el diagrama, y un parámetro opcional |align= para establecer la alineación del gráfico.

Migración desde Árbol genealógico

La plantilla {{tree chart}} es ampliamente compatible con la plantilla anterior {{Árbol genealógico}}. Sin embargo, para usar la funcionalidad adicional que se ofrece con esta plantilla, los diagramas deben actualizarse para usar {{tree chart}} en su lugar. Muchos diagramas de {{Árbol genealógico}} pueden modificarse para usar {{tree chart}} simplemente reemplazando el wikitexto Árbol genealógico por tree chart. Algunos de los conectores "mixtos" tuvieron que ser renombrados, y los diagramas {{Árbol genealógico}} que usan estos conectores tendrán que hacer algunos cambios. Además, se han incluido tres conectores "varios" en esta lista que no han cambiado: K, U, X.

Tile {{Árbol genealógico}} {{tree chart}} Notas sobre
parámetros

{

c

Cambiado

}

d

Cambiado

#

t

Cambiado

[

e

Cambiado

]

f

Cambiado

b

di

Cambiado

c

fh

Cambiado

d

ic

Cambiado

j

he

Cambiado

n

ye

Cambiado

p

om2

Cambiado

q

mp2

Cambiado

r

kr2

Cambiado

Conector {{Árbol genealógico}} {{tree chart}} Notas sobre
parámetros

G

G2

Cambiado

K

Igual

T

T2

Cambiado

U

Igual

X

Igual

k

l4

Cambiado

Al convertir de {{Árbol genealógico}} a {{tree chart}} se debe tener cuidado con todos los glifos mencionados en esta sección para generar conectores con {{Árbol genealógico}}, teniendo cuidado al modificarlos para que los conectores no se alteren, siendo reemplazados por conectores inapropiados de {{tree chart}}.

Por ejemplo: el glifo "k" genera el conector

con {{Árbol genealógico}}

pero

con {{tree chart}}

(en vez de usar "l4" para generar

con {{tree chart}}).

Por último, si algún uso de la plantilla {{Árbol genealógico}} termina con |}}, esa barra vertical debe eliminarse, dejando la última celda en esa fila que contenga texto o un espacio.

La herramienta familytree.js se puede usar para convertir las distintas sintaxis. Simplemente cámbiese la etiqueta de inicio editando el código, luego hágase clic en "Art → Plantillas" para volver a la vista de wikitexto. Las otras plantillas se actualizarán para que coincidan.

Véase también

en:Wikipedia:Family trees for other methods.
familytree.js, una herramienta para la fácil creación o actualización de diagramas utilizando estas plantillas
en:Category:Family tree templates
en:Template:Nerva–Antonine family tree, un ejemplo muy completo
Familia Kennedy, otro ejemplo muy completo
Plantilla:Árbol genealógico
Plantilla:Ahnentafel