forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
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

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 @@
 -->
 <html>
 <head>
-  <title>Test iHTML page</title>
+  <title>Interpreted HTML (ihtml) demonstration page</title>
 </head>
 <body>
 
-<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>
 
-<p>All linked-to pages, like <a href="../test2.html">this one</a>, are
-also available.</p>
+<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="http://forrest.apache.org/faq.html#link_raw">"raw content"</a>
+method, or by the normal processing of structured xml xdocs format, or by
+other specialised xml processing.
+</p>
+
+<p>
+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>
+
+<p>All linked-to pages are also available, for example
+<a href="../test2.html">this one</a>.</p>
+
+<p>
+You can still take advantage of Forrest's
+<a href="http://forrest.apache.org/docs/linking.html">"<b>site:<b>"
+method of linking</a>, for example:
+<a href="site:index">&lt;a href="site:index"&gt;</a>
+</p>
+
+<hr>
+<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.
+</p>
+<hr>
+
+<h1><a name="examples" />Some example uses of ihtml</h1>
+<p>
+There are situations when the Apache Forrest xdocs DTD is not sufficient.
+This interpreted html enables such extra capabilities.
+</p>
+
+<h2><a name="js" />Embedded applets and Javascript</h2>
+      
+<p>
+See the
+<a href="javascript:alert('Opened with Javascript via the body of the source html.')">Javascript
alert pop-up</a>
+</p>
+
+<h2><a name="forms" />HTML forms for user interaction</h2>
+<p>
+Search the Forrest website via Google:
+<!-- Search Google -->
+<form target="_blank" action="http://www.google.com/search" method="get">
+<input value="forrest.apache.org" name="as_sitesearch" type="hidden">
+<input type=hidden name=ie value=UTF-8>
+<input type=hidden name=oe value=UTF-8>
+<a href="http://www.google.com/">
+<img src="http://www.google.com/logos/Logo_40wht.gif" 
+border="0" alt="Google Search" align="middle" width="150" height="55"></a>
+<input type="text" name="as_q" size="25" maxlength="255" value="ihtml">
+&nbsp;
+<input type="submit" name="btnG" value="Google Search">
+</form>
+<!-- Search Google -->
+</p>
+
+<p>
+See a demonstration of "ihtml" and "html forms" with our 
+<a href="http://forrest.apache.org/mirrors.cgi">Forrest download mirror</a>
+facility and the
+<a href="http://forrest.apache.org/howto/howto-asf-mirror.html">explanation</a>
howto document.
+</p>
+
+<h2><a name="invalid" />Invalid HTML</h2>
+<p>
+This paragraph has a missing closing tag for the &lt;p&gt; element.
+
+<h2><a name="blink" />Other non-standard html-type abilities</h2>
+<p>
+Use other HTML <blink>delights and tricks</blink>.
+</p>
 </body>
 </html>

Mime
View raw message