XHTML/Facelets Basics
For all of the XHTML files that can be specified through the branding process, they MUST start with:
<ui:composition xmlns:ui="http://java.sun.com/jsf/facelets">
and they MUST finish up with:
</ui:composition>
Within the composition, almost any XHTML can be specified.
Entities
The one exception to watch out for are entities such as non-breaking spaces. Including these directly will cause the rendering of the page to fail, and users will see a big mess in their browser. In other words will break rendering. Instead, the entity must be enclosed in a "verbatim" tag. Please note that another namespace is defined in the composition tag (in red below).
<ui:composition xmlns:ui="http://java.sun.com/jsf/facelets" xmlns:f="http://java.sun.com/jsf/core"> <f:verbatim>&nbsp;</f:verbatim> </ui:composition>
Quick Links XHTML
The Quick Links XHTML is imported into the scope of an XHTML table. Any XHTML specified here should be wrapped in a <tr> and at least one <td> element.
For an example see: https://ncisvn.nci.nih.gov/svn/nbia/trunk/docs/deployment/niams_branding/quickLinks.xhtml
Other XHTML
There are no restrictions on XHTML for the welcome title/text or the footer.