De Família Corsi
Ir para navegação Ir para pesquisar

Predefinição:Documentation subpage

Uso[editar]

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[editar]

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:

AvóAvô
MãePaiTia Daisy
Meu irmão JoeEu!Minha irmã pequena

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.

A estrutura da tabela criada usando o exemplo anterior
A estrutura da tabela criada usando o exemplo anterior

Exemplo básico colapsable[editar]

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

AvóAvô
MãePaiTia Daisy
Meu irmão JoeEu!Minha irmã pequena

Predefinição:Chart bottom

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[editar]

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
{{{E}}}
  W
  Z
 
Guiões horiz sólido vert:
fy
{{{fy}}}
e
ye
{{{ye}}}
f
t
e
fh
{{{fh}}}
h
tenho
{{{tenho}}}
Sólido horiz guiões vert:
dj
{{{dj}}}
j
jc
{{{jc}}}
d
*
c
di
{{{di}}}
i
ic
{{{ic}}}
Sólido horiz pontos vert:
kr
{{{kr}}}
r
rl
{{{rl}}}
k
a
l
kq
{{{kq}}}
q
ql
{{{ql}}}
Guiões horiz pontos vert:
kr2
{{{kr2}}}
r2
rl2
{{{rl2}}}
k2
a2
l2
kq2
{{{kq2}}}
q2
ql2
{{{ql2}}}
Pontos horiz sólido vert:
om
{{{om}}}
m
mp
{{{mp}}}
ou
{{{ou}}}
b
p
on
{{{on}}}
n
np
{{{np}}}
Pontos horiz guiões vert:
om2
{{{om2}}}
m2
mp2
{{{mp2}}}
ou2
{{{ou2}}}
b2
p2
on2
{{{on2}}}
n2
np2
{{{np2}}}
Vários:
T2
{{{T2}}}
G2
{{{G2}}}
X
{{{X}}}
K
{{{K}}}
l4
{{{l4}}}
Ou
{{{Ou}}}

Atributos de estilo[editar]

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:

Box 1Box 2
Box 3Box 4

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:

Clear box
Rede boxGreen boxBlue box

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[editar]

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
{{{dei}}}
b dei Mudado
{{{fh}}}
c fh Mudado
{{{ic}}}
d ic Mudado
{{{tenho}}}
j tenho Mudado
{{{ye}}}
n ye Mudado
{{{om2}}}
p om2 Mudado
{{{mp2}}}
q mp2 Mudado
{{{kr2}}}
r kr2 Mudado
Conectores vários
Conector {{árvore genealógica}} {{chart}} Notas sobre
parâmetros
{{{G2}}}
G G2 Mudado
{{{K}}}
K K Igual
{{{T2}}}
T T2 Mudado
{{{Ou}}}
Ou Ou Igual
{{{X}}}
X X Igual
{{{l4}}}
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
{{{l4}}}
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[editar]


Cookies nos ajudam a entregar nossos serviços. Ao usar nossos serviços, você concorda com o uso de cookies.