Predefinição:Chart/doc

Uso

Este modelo produz um gráfico numa ficha tipo "árvore genealógica" que consiste em caixas e linhas de conexão baseadas livremente numa sintaxe similar ao ASCII art. Está destinado a usar-se junto com {{Chart/start}} e {{Chart/end}}. O gráfico mostra-se como tabelas HTML utilizando os atributos CSS, e pode conter wikitexto arbitrário dentro dos quadros. Esta implementação baseou-se no modelo agora obsoleto {{árvore genealógica}}.

NOTA: O modelo também funciona com o nome abreviado de {{chart}}.

Exemplo básico

Este código:

{{Chart/start|align=center|summary=Um exemplo de árvore genealógica}}
{{Chart||| |Aba |~|e|~| Abo||Aba=Avó|Abo=Avô}}
{{Chart||||||| |)|-|-|-|.| }}
{{Chart||| Mad |e| Pad||DAISY|Mad=Mãe|Pad=Pai|DAISY=[[Tia Daisy]]}}
{{Chart| |,|-|-|-|+|-|-|-|.||| }}
{{Chart| JOE|| EU || HMA|| |JOE=Meu irmão Joe|EU='''Eu!'''|HMA=Minha irmã pequena}}
{{Chart/end}}

produz isto:

Este quadro mostra visualmente a informação de que tenho um irmão Joe e uma irmã pequena; minha mãe casou-se com meu pai; e os pais de meu pai eram avó e avô; e os pais de meu pai tiveram outro filho, tia Daisy. O código anterior produz uma tabela de tamanho 9 bichas x 10 colunas como se mostra a seguir.

Exemplo básico colapsable

Este código usa {{chart top}}: <pré> {{chart top|Um exemplo de árvore genealógica}} {{Chart/start|align=center}} {{Chart||| |Aba |~|e|~| Abo||Aba=Avó|Abo=Avô}} {{Chart||||||| |)|-|-|-|.| }} {{Chart||| Mad |e| Pad||DAISY|Mad=Mãe|Pad=Pai|DAISY=[[Tia Daisy]]}} {{Chart| |,|-|-|-|+|-|-|-|.||| }} {{Chart| JOE|| EU || HMA|| |JOE=Meu irmão Joe|EU='''Eu!'''|HMA=Minha irmã pequena}} {{Chart/end}} {{chart bottom}} </pré>

produz isto: Predefinição:Chart top

Este quadro mostra visualmente a informação de que tenho um irmão Joe e uma irmã pequena; minha mãe casou-se com meu pai; e os pais de meu pai eram avó e avô; e os pais de meu pai tiveram outro filho, tia Daisy.

Parâmetros

O modelo aceita qualquer número de parâmetros sem nome e cada parâmetro especifica um box (caixa) ou um tile (conector).

• Boxes (caixas) podem conter wikitexto arbitrário. O conteúdo de cada quadro especifica-se utilizando parâmetros com nome adicionais agregados ao telefonema de modelo. Cada caixa tem três lacunas de largura e normalmente tem uma borda negra de dois pixels de largura. Os quadros podem ter qualquer nome que seja um nome de parâmetro de modelo válido, sujeito a um mínimo de dois caracteres alfabéticos.
• Tiles (conectores) são símbolos de desenho linear utilizados para ligar as caixas. Cada conector ocupa uma lacuna de largura. Consistem em vários estilos de linhas horizontais e verticais junto com cantos e cruzes segundo seja necessário. As fichas especificam-se utilizando seu nome de um ou dois caracteres: para as fichas mais comuns, esse carácter é mais ou menos aproximado à aparência da ficha. Um caso especial é o conector vazio, especificado por um sozinho carácter de espaço. A seguir mostra-se uma tabela de conectores disponíveis:

Linhas sólidas:

!			,			v			.
-			)			+			(
			`			^			'

Linhas de guiões:

:			F			V			7
~			D			%			C
			L			A			J

Linhas punteadas:

Q			S			M			T
P			H			R			G
			E			W			Z

Guiões horiz sólido vert:

fy		e		ye
f		t		e
fh		h		tenho

Sólido horiz guiões vert:

dj		j		jc
d		*		c
di		i		ic

Sólido horiz pontos vert:

kr		r		rl
k		a		l
kq		q		ql

Guiões horiz pontos vert:

kr2		r2		rl2
k2		a2		l2
kq2		q2		ql2

Pontos horiz sólido vert:

om		m		mp
ou		b		p
on		n		np

Pontos horiz guiões vert:

om2		m2		mp2
ou2		b2		p2
on2		n2		np2

Vários:

		T2
G2		X		K		l4
		Ou

Atributos de estilo

A aparência dos quadros numa bicha pode-se controlar mediante os seguintes parâmetros de modelo opcionais:

• border especifica o largo da borda do quadro em pixels,
• boxstyle pode-se usar para agregar declarações arbitrárias CSS directamente aos atributos de estilo de caixa. Por exemplo, o seguinte código:

<pré> {{Chart/start}} {{Chart|border=1|boxstyle=color:white; background:green;|| FOO |e| BAR||FOO=Box 1|BAR=Box 2}} {{Chart|||,|-|^|-|.||}} {{Chart|border=3|boxstyle=background:yellow;|| FOO|| BAR||FOO=Box 3|BAR=Box 4}} {{Chart/end}} </pré>

produz este quadro:

Os atributos de estilo inclusive podem-se estabelecer para quadros individuais dentro de cada bicha, como no seguinte exemplo:

<pré> {{Chart/start}} {{Chart|||||CLEAR|||||CLEAR=Clear box}} {{Chart| |,|-|-|'|!|`|-|-|.| }} {{Chart|REDE |~|GREEN|~|BLUE |REDE=Rede box|GREEN=Green box|BLUE=Blue box |boxstyle_REDE =color:white; background-color: rede; |boxstyle_GREEN=color:yellow; background-color: green; |boxstyle_BLUE =color:white; background-color: blue; }} {{Chart/end}} </pré>

que produz isto:

Nota: Ao especificar atributos de estilo para quadros com nome individuais, assegure-se de que os nomes dos quadros estejam alinhados com o lado esquerdo da área reservada para eles no telefonema de modelo (como em "|REDE  |"em lugar de"| REDE |" no exemplo anterior), caso contrário, o modelo terminará procurando um parâmetro de estilo com espaços em seu nome.

O modelo {{Chart/start}} também aceita um parâmetro opcional Predefinição:Param que se pode usar para estabelecer estilos CSS pára todo o diagrama, e um parâmetro opcional Predefinição:Param para estabelecer o alinhamento do gráfico.

Migração desde árvore genealógica

O modelo {{chart}} é amplamente compatível com o modelo anterior {{árvore genealógica}}. No entanto, para usar a funcionalidade adicional que se oferece com este modelo, os diagramas devem se actualizar para usar {{chart}} em seu lugar. Muitos diagramas de {{árvore genealógica}} podem modificar-se para usar {{chart}} simplesmente substituindo o wikitexto árvore genealógica por chart. Alguns dos conectores "mistos" tiveram que ser renomeados, e os diagramas {{árvore genealógica}} que usam estes conectores terão que fazer algumas mudanças. Ademais, incluíram-se três conectores "vários" nesta lista que não têm mudado: K, Ou, X.

Conectores modificados

Tile	{{árvore genealógica}}	{{chart}}	Notas sobre parâmetros
	{	c	Mudado
	}	d	Mudado
	#	t	Mudado
	[	e	Mudado
	]	f	Mudado
	b	dei	Mudado
	c	fh	Mudado
	d	ic	Mudado
	j	tenho	Mudado
	n	ye	Mudado
	p	om2	Mudado
	q	mp2	Mudado
	r	kr2	Mudado

Conectores vários

Conector	{{árvore genealógica}}	{{chart}}	Notas sobre parâmetros
	G	G2	Mudado
	K	K	Igual
	T	T2	Mudado
	Ou	Ou	Igual
	X	X	Igual
	k	l4	Mudado

Ao converter de {{árvore genealógica}} a {{chart}} deve-se ter cuidado com todos os glifos mencionados nesta secção para gerar conectores com {{árvore genealógica}}, tendo cuidado ao os modificar para que os conectores não se alterem, sendo substituídos por conectores inapropiados de {{chart}}.

Por exemplo: o glifo "k" gera o conector

Predefinição:Familytree/startPredefinição:Árvore genealógicaPredefinição:Familytree/end

com {{árvore genealógica}}

mas

com {{chart}}

(em vez de usar "l4" para gerar

com {{chart}}).

Por último, se algum uso do modelo {{árvore genealógica}} termina com |}}, essa barra vertical deve eliminar-se, deixando a última cela nessa ficha que contenha texto ou um espaço.

A ferramenta familytree.js pode-se usar para converter as diferentes sintaxes. Simplesmente mude-se a etiqueta de início editando o código, depois clique-se em "Art → Predefinições" para voltar à vista de wikitexto. Os outros modelos actualizar-se-ão para que coincidam.

Ver também

• en:Wirchelp:Family trees for other methods.
• familytree.js, uma ferramenta para a fácil criação ou actualização de diagramas utilizando estes modelos
• en:Category:Family tree templates
• en:Template:Nerva–Antonine family tree, um exemplo muito completo
• Família Kennedy, outro exemplo muito completo
• Predefinição:Árvore genealógica
• Predefinição:Ahnentafel