non-releases/trunk_before_flattening/src/documentation/src/content/xdocs/getting-started/content_en.html - cocoon - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  "http://www.w3.org/TR/html4/loose.dtd">
 <!--
   Copyright 2002-2004 The Apache Software Foundation

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
 -->
 <html>
 <head>
   <title>Interpreted HTML (ihtml) demonstration page</title>
 </head>
 <body>

 <h1><a name="intro" />Interpreted HTML (ihtml) demonstration page</h1>

 <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
 does the normal aggregation with the navigation content and application of
 the skin.
 </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>
 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>
	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
	"http://www.w3.org/TR/html4/loose.dtd">
	<!--
	Copyright 2002-2004 The Apache Software Foundation

	Licensed under the Apache License, Version 2.0 (the "License");
	you may not use this file except in compliance with the License.
	You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
	-->
	<html>
	<head>
	<title>Interpreted HTML (ihtml) demonstration page</title>
	</head>
	<body>

	<h1><a name="intro" />Interpreted HTML (ihtml) demonstration page</h1>

	<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
	does the normal aggregation with the navigation content and application of
	the skin.
	</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 <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.
	</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"><a href="site:index"></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">

	<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 <p> element.

	<h2><a name="blink" />Other non-standard html-type abilities</h2>
	<p>
	Use other HTML <blink>delights and tricks</blink>.
	</p>
	</body>
	</html>