Author: crossley Date: Sat Aug 7 00:54:55 2004 New Revision: 36056 Modified: forrest/trunk/src/core/fresh-site/src/documentation/content/xdocs/samples/ihtml-sample.ihtml Log: More complete ihtml demo and explanation. Modified: forrest/trunk/src/core/fresh-site/src/documentation/content/xdocs/samples/ihtml-sample.ihtml ============================================================================== --- forrest/trunk/src/core/fresh-site/src/documentation/content/xdocs/samples/ihtml-sample.ihtml (original) +++ forrest/trunk/src/core/fresh-site/src/documentation/content/xdocs/samples/ihtml-sample.ihtml Sat Aug 7 00:54:55 2004 @@ -17,18 +17,98 @@ --> - Test iHTML page + Interpreted HTML (ihtml) demonstration page -

Test iHTML page

+

Interpreted HTML (ihtml) demonstration page

-

This plain HTML document is used as the source for this page, and translated +

This HTML document is used as the source for this page, and translated to the intermediate Apache Forrest xdocs document structure. The sitemap then -aggregates it with the navigation content and applies the skin. +does the normal aggregation with the navigation content and application of +the skin.

-

All linked-to pages, like this one, are -also available.

+

+Note that this source file has the .ihtml filename extension. All requests to +the sitemap for *.html are served by looking for matching *.ihtml source, +or by the +"raw content" +method, or by the normal processing of structured xml xdocs format, or by +other specialised xml processing. +

+ +

+The ihtml 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 ihtml +(and the page must start with a h1 element). Patches are welcome to enhance +that transformer. +

+ +

All linked-to pages are also available, for example +this one.

+ +

+You can still take advantage of Forrest's +"site:" +method of linking, for example: +<a href="site:index"> +

+ +
+

Note: 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 ihtml

+

+There are situations when the Apache Forrest xdocs DTD is not sufficient. +This interpreted html enables such extra capabilities. +

+ +

Embedded applets and Javascript

+ +

+See the +Javascript alert pop-up +

+ +

HTML forms for user interaction

+

+Search the Forrest website via Google: + +

+ + + + +Google Search + +  + +
+ +

+ +

+See a demonstration of "ihtml" 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. + +

Other non-standard html-type abilities

+

+Use other HTML delights and tricks. +