forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: rev 36056 - forrest/trunk/src/core/fresh-site/src/documentation/content/xdocs/samples
Date Sat, 07 Aug 2004 07:54:55 GMT
Author: crossley
Date: Sat Aug  7 00:54:55 2004
New Revision: 36056

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
+++ 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 @@
-  <title>Test iHTML page</title>
+  <title>Interpreted HTML (ihtml) demonstration page</title>
-<h1>Test iHTML page</h1>
+<h1><a name="intro" />Interpreted HTML (ihtml) demonstration page</h1>
-<p>This plain HTML document is used as the source for this page, and translated
+<p>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.
-<p>All linked-to pages, like <a href="../test2.html">this one</a>, are
-also available.</p>
+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
+<a href="">"raw content"</a>
+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 &lt;section&gt; elements and such.
+It needs &lt;h1&gt; (&lt;h2&gt; etc.) headings in the source ihtml
+(and the page must start with a h1 element). Patches are welcome to enhance
+that transformer.
+<p>All linked-to pages are also available, for example
+<a href="../test2.html">this one</a>.</p>
+You can still take advantage of Forrest's
+<a href="">"<b>site:<b>"
+method of linking</a>, for example:
+<a href="site:index">&lt;a href="site:index"&gt;</a>
+<p><b>Note:</b> XHTML can also be used, but it is just treated as interpreted
+html. Future versions of Forrest will take much more advantage of XHTML.
+<h1><a name="examples" />Some example uses of ihtml</h1>
+There are situations when the Apache Forrest xdocs DTD is not sufficient.
+This interpreted html enables such extra capabilities.
+<h2><a name="js" />Embedded applets and Javascript</h2>
+See the
+<a href="javascript:alert('Opened with Javascript via the body of the source html.')">Javascript
alert pop-up</a>
+<h2><a name="forms" />HTML forms for user interaction</h2>
+Search the Forrest website via Google:
+<!-- Search Google -->
+<form target="_blank" action="" method="get">
+<input value="" name="as_sitesearch" type="hidden">
+<input type=hidden name=ie value=UTF-8>
+<input type=hidden name=oe value=UTF-8>
+<a href="">
+<img src="" 
+border="0" alt="Google Search" align="middle" width="150" height="55"></a>
+<input type="text" name="as_q" size="25" maxlength="255" value="ihtml">
+<input type="submit" name="btnG" value="Google Search">
+<!-- Search Google -->
+See a demonstration of "ihtml" and "html forms" with our 
+<a href="">Forrest download mirror</a>
+facility and the
+<a href="">explanation</a>
howto document.
+<h2><a name="invalid" />Invalid HTML</h2>
+This paragraph has a missing closing tag for the &lt;p&gt; element.
+<h2><a name="blink" />Other non-standard html-type abilities</h2>
+Use other HTML <blink>delights and tricks</blink>.

View raw message