wamblee.org Git - utils/blob

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   2  "http://www.w3.org/TR/html4/loose.dtd">
   3 <!--
   4   Copyright 2002-2004 The Apache Software Foundation or its licensors,
   5   as applicable.
   6
   7   Licensed under the Apache License, Version 2.0 (the "License");
   8   you may not use this file except in compliance with the License.
   9   You may obtain a copy of the License at
  10
  11       http://www.apache.org/licenses/LICENSE-2.0
  12
  13   Unless required by applicable law or agreed to in writing, software
  14   distributed under the License is distributed on an "AS IS" BASIS,
  15   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16   See the License for the specific language governing permissions and
  17   limitations under the License.
  18 -->
  19 <html>
  20 <head>
  21   <title>Embedded HTML demonstration page</title>
  22 </head>
  23 <body>
  24
  25 <h1><a name="intro" />Embedded HTML demonstration page</h1>
  26
  27 <p>An HTML document is used as the source for this page, and translated
  28 to the intermediate Apache Forrest xdocs document structure. The sitemap then
  29 does the normal aggregation with the navigation content and application of
  30 the skin.
  31 </p>
  32
  33 <p>
  34 The html is being interpreted by Forrest and transformed to the
  35 intermediate Apache xdocs document structure. That stylesheet cannot deal
  36 with every possibility in unstructured html, so it tries to guess how to
  37 build &lt;section&gt; elements and such.
  38 It needs &lt;h1&gt; (&lt;h2&gt; etc.) headings in the source html
  39 in order to identify sections. Patches are welcome to enhance
  40 that transformer.
  41 </p>
  42
  43 <p>
  44 You can still take advantage of Forrest's
  45 <a href="http://forrest.apache.org/docs/linking.html">"<b>site:<b>"
  46 method of linking</a>, for example:
  47 <a href="site:index">&lt;a href="site:index"&gt;</a>
  48 </p>
  49
  50 <hr>
  51 <note>XHTML can also be used, but it is just treated as interpreted
  52 html. Future versions of Forrest will take much more advantage of XHTML.
  53 </note>
  54 <hr>
  55
  56 <h1><a name="examples" />Some example uses of HTML</h1>
  57 <p>
  58 There are situations when the Apache Forrest xdocs DTD is not sufficient.
  59 The use of embedded HTML enables you to use HTML code in these situations.
  60 </p>
  61
  62 <h2><a name="js" />Embedded applets and Javascript</h2>
  63
  64 <p>
  65 See the
  66 <a href="javascript:alert('Opened with Javascript via the body of the source html.')">Javascript alert pop-up</a>
  67 </p>
  68
  69 <h2><a name="forms" />HTML forms for user interaction</h2>
  70 <p>
  71 Search the Forrest website via Google:
  72 <!-- Search Google -->
  73 <form target="_blank" action="http://www.google.com/search" method="get">
  74 <input value="forrest.apache.org" name="as_sitesearch" type="hidden">
  75 <input type=hidden name=ie value=UTF-8>
  76 <input type=hidden name=oe value=UTF-8>
  77 <a href="http://www.google.com/">
  78 <img src="http://www.google.com/logos/Logo_40wht.gif"
  79 border="0" alt="Google Search" align="middle" width="150" height="55"></a>
  80 <input type="text" name="as_q" size="25" maxlength="255" value="HTML">
  81 &nbsp;
  82 <input type="submit" name="btnG" value="Google Search">
  83 </form>
  84 <!-- Search Google -->
  85 </p>
  86
  87 <p>
  88 See a demonstration of "html" and "html forms" with our
  89 <a href="http://forrest.apache.org/mirrors.cgi">Forrest download mirror</a>
  90 facility and the
  91 <a href="http://forrest.apache.org/howto/howto-asf-mirror.html">explanation</a> howto document.
  92 </p>
  93
  94 <h2><a name="invalid" />Invalid HTML</h2>
  95 <p>
  96 This paragraph has a missing closing tag for the &lt;p&gt; element. If you look
  97 at the <a href="embedded_html.xml">XML created by Forrest</a> you'll notice that
  98 Forrest has fixed this.
  99
 100 <h2>Potentially Invalid XDocs</h2>
 101
 102 <warning>However, it should also be noted that the resultant XML is not a valid document
 103 since it contains the additional HTML elements. If you are intending to use
 104 the intermediate XDocs for any purpose be aware of this fact.</warning>
 105
 106 <h2><a name="blink" />Other non-standard html-type abilities</h2>
 107 <p>
 108 Use other HTML <blink>delights (???) and tricks</blink>.
 109 </p>
 110 </body>
 111 </html>