Plantilla:Tree chart

De Wikipedia, la enciclopedia libre
Icono de documentación de plantilla Documentación de la plantilla[ver] [editar] [historial] [purgar]


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:

AbuelaAbuelo
MadrePadreTí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
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:

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:
Líneas sólidas:
!
  ,
  v
  .
 
-
  )
  +
  (
 
`
  ^
  '
 
Líneas de guiones:
:
  F
  V
  7
 
~
  D
  %
  C
 
L
  A
  J
 
Líneas punteadas:
Q
  S
  M
  T
 
P
  H
  R
  G
 
Y
  W
  Z
 
Guiones horiz sólido vert:
fy
y
ye
f
t
e
fh
h
he
Sólido horiz guiones vert:
dj
j
jc
d
*
c
di
i
ic
Sólido horiz puntos vert:
kr
r
rl
k
a
l
kq
q
ql
Guiones horiz puntos vert:
kr2
r2
rl2
k2
a2
l2
kq2
q2
ql2
Puntos horiz sólido vert:
om
m
mp
o
b
p
on
n
np
Puntos horiz guiones vert:
om2
m2
mp2
o2
b2
p2
on2
n2
np2
Varios:
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 1Box 2
Box 3Box 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 boxGreen boxBlue 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.

Conectores modificados
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
Conectores varios
Conector {{Árbol genealógico}} {{tree chart}} Notas sobre
parámetros
G G2 Cambiado
K K Igual
T T2 Cambiado
U U Igual
X 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

Esta documentación está transcluida desde Plantilla:Tree chart/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.