Selecting the current tab

The tab selection algorithm is quite simple: the tab with the - "id" which matches that of the current

site.x=
ml

- node is "selected". If you experience any problems, try to add a=20 - <foo label=3D"Foo" href=3D"index.html"/> to t= he - site.xml configuration. + "id" which matches that of the current &s; + node is "selected". However the interaction of &t; and &s; + while powerful, can be complex to establish.

+ Configuring the interaction between tabs.xml and site.xml</= title> + <p> + This is a collection of tips to assist with getting your menus a= nd tabs + to properly display. + </p> + <ul> + <li> + View your site's=20 + <link href=3D"../abs-menulinks">abs-menulinks</link> pipeline = in a + browser. This is part of the internal Cocoon machinery, but li= ke + other sitemap resources, it is useful to view them to assist w= ith + debugging. + </li> + <li> + The Forrest website also accompanies your software release + in the <code>site-author</code> directory, so + inspect its &t; and &s; to see how it is done. Also see the + 'forrest seed site' example. It is not as complex as the Forre= st website. + </li> + <li> + When you are fiddling with your attributes, change one thing a= t a time + and document what you have changed.</li> + <li> + The value of the tab @id attribute cannot begin with a digit. + Likewise, element names in &t; and &s; cannot begin with a dig= it. + </li> + <li> + Add label attributes to &s; elements to make the menus show. + With nested elements in &s; if the outer element does not have= a label + attribute then the inner elements will not be displayed. + </li> + <li> + To cause tabs and menu items to be highlighted, there need to = be + corresponding elements in &s; that have href attributes which = match + the relevant path. + </li> + <li> + When the tab points to a directory, then to make the tab highl= ighted + when selected, you need an element which matches index.html wi= thin the + group of elements that define the menus for this tab in the &s; + file. That element can be without a label attribute, so that i= t doesn't + display as a menu item. However doing that causes that tab's m= enus + to be collapsed. + </li> + </ul> </section> =20 </section>