An HTML document is used as the source for this page, and translated to the intermediate Apache Forrest xdocs document structure. The sitemap then does the normal aggregation with the navigation content and application of the skin.
The html is being interpreted by Forrest and transformed to the intermediate Apache xdocs document structure. That stylesheet cannot deal with every possibility in unstructured html, so it tries to guess how to build <section> elements and such. It needs <h1> (<h2> etc.) headings in the source html in order to identify sections. Patches are welcome to enhance that transformer.
You can still take advantage of Forrest's "site:" method of linking, for example: <a href="site:index">
XHTML can also be used, but it is just treated as interpreted html. Future versions of Forrest will take much more advantage of XHTML.
There are situations when the Apache Forrest xdocs DTD is not sufficient. The use of embedded HTML enables you to use HTML code in these situations.
See the Javascript alert pop-up
Search the Forrest website via Google:
See a demonstration of "html" and "html forms" with our Forrest download mirror facility and the explanation howto document.
As shown above, you can add various different non-standard elements to enable other processing and abilities. However, it should also be noted that the resultant intermediate XML is not a valid document since it contains the additional HTML elements. If you are intending to use the intermediate XDocs for any purpose, then be aware of this fact.
This paragraph has a missing closing tag for the <p> element. If you look at the intermediate XML created by Forrest you'll notice that Forrest has fixed this.
Use other HTML .