# Embedded HTML demonstration page

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.

# Some example uses of HTML

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.

## Embedded applets and Javascript

See the Javascript alert pop-up

## HTML forms for user interaction

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.

## Invalid HTML

This paragraph has a missing closing tag for the <p> element. If you look at the XML created by Forrest you'll notice that Forrest has fixed this.

## Potentially Invalid XDocs

However, it should also be noted that the resultant 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 be aware of this fact.

## Other non-standard html-type abilities

Use other HTML delights (???) and tricks.