Modelo:DiagramaenÁrbore/uso

Uso

Este modelo produce unha fila nun diagrama do estilo "árbore de familia" consistente en caixas e liñas de conexión baseado na sintaxe da Arte ASCII. Debe ser usado xunto con {{Diagrama/inicio}} e {{Diagrama/fin}}. O diagrama visualízase como táboas HTML usando atributos CSS, e pode conter etiquetas wiki dentro das caixas. Este modelo está baseado no modelo, agora obsoleto, {{Árbore xenealóxica}}.

Exemplo básico

Este código:

{{DiagramaenÁrbore/inicio}}
{{DiagramaenÁrbore| | | |GrMa |~|y|~| GRP | |GrMa=Avoa|GRP=Avó}}
{{DiagramaenÁrbore| | | | | | | |)|-|-|-|.|}}
{{DiagramaenÁrbore| | | MOM |y| DAD | |DAISY|MOM=Mamá|DAD=Papá|DAISY=[[Tía María]]}}
{{DiagramaenÁrbore| |,|-|-|-|+|-|-|-|.| | |}}
{{DiagramaenÁrbore| JOE | | ME  | | SIS | | |JOE=O meu irmán Xoán|ME='''Eu!'''|SIS=A miña irmá pequena}}
{{DiagramaenÁrbore/fin}}

produce isto:

Avoa

Avó

Mamá

Papá

tía María

O meu irmán Xoán

Eu!

A miña irmá pequena

Este diagrama mostra visualmente a información sobre unha árbore xenealóxica onde unha persoa ten un irmán Xoán e unha pequena irmá, o seu pai e a súa nai, e os pais do seu pai, os seus avós, e a súa tía María.

Parámetros

O modelo acepta calquera número de parámetros sen nome con cada parámetro especificando un título ou unha caixa.

• As caixas poden conter etiquetas wiki. O contido de cada caixa indícase usando parámetros con nome adicionais pegado á chamada do modelo. Cada caixa ten un ancho de tres conectores e normalmente ten un bordo negro de dous pixels de ancho. As caixas poden ter calquera nome que sexa un nome de parámetro de modelo válido, suxeito a un mínimo de dos caracteres alfanuméricos.

• Os conectores son os símbolos para debuxar as liñas usados para conectar as caixas. Consisten en varios estilos de liñas horizontais e verticais xunto coas esquinas e cruces necesarias. Os conectores especifícanse usando os seus nomes de un, ou dous, caracteres: para os conectores máis comúns, ese carácter é máis ou menos similar á aparencia do conector. Un caso especial de conector é o conector baleiro, especificado por un simple carácter en branco. Debaixo hai unha táboa cos conectores dispoñibles.

Liñas continuas:

!			,			v			.
-			)			+			(
			`			^			'

Liñas descontinuas:

:			F			V			7
~			D			%			C
			L			A			J

Liñas de puntos:

Q			S			M			T
P			H			R			G
			Y			W			Z

Mixtos:

j

y

r

m

r2

m2

d

*

c

f

t

e

k

a

l

o

b

p

k2

a2

l2

o2

b2

p2

i

h

q

n

q2

n2

Atributos de estilo

A aparencia das caixas nunha fila pode ser controlada polos seguintes parámetros de modelo opcionais:

• border especifica o ancho do bordo da caixa en pixels,
• boxstyle pode usarse para aplicar declaracións CSS directamente ós atributos de estilo da caixa. Por exemplo, o seguinte código:

{{DiagramaenÁrbore/inicio}}
{{DiagramaenÁrbore|border=1|boxstyle=background:green;  | | FOO |y| BAR | |FOO=Caixa 1|BAR=Caixa 2}}
{{DiagramaenÁrbore | | |,|-|^|-|.| |}}
{{DiagramaenÁrbore|border=3|boxstyle=background:yellow; | | FOO | | BAR | |FOO=Caixa 3|BAR=Caixa 4}}
{{DiagramaenÁrbore/fin}}

produce este Diagrama:

Caixa 1

Caixa 2

Caixa 3

Caixa 4

Os atributos de estilo poden poñerse tamén en caixas individuais en cada fila, como no exemplo de abaixo:

{{DiagramaenÁrbore/inicio}}
{{DiagramaenÁrbore| | | | |BRANCO| | | | |BRANCO=Caixa branca}}
{{DiagramaenÁrbore| |,|-|-|'|!|`|-|-|.|}}
{{DiagramaenÁrbore|VERMELLO  |~|VERDE|~|AZUL|VERMELLO=Caixa vermella|VERDE=Caixa verde|AZUL=Caixa azul
|boxstyle_VERMELLO  =background-color: red;
|boxstyle_VERDE=background-color: green;
|boxstyle_AZUL =background-color: blue;
}}
{{DiagramaenÁrbore/fin}}

que produce:

Caixa branca

Caixa vermella

Caixa verde

Caixa azul

Nota: Cando se especifican atributos de estilo para caixas con nome individuais, asegúrese de que os nomes das caixas están aliñados ó lado esquerdo da área reservada para eles na chamada ó modelo (como en "|VERMELLO  |" no canto de "| VERMELLO |" no exemplo de arriba), noutro caso o modelo atoparase buscando un parámetro de estilo con espazos no seu nome.

O modelo {{Diagrama/inicio}} tamén acepta un parámetro |estilo= opcional que pode usarse para fixar estilos CSS para o diagrama completo, e un parámetro |aliñamento= opcional para fixar o aliñamento do diagrama.

Migración dende Árbore xenealóxica

O modelo {{Diagrama}} é moi compatible co modelo {{Árbore xenealóxica}} anterior. Pero, para usar as funcionalidades adicionais ofrecidas neste modelo, os diagramas deben ser actualizados para usar {{Diagrama}}. Varios diagramas {{Árbore xenealóxica}} poden ser modificados para usar {{Diagrama}} simplemente cambiando o texto wiki Árbore xenealóxica con Diagrama. Uns poucos dos conectores "mixtos" deben ser renomeados, e os diagramas {{Árbore xenealóxica}} que usan eses conectores terán que facer uns poucos cambios. Adicionalmente, engadíronse dous conectores "mixtos", unindo liñas continuas con liñas descontinuas. A seguinte táboa resume as diferenzas:

Forma	{{Árbore xenealóxica}}	{{Diagrama}}
	{	c
	}	d
	#	t
	[	e
	]	f
		i
		j

A seguinte lista de conectores existe en {{Árbore xenealóxica}}, pero non existe en {{Diagrama}}. Cando se converte de {{Árbore xenealóxica}} a {{Diagrama}} hai que ter coidado de non cambiar a árbore xa que eses conectores non son usados.

Hex Glifo Árbore xenealóxica Diagrama 47 G 4B K {{{K}}} 54 T 55 U {{{U}}} 58 X {{{X}}} 62 b 63 c

Hex Glifo Árbore xenealóxica Diagrama 64 d 6A j 6B k 6E n 70 p 71 q 72 r

Cando se convirte de {{Árbore xenealóxica}} a {{Diagrama}} hai que ter coidado con todos os glifos mencionados nesta sección para xerar concetores con {{Árbore xenealóxica}} son cambiados de forma que os conectores non son cambiados de forma inadvertida con conectores inapropiados de {{Diagrama}}.

Por exemplo: o glifo "k" xera o conector

con {{Árbore xenealóxica}}

pero xera

con {{Diagrama}}

Finalmente, se calquera uso do modelo {{Árbore xenealóxica}} remata con |}}, esa barra vertical debe eliminarse, deixando a última cela desa fila só co texto ou un espazo.

Ferramenta de edición familytree.js

Vista de edición dun modelo Diagrama usando o trebello familytree.

A ferramenta de edición familytree.js permite editar as páxinas que conteñen o modelo diagrama como se fosen unha árbore visualizada coma arte ASCII.

Instalación

Para instalar familytree.js só hai que engadir a liña de código importScript("Usuario:Elisardojm/familytree.js"); no seu ficheiro monobook.js ou vector.js.

Uso

Para usar familytree.js simplemente hai que editar a páxina que conteña o modelo Diagrama co cal aparecerá unha nova ligazón na caixa de ferramentas da esquerda, "Modelo→Arte ASCII", isto mostrará a árbore en formato de arte ASCII, como aparece na imaxe da esquerda, e será máis doada de editar.

Se queremos previsualizar os cambios que fagamos, antes de premer o botón "Mostrar vista previa" temos que premer na ligazón da ferramenta, que cambiou ó nome "Arte ASCII→Modelo", para que a previsualización se mostre correctamente.

Cando o resultado sexa o que queremos temos que pasar de novo á visualización "Modelo→Arte ASCII" para que o modelo se garde correctamente.

Véxase tamén

• familytree.js, unha ferramenta para a creación simple ou para actualizar diagramas usando estes modelos.
• Categoría:Árbores xenealóxicas
• Modelo:Árbore xenealóxica Nerva–Antonina, un exemplo grande.