Ŝablono:Barlabel/dokumentado

Ĉi tiu ŝablono estas uzata por aldoni etikedojn al krampoj kaj strioj, kiuj estis aldonitaj al kladogramoj uzante {{kladoX}}.

Uzado

1. Unue kreu kladogramon uzante {{kladoX}} kaj {{klado}}, kiel disponeblas.
2. Tiam enigu la kladogramon en ĉi tiu ŝablono kiel la valoro de <kladogramo>.

Ekzemploj

Kondiĉe ke vi kreis la jenan kladogramon.

GM	A1 A2  A3  M C1  C2 G1   G2  G3

Por provizi etikedojn por la du grupoj identigitaj en la kladogramo:

• Nombru la foliajn nodojn en la kladogramo; ĉi tie estas 7. La parametro grando estos difinata al 7.
• Decidu kontraŭ kiuj foliaj nodoj vi volas irigi la etikedojn (angle labels). Por centrigi la etikedojn, la etikedo por la verda grupo estu kontraŭmeta al la folia nodo 3; la etikedo por la purpura grupo estu inter foliaj nodoj 5 kaj 6, t.e. kontraŭmeta al folia nodo "5.5". La at-parametroj de la ŝablono estas difinataj al ĉi tiuj valoroj.

La kompleta bezonata kodo estas la jena (eksklude la kodon por krei la kladogramon).

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

redonas

GM A1 A2  A3  M C1  C2 G1   G2  G3

Grupo 1 Grupo 2

Por redukti la tekstan grandon de la kladogramo kaj ĝiaj etikedoj, uzu la parametron style (aŭ stilo). Do

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

redonas

GM A1 A2  A3  M C1  C2 G1   G2  G3

Grupo 1 Grupo 2

La kladogramo povas esti lokata dekstre, kun la teksto flosanta ĉirkaŭ ĝi maldekstre, sed en ĉi tiu kazo vi devas difini la spacon permesatan por la etikedoj uzante la parametron labellarĝo, alie la etikedoj aperos ekstere je la dekstro de la paĝo. Provo kaj erarkorekto povus esti necesaj, sed ĉirkaŭ 60% de la nombro de signoj en la plej longa etikedo estas kutime bona startopunkto. Do

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

redonas la kladogramon dekstre malsupre.

GM A1 A2  A3  M C1  C2 G1   G2  G3

Grupo 1 Grupo 2

La kladogramo povas esti lokata centre sur la paĝo difinante |align=center aŭ |align=centre. La parametro labellarĝo estas necesa por certigi, ke la kladogramo estu centrigata; se ĝi estas forlasata, la etikedoj estos ignorataj en determinado de la lokigo. Do

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

redonas

GM A1 A2  A3  M C1  C2 G1   G2  G3

Grupo 1 Grupo 2

La kladogramo povas ankaŭ esti lokata maldekstre kun teksto flosanta ĉirkaŭ ĝi dekstre uzante |align=left. Denove la labellarĝo parametro estas necesa, alie la etikedoj kovrus sur la teksto.

Parametroj

• grando devas esti metata al la tuta nombro de foliaj nodoj en la kladogramo, ekz. |grando=23.

Ĝis ses etikedoj povas esti provizataj. Ili estas identifikataj per la cifero en la nomo de la parametro. Ĉiu etikedo bezonas tri parametrojn, ekz. at2, label2 kaj bar2 por la dua etikedo. Ne estas rilato inter ĉi tiuj numeroj kaj la numeroj uzataj por identifiki infanajn nodojn en {{klado}} aŭ {{kladoX}}. La "1" povas esti forlasata, t.e. at, label kaj bar estas ekvivalentoj al at1, label1 kaj bar1.

• atN difinas la pozicion de etikedo N rilate al la pozicio de la folia nodo en la tuta kladogramo, startante de 1 kaj finante ĉe la valoro de grando. La etikedo estas lokata kontraŭ la elektita folia nodo. Por etikedo inter du foliaj nodoj, uzu la averaĝon. Do por lokigi la unuan etikedon kontraŭ folia nodo 6, uzu |at1=6; por lokigi la trian etikedon kontraŭ punkto inter foliaj nodoj 6 kaj 7, uzu |at3=6.5.
• labelN difinas la tekston de etikedo N. Do por doni al la tria etikedo la tekston "Grupo 3", uzu |label3=Grupo 3.
• barN difinas la koloron de etikedo N. Do por aranĝi la duan etikedon en verda teksto, uzu |bar3=green. (La nomo bar estas konforma al {{kladoX}}; tamen koloroN povas esti uzataj anstataŭe.)
• style (aŭ stilo) La grando de la teksto uzata en la kladogramo kaj etikedoj povas esti ŝanĝata uzante la parametron style (aŭ stilo), ekz. |style=font-size:85%. Ne ŝanĝu la skriban grandon en la ŝablonoj {{kladoX}} aŭ {{klado}}! Se vi faras tion, la kladogramo kaj la etikedoj ne estos lokataj ĝuste ĉar ili estus de malsamaj grandoj.
• align La kladogramo povas esti lokata centre difinante |align=center aŭ |align=centre, aŭ esti dekstre aŭ maldekstre difinante |align=right aŭ |align=left. La lastaj du ebligas al teksto flosi je la flanko de la kladogramo, t.e. ĝi estas enigata en la tekston.
• labellarĝo Ĉe uzado de |align=, vi devas ankaŭ difini la spacon permesatan al la etikedoj uzante labellarĝo=numero, alie la spaco okupata de la etikedoj estos ignorata dum la lokigo de la kladogramo. Provo kaj erarkorkto povus esti necesaj, sed ĉirkaŭ 60% de la nombro de signoj en la plej longa etikedo estas kutime bona startopunkto.

Limigoj, senerarigo

La ŝablono funkcias konstruante kaŝan tabelon. Malsamaj foliumiloj (ttt-legiloj) havas malsamajn algoritmojn por aranĝi tabelojn, tiel ke la preciza lokigo de la etikedoj varias inter foliumiloj kaj platformoj, kaj ne ĉiam estas ekzakte kontraŭata al la elektita folia nodo. Kvankam eblas ektordi (angle 'tweak') la lokigon por unu kombino el foliumilo kaj platformo (ekz. uzante frakciajn poziciojn aliajn ol 0.5), tio ne funkcias ĉe aliaj kombinoj.

La ŝablono ne kontrolas la rangojn de la transdonataj parametroj, tiel certigu ke la valoroj de atN parametroj estas malpli aŭ egalaj al la valoro de la parametro grando. Etikedo N estas nur montrata se grando, atN kaj labelN estas difinataj. La koloro de la teksto de la etikedo (difinata per barN aŭ koloroN) defaŭlte estas nigra.

Metado de labellarĝo estas necesa kiam ajn la kladogramo estas lokigata centre, dekstre aŭ maldekstre.