در حال ویرایش الگو:Clade/doc/common (بخش)

==Controlling the layout of sisters==

When one sister is represented as a leaf node and the other as a labelled subclade, they do not appear to be at the same level. Consider this cladogram:
{{clade
|1={{clade
   |1=[[Banksia subser. Sphaerocarpae|''Banksia''&nbsp;subser.&nbsp;''Sphaerocarpae'']] (5 taxa)
   |label2=[[Banksia subser. Leptophyllae|''Banksia''&nbsp;subser.&nbsp;''Leptophyllae'']]
   |2={{clade
      |1=''[[Banksia telmatiaea]]''
      |2=(4 other taxa)
      }}
   }}
}}
Although ''Banksia''&nbsp;subser.&nbsp;''Sphaerocarpae'' and ''Banksia''&nbsp;subser.&nbsp;''Leptophyllae'' are sisters, their names are not aligned in the cladogram. If this is considered undesirable, one solution is to use a label in both cases, as shown below, which now shows the sisters at the same level.
{{clade
|1={{clade
   |label1=[[Banksia subser. Sphaerocarpae|''Banksia''&nbsp;subser.&nbsp;''Sphaerocarpae'']]
   |1=(5 taxa)
   |label2=[[Banksia subser. Leptophyllae|''Banksia''&nbsp;subser.&nbsp;''Leptophyllae'']]
   |2={{clade
      |1=''[[Banksia telmatiaea]]''
      |2=(4 other taxa)
      }}
   }}
}}
Another 'trick' is to introduce a dummy clade. The dotted line below shows where an extra clade has been inserted:
{{clade
|1={{clade
   |1=[[Banksia subser. Sphaerocarpae|''Banksia''&nbsp;subser.&nbsp;''Sphaerocarpae'']]
   |2={{clade
      |label1=[[Banksia subser. Leptophyllae|''Banksia''&nbsp;subser.&nbsp;''Leptophyllae'']]
      |state1=dotted
      |1={{clade
         |1=''[[Banksia telmatiaea]]''
         |2=(4 other taxa)
         }}
      }}
   }}
}}
To achieve this, instead of
<pre>{{clade
|1=Sister1
|label2=Sister2
|2={{clade
   ...
   }}
}}</pre>
use
<pre>{{clade
|1=Sister1
|2={{clade
   |label1=Sister2
   |2={{clade
       ...
      }}
   }}
}}</pre>
<!--   ===== FOR cladex ONLY:

-->{{#ifeq:{{{1|}}}|cladex|
==Bracketting nodes==
'''{{tlf|Cladex}} only.''' To insert a coloured 'bracket' around a set of leaf nodes which follow one another in the generated cladogram:
* Add <tt>barbeginN=''colour''</tt> for the first leaf node, where N is the order of that leaf node within its clade, and ''colour'' is the required colour.
* Add <tt>barN=''colour''</tt> for the remaining nodes other than the last (note that N must be the order of that node within its clade).
* Add <tt>barendN=''colour''</tt> for the last node.

Either the outermost clade must be specified by {{tlf|Clade}} or if {{tlf|Cladex}} is needed there, <tt>{{!}}style=width:auto</tt> must be present.

<pre>
<nowiki>
{{clade|style=font-size:85%;line-height:100%
|1={{cladex
   |1=Leaf A
   |2=Leaf B|barbegin2=green
   |3=Leaf C|bar3=green
   |4={{cladex
      |1=Leaf D|barend1=green
      |2=Leaf E
      |3=Leaf F|barbegin3=purple  
      |4={{cladex
         |1=Leaf G|bar1=purple
         |2=Leaf H|barend2=purple
         }}
      }}
   }}
}}
</nowiki>
</pre>

produces
{{clade|style=font-size:85%;line-height:100%
|1={{cladex
   |1=Leaf A
   |2=Leaf B|barbegin2=green
   |3=Leaf C|bar3=green
   |4={{cladex
      |1=Leaf D|barend1=green
      |2=Leaf E
      |3=Leaf F|barbegin3=purple  
      |4={{cladex
         |1=Leaf G|bar1=purple
         |2=Leaf H|barend2=purple
         }}
      }}
   }}
}}

The horizontal lines can be omitted by using <tt>{{!}}barN=''colour''</tt> throughout. Thus the following (note the use of <tt>{{!}}style=width:auto</tt> since the outermost clade uses the extra features of {{tlf|Cladex}}):

<pre>
<nowiki>
{{cladex|style=width:auto;font-size:85%;line-height:100%
|1=Leaf A
|2={{cladex
   |1=Leaf B|bar1=midnightblue
   |2=Leaf C|bar2=midnightblue
   }}
|3=Leaf D|bar3=midnightblue 
}}</nowiki>
</pre>

produces
{{cladex|style=width:auto;font-size:85%;line-height:100%
|1=Leaf A
|2={{cladex
   |1=Leaf B|bar1=midnightblue
   |2=Leaf C|bar2=midnightblue
   }}
|3=Leaf D|bar3=midnightblue 
}}

''Note that brackets or bars must only be applied to leaf nodes.'' In the example above, it may be tempting to write

<pre>
<nowiki>
{{cladex|style=width:auto;font-size:85%;line-height:100%
|1=Leaf A
|bar2=midnightblue
|2={{cladex
   |1=Leaf B
   |2=Leaf C
   }}
|3=Leaf D|bar3=midnightblue
}}</nowiki>
</pre>

with the expectation that the bar will be to the right of the whole of the clade containing Leaf B and Leaf C. This does not produce the required output.

===Specifying colours===

You can use any of the ways in which colours can be specified in HTML; e.g. the standard [http://www.w3schools.com/html/html_colornames.asp colour names], the three or six hex digit notations, such as #FC3 or #F3C630, or the <tt>rgb()</tt> notation.

===Supplying text labels===

Text labels for each bracket/bar can be added using {{tl|Barlabel}}. Accessibility guidelines require pages not to rely on colour alone, so it's particularly important to add labels if you have more than one bracket/bar and need to refer to them separately.

===Debugging===

If your cladogram doesn't display brackets/bars as you expected, check that:
* You understand the numbering system for the parameters <tt>barN<tt>, etc. The N must be the same as the number of the child within its clade. Thus typically you should write <tt>{{!}}N=''label for leaf''{{!}}barN=''colour for bar''</tt>, e.g. <tt>{{!}}2=<nowiki>[[Passeridae]]</nowiki>{{!}}bar2=midnightblue</tt>.
* You have only attempted to apply brackets/bars to ''leaf'' nodes.
* Either the outermost clade uses {{tlf|Clade}} or if it has to use {{tlf|Cladex}}, then <tt>{{!}}style=width:auto</tt> is present.
}}<!--
       ===== END OF FOR cladex ONLY-->