Modelo:DiagramaenÁrbore

Na Galipedia, a Wikipedia en galego.
Saltar ata a navegación Saltar á procura
Test Template Info-Icon - Version (2).svg Indicacións de uso do modelo

Uso[editar a fonte]

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

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:

AvoaAvó
MamáPapátía María
O meu irmán XoánEu!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[editar a fonte]

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

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 1Caixa 2
Caixa 3Caixa 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 vermellaCaixa verdeCaixa 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[editar a fonte]

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

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

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

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

Este recadro non aparecerá no artigo.
Esta documentación está transcluída desde Modelo:DiagramaenÁrbore/uso. Os editores poden probar cambios no mesmo en Modelo:DiagramaenÁrbore/probas.
Por favor, engade as categorías na subpáxina de documentación e os interwikis no Wikidata. Ver as subpáxinas deste modelo.