Modelo:Barlabel

Ningún cladograma especificado!

[ máis información | ver o historial | | | ver as instrucións ]

Indicacións de uso do modelo

Este modelo utilízase para engadir etiquetas a corchetes e barras que foron engadidos a cladogramas usando {{cladex}}.

Uso

1. Primeiro cree o cladograma usando {{cladex}} e {{clade}}, segundo sexa o máis apropiado.
2. Despois incruste o cladograma dentro deste modelo como o valor |cladogram=.

Exemplo

Supoñamos que se creou un cladograma como o de abaixo.

GM	A1     A2     A3   M   C1   C2   G1      G2     G3

Para poñerlle etiquetas aos dous grupos identificados no cladograma faise o seguinte:

• Cóntase o número de nodos folla do cladograma; aquí hai 7. O parámetro size axústase a 7.
• Decídese en que nodos folla quere colocar as etiquetas. Para centrar as etiquetas, a etiqueta para o grupo verde debería estar en fronte do nodo 3; a etiqueta para o grupo púrpura debería estar entre os nodos folla 5 e 6, é dicir, en fronte ao nodo folla "5.5". Os parámetros at do módulo axústanse a eses valores.

A expresión completa requirida móstrase abaixo (excluíndo o código para crear o cladograma).

{{Barlabel
|size=7
|at1=3|label1=Grupo 1|bar1=green
|at2=5.5|label2=Grupo 2|bar2=purple
|cladogram=...
}}

Isto produce

GM   A1     A2     A3   M   C1   C2   G1      G2     G3

Grupo 1 Grupo 2

Para reducir o tamaño da fonte do cladograma e as súas etiquetas, úsase o parámetro style. Así

{{Barlabel
|style=font-size:85%
|size=7
|at1=3|label1=Grupo 1|bar1=green
|at2=5.5|label2=Grupo 2|bar2=purple
|cladogram=...
}}

produces

GM   A1     A2     A3   M   C1   C2   G1      G2     G3

Group 1 Group 2

O cladograma pode ser aliñado á dereita, co texto fluíndo arredor del á esquerda, pero neste caso débese especificar o espazo permitido para as etiquetas usando o parámetro labelwidth, doutro modo as etiquetas aparecerán á dereita da páxina. Será necesario probar polo método do ensaio e erro para axustalo, pero xeralmente un bo punto de partida para empezar a probar é aproximadamente o 60% do número de caracteres na etiqueta máis longa. Así

{{Barlabel
|style=font-size:85%|align=right|labelwidth=4.5
|size=7
|at1=3|label1=Grupo 1|bar1=green
|at2=5.5|label2=Grupo 2|bar2=purple
|cladogram=...
}}

orixina o cladograma de abaixo á dedreita.

GM   A1     A2     A3   M   C1   C2   G1      G2     G3

Grupo 1 Grupo 2

O cladograma pode ser situado centralmente na páxina ao especificar |align=center ou |align=centre. O parámetro labelwidth é necesario para asegurar que o cladograma quede centrado; se se omite, as etiquetas serán ignoradas en canto a determinar a súa situación. Así

{{Barlabel
|style=font-size:85%|align=center|labelwidth=4.5
|size=7
|at1=3|label1=Grupo 1|bar1=green
|at2=5.5|label2=Grupo 2|bar2=purple
|cladogram=...
}}

produce

GM   A1     A2     A3   M   C1   C2   G1      G2     G3

Grupo 1 Grupo 2

O cladograma pode tamén ser aliñado á esquerda co texto fluíndo arredor del á dereita usando |align=left. De novo é necesario o parámetro labelwidth, doutro modo as etiquetas vanse solapar co texto.

(O modelo pode usarse para aliñar cladogramas sen corchetes/barras e etiquetas, aínda que {{cladograma}} ofrece máis opcións para facer isto.)

Parámetros

• size debe ser establecido no número total de nodos folla do cladograma, por exemplo |size=23.

Poden especificarse ata seis niveis de etiquetas. Están identificadas polo díxito indicado no nome do parámetro. Cada etiqueta require tres parámetros, por exemplo at2, label2 e bar2 para a segunda etiqueta. Non hai conexión entre estes números e os números usados para idenficiar os nodos fillos en {{clade}} ou {{cladex}}. O "1" pode omitirse, é dicir at, label e bar son equivalentes a at1, label1 e bar1.

• atN define a posición da etiqueta N en termos da posición do nodo folla no cladograma completo, empezando desde 1 e acabando no valor de size. A etiqueta sitúase en fronte do nodo folla elixido. Para unha etiqueta entre dous nodos folla, use a media. Así para situar a primeira etiqueta en fronte do nodo folla 6, úsase |at1=6; para situar a terceira etiqueta en fronte dun punto entre os nodos folla 6 e 7, úsase |at3=6.5.
• labelN define o texto da etiqueta N. Así para poñer a terceira etiqueta co texto "Grupo 3", úsase |label3=Grupo 3.
• barN define a cor da etiqueta N. Así para poñer a segunda etiqueta co texto en cor verde, úsase |bar3=green. (O nome bar é consistente con {{cladex}}; porén, poden usarse no seu lugar colourN ou colorN.)
• style O tamaño do texto usado no cladograma e etiquetas pode alterarse usando o parámetro style, por exemplo |style=font-size:85%. Non altere o tamaño da fonte nos modelos {{cladex}} ou {{clade}}! Se se fai, o cladograma e as etiquetas non se aliñarán correctamente, xa que serán de diferentes tamaños
• align Os cladogramas poden ser aliñados centralmente ao especificar |align=center ou |align=centre, ou á dereita ou esquerda ao especificar |align=right ou |align=left. Os dous últimos permiten que o texto flúa arredor dos laterais do cladograma, é dicir, está incrustado no texto.
• labelwidth Cando se usa |align=, débese especificar tamén o espazo permitido para as etiquetas usando labelwidth=number, doutro modo o espazo ocupado polas etiquetas será ignorado ao situalas no cladograma. Será necesario o método de ensaio e erro, pero xeralmente un bo punto de partida é aproximadamente o 60% do número de caracteres da etiqueta máis longa.

Limitacións, debugging

O modelo funciona construíndo unha táboa oculta. Os diferentes buscadores (axentes usuarios) teñen diferentes algoritmos para establecer o deseño das táboas, polo que o aliñamento preciso das etiquetas difire entre buscadores e plataformas, e non sempre é exactamente en fronte do nodo folla elixido. Aínda que é posible 'afinar' o aliñamento para unha combinación buscador/plataforma (por exemplo, usando posicións fraccionasrias distintas de 0.5), isto non funcionará noutras combinacións.

O modelo non comproba o rango dos parámetros subministrados, polo que hai que asegurarse que os valores dos parámetros atN son máis ou menos o mesmo que o valor dos parámetros size. A etiqueta N só se mostrará se se definen size, atN e labelN. A cor do texto da etiqueta (definida por barN, colorN ou colourN) por defecto é a negra.

Cómpre establecer o valor labelwidth sempre que o cladograma está aliñado ao centro, dereita ou esquerda. Isto inclúe situar {{barlabel}} dentro de {{cladograma}} e aliñalo á dereita por medio do modelo.

[ máis información | ver o historial | | | ver as instrucións ]

Este recadro non aparecerá no artigo.

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