forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r160902 [9/28] - in forrest/site/0.6: ./ docs/ docs/images/ dtd/ entity/ howto/ images/ skin/ skin/css/ skin/images/ skin/scripts/ skins/
Date Mon, 11 Apr 2005 15:12:19 GMT
Propchange: forrest/site/0.6/docs/document-v20.dtdx.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/0.6/docs/document-v20.dtdx.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v20.dtdx.pdf?view=auto&rev=160902
==============================================================================
Binary file - no diff available.

Propchange: forrest/site/0.6/docs/document-v20.dtdx.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Added: forrest/site/0.6/docs/document-v20.html
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v20.html?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/document-v20.html (added)
+++ forrest/site/0.6/docs/document-v20.html Mon Apr 11 08:11:56 2005
@@ -0,0 +1,833 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<meta-data></meta-data>
+<title>The Apache Forrest xdocs document-v2.0 DTD (v0.6)</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://forrest.apache.org/">forrest</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="../images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="base-not-selected" href="../contrib.html">Project</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../docs/index.html">O.6 Docs</a>
+</li>
+<li>
+<a class="base-not-selected" href="../howto/index.html">0.6 How-To</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs">
+<a class="base-selected" href="../docs/your-project.html">Core</a> | <a class="base-selected" href="../docs/forrestbot.html">ForrestBot</a> | <a class="base-selected" href="../docs/forrestbar.html">ForrestBar</a>
+</div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Documentation</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/your-project.html">Using Forrest</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/validation.html">XML Validation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/searching.html">Searching</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/skins.html">Default Skins</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/skin-package.html">Skin Packages</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrest-contract.html">Our Contract</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/compliance.html">Standards Compliance</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.10', '../skin/')" id="menu_1.1.10Title" class="menutitle">Advanced Topics</div>
+<div id="menu_1.1.10" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/catalog.html">Using DTD Catalogs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/cap.html">Sourcetype Action</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.11', '../skin/')" id="menu_1.1.11Title" class="menutitle">Upgrading</div>
+<div id="menu_1.1.11" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/upgrading_06.html">Upgrading to 0.6</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/upgrading_05.html">Upgrading to 0.5</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">SubProjects</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/forrestbar.html">ForrestBar</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrestbot.html">Forrestbot</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrestbot-web-interface.html">Forrestbot Webapp</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Reference docs</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div onclick="SwitchMenu('menu_1.3.1', '../skin/')" id="menu_1.3.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.3.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3.2', '../skin/')" id="menu_selected_1.3.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Doc samples</div>
+<div id="menu_selected_1.3.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../docs/document-v13.html">document-v13</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">document-v20</div>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', '../skin/')" id="menu_1.4Title" class="menutitle">Older Docs</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/dreams.html">Dream list</a>
+</div>
+</div>
+<div id="credit">
+<hr>
+    This is documentation for past release v0.6
+   (<a href="http://forrest.apache.org/docs.html">More</a> ...)</div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="document-v20.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<div class="trail">
+	        Font size: 
+	          &nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">      
+	          &nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>The Apache Forrest xdocs document-v2.0 DTD</h1>
+<div class="abstract">This is a demonstration document using all possible elements in
+      the current Apache Forrest xdocs document-v20.dtd
+    </div>
+<div id="motd-area">
+    This is documentation for past release v0.6
+   (<a href="http://forrest.apache.org/docs.html">More</a> ...)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#sample">Sample Content</a>
+<ul class="minitoc">
+<li>
+<a href="#block-inline">Block and inline elements</a>
+</li>
+<li>
+<a href="#presentations">Various presentation formats</a>
+</li>
+<li>
+<a href="#section">Using sections</a>
+</li>
+<li>
+<a href="#sub-section">Sections, the sequel</a>
+<ul class="minitoc">
+<li>
+<a href="#sub-sub-section">Section 2.1</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#source">Showing preformatted source code</a>
+</li>
+<li>
+<a href="#table">Using tables</a>
+</li>
+<li>
+<a href="#figure">Using figures</a>
+</li>
+<li>
+<a href="#link-class">Using class attribute on links</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#changes">DTD changes</a>
+<ul class="minitoc">
+<li>
+<a href="#changes-20">Changes between document-v13 and document-v20</a>
+</li>
+<li>
+<a href="#changes-13">Changes between document-v12 and document-v13</a>
+</li>
+<li>
+<a href="#changes-12">Changes between document-v11 and document-v12</a>
+</li>
+</ul>
+</li>
+</ul>
+</div> 
+    
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+      This is a demonstration document using all possible elements in the
+      current Apache Forrest xdocs <span class="codefrag">document-v20.dtd</span>
+      (See the <a href="#changes">DTD changes</a> section at the bottom.)
+    </div>
+</div>
+    
+<a name="N10020"></a><a name="sample"></a>
+<h2 class="underlined_10">Sample Content</h2>
+<div class="section">
+<p>
+<strong>Hint:</strong> See the xml source to see how the various
+      elements are used and see the
+<!-- FOR-321 workaround
+      <a href="site:dtd-docs">DTD reference documentation</a>.
+-->
+      <a href="dtd-docs.html">DTD documentation</a>.
+      </p>
+<a name="N10031"></a><a name="block-inline"></a>
+<h3 class="underlined_5">Block and inline elements</h3>
+<p>This is a simple paragraph. Most documents contain a fair amount of
+        paragraphs. Paragraphs are called <span class="codefrag">&lt;p&gt;</span>.</p>
+<div class="pre">With the <span class="codefrag">&lt;p xml:space="preserve"&gt;</span> attribute, you can declare
+        that whitespace should    be   preserved, without implying it is in any other
+        way special.</div>
+<p>
+        This next paragraph has a class attribute of 'quote'.  CSS can
+        be used to present this <span class="codefrag">&lt;p class='quote'&gt;</span> in
+        a different style than the other paragraphs.  The handling of
+        this quoted paragraph is defined in the &lt;extra-css&gt;
+        element in the skinconf.xml.
+      </p>
+<p class="quote">
+        Anyway, like I was sayin', shrimp is the fruit of the sea. You can
+        barbecue it, boil it, broil it, bake it, sautee it. Dey's uh,
+        shrimp-kabobs, shrimp creole, shrimp gumbo. Pan fried, deep fried,
+        stir-fried. There's pineapple shrimp, lemon shrimp, coconut shrimp,
+        pepper shrimp, shrimp soup, shrimp stew, shrimp salad, shrimp and
+        potatoes, shrimp burger, shrimp sandwich. That- that's about it.
+      </p>
+<p>A number of in-line elements are available in the DTD, we will show them
+        inside an unordered list (<span class="codefrag">&lt;ul&gt;</span>):</p>
+<ul> 
+        
+<li>Here is a simple list item (<span class="codefrag">&lt;li&gt;</span>).</li> 
+        
+<li>Have you seen the use of the <span class="codefrag">&lt;code&gt;</span> element in the
+          previous item?</li> 
+        
+<li>Also, we have <span class="codefrag">&lt;sub&gt;</span> and <span class="codefrag">&lt;sup&gt;</span>
+          elements to show content <sup>above</sup> or <sub>below</sub> the text
+          baseline.</li> 
+        
+<li>There is a facility to <em>emphasize</em> certain words using the
+          <span class="codefrag">&lt;em&gt;</span> <strong><span class="codefrag">&lt;strong&gt;</span></strong>
+          elements.</li> 
+        
+<li>We can use
+          <img class="icon" alt="feather" height="22" src="images/icon.png" width="26">
+          <span class="codefrag">&lt;icon&gt;</span>s too.</li> 
+        
+<li>Another possibility is the <span class="codefrag">&lt;img&gt;</span> element:
+          <img alt="another feather" height="22" src="images/icon.png" width="26">,
+          which offers the ability to refer to an image map.</li> 
+        
+<li>We have elements for hyperlinking: 
+          <dl> 
+            
+<dt>
+<span class="codefrag">&lt;a href="../faq.html"&gt;</span>
+</dt> 
+            
+<dd>Use this to
+              <a href="../faq.html" title="Example of a document via link">link</a>
+              to another document. As per normal, this will open the new document
+              in the same browser window.</dd> 
+
+            
+<dt>
+<span class="codefrag">&lt;a href="#section"&gt;</span>
+</dt> 
+            
+<dd>Use this to
+              <a href="#section" title="Example of a document via local anchor">link</a>
+              to the named anchor in the current document.
+            </dd> 
+
+            
+<dt>
+<span class="codefrag">&lt;a href="../faq.html#overview"&gt;</span>
+</dt> 
+            
+<dd>Use this to
+              <a href="../faq.html#overview" title="Example of a document via link and anchor">link</a>
+              to another document and go to the named anchor. This will open
+              the new document in the same browser window.
+            </dd> 
+            
+<dt>Targetted window control with jump and fork.</dt> 
+            
+<dd>See demonstration
+             <a href="#link-class">using class attribute on links</a>.
+            </dd> 
+        
+</dl>
+</li> 
+
+        
+<li>Oh, by the way, a definition list <span class="codefrag">&lt;dl&gt;</span> was used inside
+          the previous list item. We could put another 
+          <ul> 
+            
+<li>unordered list</li> 
+            
+<li>inside the list item</li> 
+          
+</ul>
+          
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+            
+<caption>A sample nested table</caption>
+            
+<tr>
+<td colspan="1" rowspan="1">Or even tables.. </td><td colspan="1" rowspan="1">
+                
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<td colspan="1" rowspan="1">inside tables..</td>
+</tr>
+</table>
+            
+</td>
+</tr>
+            
+<tr>
+<td colspan="1" rowspan="1">or inside lists, but I believe this liberty gets quickly quite
+                hairy as you see.</td>
+</tr>
+          
+</table>
+        
+</li>
+      
+</ul>
+<p>So far for the in-line elements, let's look at some paragraph-level
+        elements.</p>
+<div class="frame fixme">
+<div class="label">Fixme (SN)</div>
+<div class="content">The <span class="codefrag">&lt;fixme&gt;</span> element is used for stuff
+        which still needs work. Mind the <span class="codefrag">author</span> attribute!</div>
+</div>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Use the <span class="codefrag">&lt;note&gt;</span> element to draw attention to something, e.g. ...The <span class="codefrag">&lt;code&gt;</span> element is used when the author can't
+        express himself clearly using normal sentences ;-)</div>
+</div>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Sleep deprivation can be the result of being involved in an open
+        source project. (a.k.a. the <span class="codefrag">&lt;warning&gt;</span> element).
+      </div>
+</div>
+<div class="frame note">
+<div class="label">Important</div>
+<div class="content">If you want your own labels for notes and
+        warnings, specify them using the <span class="codefrag">label</span> attribute.
+      </div>
+</div>
+<p>Apart from unordered lists, we have ordered lists too, of course.</p>
+<ol> 
+        
+<li>Item 1</li> 
+        
+<li>Item 2</li> 
+        
+<li>This should be 3 if my math is still OK.</li> 
+      
+</ol>
+<a name="N10129"></a><a name="presentations"></a>
+<h3 class="underlined_5">Various presentation formats</h3>
+<p>This sample document, written in document-v20 XML can be presented
+        via Forrest in a number of different formats. The links in the
+        following list show this document in each of the currently available
+        formats.</p>
+<p>Each of the formats can be made available as a link near the top of
+        the page. Actual placement of those links depends on the skin
+        currently in use. Those links are enabled in the skinconf.xml via the
+        &lt;disable-XXX-link&gt; elements in the skinconf.xml</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+          
+<tr>
+            
+<th colspan="1" rowspan="1">Presentation Format</th>
+
+            <th colspan="1" rowspan="1">Description</th>
+
+            <th colspan="1" rowspan="1">skinconf.xml Element</th>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1"><a href="document-v20.html">HTML</a></td>
+
+            <td colspan="1" rowspan="1">This document in HTML format. </td>
+
+            <td colspan="1" rowspan="1">Always generated by default. Cannot be turned off.</td>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1"><a href="document-v20.xml">XML</a></td>
+
+            <td colspan="1" rowspan="1">This document in its raw XML format.</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-xml-link&gt;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1"><a href="document-v20.pdf">PDF</a></td>
+
+            <td colspan="1" rowspan="1">This document as Adobe PDF</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-pdf-link&gt;. By default, set to false, meaning
+            that this link will be shown.</td>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1">Text</td>
+
+            <td colspan="1" rowspan="1">This document as straight text.</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-txt-link&gt;. By default, set to true, meaning
+            that this link will not be shown. NOT YET IMPLEMENTED.</td>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1"><a href="document-v20.pod">POD</a></td>
+
+            <td colspan="1" rowspan="1">This document as Perl POD (Plain Old Documentation). Text with
+            minimal formatting directives. If on a *nix system with perl
+            installed, see "man perlpod".</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-pod-link&gt;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          
+</tr>
+        
+</table>
+<a name="N101AD"></a><a name="section"></a>
+<h3 class="underlined_5">Using sections</h3>
+<p>You can use sections to put some structure in your document. For some
+          strange historical reason, the section title is an attribute of the
+          <span class="codefrag">&lt;section&gt;</span> element.</p>
+<a name="N101BA"></a><a name="sub-section"></a>
+<h3 class="underlined_5">Sections, the sequel</h3>
+<p>Just some second section.</p>
+<a name="N101C3"></a><a name="sub-sub-section"></a>
+<h4>Section 2.1</h4>
+<p>Which contains a subsection (2.1).</p>
+<a name="N101CE"></a><a name="source"></a>
+<h3 class="underlined_5">Showing preformatted source code</h3>
+<p>Enough about these sections. Let's have a look at more interesting
+          elements, <span class="codefrag">&lt;source&gt;</span> for instance:</p>
+<pre class="code">
+// This example is from the book _Java in a Nutshell_ by David Flanagan.
+// Written by David Flanagan.  Copyright (c) 1996 O'Reilly &amp; Associates.
+// You may study, use, modify, and distribute this example for any purpose.
+// This example is provided WITHOUT WARRANTY either expressed or implied.
+
+import java.applet.*;    // Don't forget these import statements!
+import java.awt.*;
+
+public class FirstApplet extends Applet {
+    // This method displays the applet.
+    // The Graphics class is how you do all drawing in Java.
+    public void paint(Graphics g) {
+        g.drawString("Hello World", 25, 50);
+    }
+}</pre>
+<p>CDATA sections are used within 
+          <span class="codefrag">&lt;source&gt;</span> elements so that you can write pointy
+           brackets without needing to escape them with messy
+          <span class="codefrag">&amp;lt;</span> entities ...
+        </p>
+<pre class="code">
+&lt;pointy&gt;
+  easy
+&lt;/pointy&gt;
+</pre>
+<p>Please take care to still use a sensible line-length within your
+          source elements.</p>
+<a name="N101EF"></a><a name="table"></a>
+<h3 class="underlined_5">Using tables</h3>
+<p>And now for a table:</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+          
+<caption>Table caption</caption>
+          
+<tr>
+            
+<th colspan="1" rowspan="1">heading cell 1</th>
+            <th colspan="1" rowspan="1">heading cell 2</th>
+            <th colspan="1" rowspan="1">heading cell 3</th>
+          
+</tr>
+          
+<tr>
+            
+<td colspan="1" rowspan="1">data cell</td>
+            <td colspan="2" rowspan="1">this data cell spans two columns</td>
+          
+</tr>
+          
+<tr>
+            
+<td colspan="1" rowspan="1">
+              Tables can be nested:
+            </td>
+            <td colspan="1" rowspan="1">
+              
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+                
+<tr>
+                  
+<th colspan="1" rowspan="1">column 1</th>
+                  <th colspan="1" rowspan="1">column 2</th>
+                
+</tr> 
+                
+<tr>
+                  
+<td colspan="1" rowspan="1">cell A</td>
+                  <td colspan="1" rowspan="1">cell B</td>
+                
+</tr>
+              
+</table>
+            
+</td>
+            <td colspan="1" rowspan="1">
+              
+<ul>
+<li>and can include most other elements</li>
+<li>such as lists</li>
+</ul>
+            
+</td>
+          
+</tr>
+        
+</table>
+<a name="second-figure-anchor"></a><a name="N10256"></a><a name="figure"></a>
+<h3 class="underlined_5">Using figures</h3>
+<p>And a <span class="codefrag">&lt;figure&gt;</span> to end all of this.
+          Note that this can also be implemented with an
+          <span class="codefrag">&lt;img&gt;</span> element.
+        </p>
+<div style="text-align: center;">
+<img class="figure" alt="The fine Forrest logo" src="images/project-logo.png" height="65" width="220"></div>
+<a name="N1026C"></a><a name="link-class"></a>
+<h3 class="underlined_5">Using class attribute on links</h3>
+<p>The document-v13 had elements &lt;fork&gt; and &lt;jump&gt;. In
+        document-v20, those elements no longer exist but the functionality can
+        be duplicated by using the @class attribute.
+        Even though the opening of separate windows should be under the
+        control of the user, these techniques can still be employed.</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+          
+<tr>
+            
+<th colspan="1" rowspan="1">
+<p>Document V1.3</p>
+</th>
+
+            <th colspan="1" rowspan="1">
+<p>Document V2.0</p>
+</th>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1">
+<p>&lt;fork href="../faq.html"&gt;</p>
+</td>
+
+            <td colspan="1" rowspan="1"><a target="_blank" class="fork" href="../faq.html">&lt;a class="fork"
+            href="../faq.html"&gt;</a></td>
+          
+</tr>
+
+          
+<tr>
+            
+<td colspan="1" rowspan="1">
+<p>&lt;jump href="../faq.html"&gt;</p>
+</td>
+
+            <td colspan="1" rowspan="1">
+<p>
+<a target="_top" class="jump" href="../faq.html">&lt;a class="jump"
+            href="../faq.html"&gt;</a>
+</p>
+</td>
+          
+</tr>
+        
+</table>
+</div>
+
+    
+<a name="N102AC"></a><a name="changes"></a>
+<h2 class="underlined_10">DTD changes</h2>
+<div class="section">
+<p>See the generated
+<!-- FOR-321 workaround
+        <a href="site:dtd-docs">DTD reference documentation</a>.
+-->
+        <a href="dtd-docs.html">DTD documentation</a>.
+      </p>
+<a name="N102BB"></a><a name="changes-20"></a>
+<h3 class="underlined_5">Changes between document-v13 and document-v20</h3>
+<ul>
+          
+<li>Renamed <strong>&lt;link&gt;</strong>
+             to <strong>&lt;a&gt;</strong>
+          
+</li>
+          
+<li>Removed <strong>&lt;fork&gt;</strong>
+             and <strong>&lt;jump&gt;</strong> in favour of the
+             <strong>&lt;a&gt;</strong> element. See demonstration
+             <a href="#link-class">using class attribute on links</a>.
+          </li>
+        
+</ul>
+<a name="N102DE"></a><a name="changes-13"></a>
+<h3 class="underlined_5">Changes between document-v12 and document-v13</h3>
+<p>
+          All v1.2 docs will work fine as v1.3 DTD. The main change is the
+          addition of a @class attribute to every element, which enables the
+          "extra-css" section in the skinconf to be put to good use.
+        </p>
+<a name="N102E8"></a><a name="changes-12"></a>
+<h3 class="underlined_5">Changes between document-v11 and document-v12</h3>
+<p>
+          doc-v12 enhances doc-v11 by relaxing various restrictions that were
+          found to be unnecessary.
+        </p>
+<ul>
+          
+<li>
+            Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are
+            allowed inside title.
+          </li>
+          
+<li>
+            Paragraphs (p|source|note|warning|fixme), table and figure|anchor are
+            allowed inside li.
+          </li>
+          
+<li>
+            Paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table,
+            figure|anchor are allowed inside definition lists (dd) and tables (td
+            and dh).
+          </li>
+          
+<li>
+            Inline content
+            (strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is
+            allowed in strong and em.
+          </li>
+        
+</ul>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Propchange: forrest/site/0.6/docs/document-v20.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/0.6/docs/document-v20.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v20.pdf?view=auto&rev=160902
==============================================================================
Binary file - no diff available.

Propchange: forrest/site/0.6/docs/document-v20.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Added: forrest/site/0.6/docs/document-v20.pod
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v20.pod?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/document-v20.pod (added)
+++ forrest/site/0.6/docs/document-v20.pod Mon Apr 11 08:11:56 2005
@@ -0,0 +1,523 @@
+
+=head1 NAME
+
+document-v20 - The Apache Forrest xdocs document-v2.0 DTD
+
+
+=head1 DESCRIPTION
+
+B<Note:>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+This is a demonstration document using all possible elements in the current Apache Forrest xdocs C<document-v20.dtd > (See the L<DTD changes|/"changes"> section at the bottom.) 
+
+
+=back
+
+ ------------------------------------------------------------
+
+
+
+=head2 Sample Content
+
+B<Hint: > See the xml source to see how the various elements are used and see the L<DTD documentation|dtd-docs> . 
+
+
+
+=head3 Block and inline elements
+
+This is a simple paragraph. Most documents contain a fair amount of paragraphs. Paragraphs are called C<<p> > . 
+
+With the C<<p xml:space="preserve"> > attribute, you can declare that whitespace should be preserved, without implying it is in any other way special. 
+
+This next paragraph has a class attribute of 'quote'. CSS can be used to present this C<<p class='quote'> > in a different style than the other paragraphs. The handling of this quoted paragraph is defined in the <extra-css> element in the skinconf.xml. 
+
+"Anyway, like I was sayin', shrimp is the fruit of the sea. You can barbecue it, boil it, broil it, bake it, sautee it. Dey's uh, shrimp-kabobs, shrimp creole, shrimp gumbo. Pan fried, deep fried, stir-fried. There's pineapple shrimp, lemon shrimp, coconut shrimp, pepper shrimp, shrimp soup, shrimp stew, shrimp salad, shrimp and potatoes, shrimp burger, shrimp sandwich. That- that's about it. "
+
+A number of in-line elements are available in the DTD, we will show them inside an unordered list ( C<<ul> > ): 
+
+
+
+
+=over 4
+
+
+
+=item *
+
+
+Here is a simple list item ( C<<li> > ). 
+
+
+=item *
+
+
+Have you seen the use of the C<<code> > element in the previous item? 
+
+
+=item *
+
+
+Also, we have C<<sub> > and C<<sup> > elements to show content above or below the text baseline. 
+
+
+=item *
+
+
+There is a facility to I<emphasize > certain words using the C<<em> > B<C<<strong> > > elements. 
+
+
+=item *
+
+
+We can use [icon: feather] C<<icon> > s too. 
+
+
+=item *
+
+
+Another possibility is the C<<img> > element: [img: another feather] , which offers the ability to refer to an image map. 
+
+
+=item *
+
+
+We have elements for hyperlinking: 
+
+B<C<<a href="../faq.html"> > >
+
+
+=over 4
+
+Use this to L<link|../faq> to another document. As per normal, this will open the new document in the same browser window. 
+
+
+=back
+
+B<C<<a href="#section"> > >
+
+
+=over 4
+
+Use this to L<link|/"section"> to the named anchor in the current document. 
+
+
+=back
+
+B<C<<a href="../faq.html#overview"> > >
+
+
+=over 4
+
+Use this to L<link|../faq/"overview"> to another document and go to the named anchor. This will open the new document in the same browser window. 
+
+
+=back
+
+B<Targetted window control with jump and fork. >
+
+
+=over 4
+
+See demonstration L<using class attribute on links|/"link-class"> . 
+
+
+=back
+
+
+
+
+=item *
+
+
+Oh, by the way, a definition list C<<dl> > was used inside the previous list item. We could put another 
+
+
+=over 4
+
+
+
+=item *
+
+
+unordered list 
+
+
+=item *
+
+
+inside the list item 
+
+
+=back
+
+
+ A sample nested table 
+ +---------------------------------+---------------------------------+
+ | Or even tables..                | inside tables..                 |
+ +---------------------------------+---------------------------------+
+ | or inside lists, but I believe  |                                 |
+ | this liberty gets quickly quite |                                 |
+ |  hairy as you see.              |                                 |
+ +---------------------------------+---------------------------------+
+
+
+
+
+
+=back
+
+
+So far for the in-line elements, let's look at some paragraph-level elements. 
+
+B<Fixme (SN):>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+The C<<fixme> > element is used for stuff which still needs work. Mind the C<author > attribute! 
+
+
+=back
+
+ ------------------------------------------------------------
+
+B<Note:>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+Use the C<<note> > element to draw attention to something, e.g. ...The C<<code> > element is used when the author can't express himself clearly using normal sentences ;-) 
+
+
+=back
+
+ ------------------------------------------------------------
+
+B<Warning:>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+Sleep deprivation can be the result of being involved in an open source project. (a.k.a. the C<<warning> > element). 
+
+
+=back
+
+ ------------------------------------------------------------
+
+B<Important>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+If you want your own labels for notes and warnings, specify them using the C<label > attribute. 
+
+
+=back
+
+ ------------------------------------------------------------
+
+Apart from unordered lists, we have ordered lists too, of course. 
+
+
+
+
+=over 4
+
+
+
+=item 1.
+
+Item 1 
+
+
+=item 2.
+
+Item 2 
+
+
+=item 3.
+
+This should be 3 if my math is still OK. 
+
+
+=back
+
+
+
+
+
+
+=head3 Various presentation formats
+
+This sample document, written in document-v20 XML can be presented via Forrest in a number of different formats. The links in the following list show this document in each of the currently available formats. 
+
+Each of the formats can be made available as a link near the top of the page. Actual placement of those links depends on the skin currently in use. Those links are enabled in the skinconf.xml via the <disable-XXX-link> elements in the skinconf.xml 
+
+ 
+ +---------------------+---------------------+---------------------+
+ | Presentation Format | Description         | skinconf.xml Elemen |
+ |                     |                     | t                   |
+ +---------------------+---------------------+---------------------+
+ | document-v20        | This document in HT | Always generated by |
+ |                     | ML format.          |  default. Cannot be |
+ |                     |                     |  turned off.        |
+ +---------------------+---------------------+---------------------+
+ | document-v20.xml    | This document in it | <disable-xml-link>. |
+ |                     | s raw XML format.   |  By default, set to |
+ |                     |                     |  true, meaning that |
+ |                     |                     |  this link will not |
+ |                     |                     |  be shown.          |
+ +---------------------+---------------------+---------------------+
+ | document-v20.pdf    | This document as Ad | <disable-pdf-link>. |
+ |                     | obe PDF             |  By default, set to |
+ |                     |                     |  false, meaning tha |
+ |                     |                     | t this link will be |
+ |                     |                     |  shown.             |
+ +---------------------+---------------------+---------------------+
+ | Text                | This document as st | <disable-txt-link>. |
+ |                     | raight text.        |  By default, set to |
+ |                     |                     |  true, meaning that |
+ |                     |                     |  this link will not |
+ |                     |                     |  be shown. NOT YET  |
+ |                     |                     | IMPLEMENTED.        |
+ +---------------------+---------------------+---------------------+
+ | document-v20.pod    | This document as Pe | <disable-pod-link>. |
+ |                     | rl POD (Plain Old D |  By default, set to |
+ |                     | ocumentation). Text |  true, meaning that |
+ |                     |  with minimal forma |  this link will not |
+ |                     | tting directives. I |  be shown.          |
+ |                     | f on a *nix system  |                     |
+ |                     | with perl installed |                     |
+ |                     | , see "man perlpod" |                     |
+ |                     | .                   |                     |
+ +---------------------+---------------------+---------------------+
+
+
+
+
+
+
+=head3 Using sections
+
+You can use sections to put some structure in your document. For some strange historical reason, the section title is an attribute of the C<<section> > element. 
+
+
+
+
+
+=head3 Sections, the sequel
+
+Just some second section. 
+
+
+
+=head4 Section 2.1
+
+Which contains a subsection (2.1). 
+
+
+
+
+
+
+
+=head3 Showing preformatted source code
+
+Enough about these sections. Let's have a look at more interesting elements, C<<source> > for instance: 
+
+ 
+ // This example is from the book _Java in a Nutshell_ by David Flanagan.
+ // Written by David Flanagan.  Copyright (c) 1996 O'Reilly & Associates.
+ // You may study, use, modify, and distribute this example for any purpose.
+ // This example is provided WITHOUT WARRANTY either expressed or implied.
+ 
+ import java.applet.*;    // Don't forget these import statements!
+ import java.awt.*;
+ 
+ public class FirstApplet extends Applet {
+     // This method displays the applet.
+     // The Graphics class is how you do all drawing in Java.
+     public void paint(Graphics g) {
+         g.drawString("Hello World", 25, 50);
+     }
+ }
+
+
+CDATA sections are used within C<<source> > elements so that you can write pointy brackets without needing to escape them with messy C<&lt; > entities ... 
+
+ 
+ <pointy>
+   easy
+ </pointy>
+ 
+
+
+Please take care to still use a sensible line-length within your source elements. 
+
+
+
+
+
+=head3 Using tables
+
+And now for a table: 
+
+ Table caption 
+ +---------------------+---------------------+---------------------+
+ | heading cell 1      | heading cell 2      | heading cell 3      |
+ +---------------------+---------------------+---------------------+
+ | data cell           | this data cell span |                     |
+ |                     | s two columns       |                     |
+ +---------------------+---------------------+---------------------+
+ | Tables can be neste |                     | and can include mos |
+ | d:                  |                     | t other elements    |
+ |                     |                   c |                     |
+ |                     | olumn 1             | such as lists       |
+ |                     |                   c |                     |
+ |                     | olumn 2             |                     |
+ |                     |                     |                     |
+ |                     |                     |                     |
+ |                     |                   c |                     |
+ |                     | ell A               |                     |
+ |                     |                   c |                     |
+ |                     | ell B               |                     |
+ |                     |                     |                     |
+ |                     |                     |                     |
+ +---------------------+---------------------+---------------------+
+
+
+
+
+
+
+=head3 Using figures
+
+And a C<<figure> > to end all of this. Note that this can also be implemented with an C<<img> > element. 
+
+[figure: The fine Forrest logo] 
+
+
+
+=head3 Using class attribute on links
+
+The document-v13 had elements <fork> and <jump>. In document-v20, those elements no longer exist but the functionality can be duplicated by using the @class attribute. Even though the opening of separate windows should be under the control of the user, these techniques can still be employed. 
+
+ 
+ +---------------------------------+---------------------------------+
+ | Document V1.3                   | Document V2.0                   |
+ |                                 |                                 |
+ +---------------------------------+---------------------------------+
+ | <fork href="../faq.html">       | ../faq                          |
+ |                                 |                                 |
+ +---------------------------------+---------------------------------+
+ | <jump href="../faq.html">       | ../faq                          |
+ |                                 |                                 |
+ +---------------------------------+---------------------------------+
+
+
+
+
+
+
+
+
+=head2 DTD changes
+
+See the generated L<DTD documentation|dtd-docs> . 
+
+
+
+=head3 Changes between document-v13 and document-v20
+
+
+
+
+=over 4
+
+
+
+=item *
+
+
+Renamed B<<link> > to B<<a> > 
+
+
+=item *
+
+
+Removed B<<fork> > and B<<jump> > in favour of the B<<a> > element. See demonstration L<using class attribute on links|/"link-class"> . 
+
+
+=back
+
+
+
+
+
+
+=head3 Changes between document-v12 and document-v13
+
+All v1.2 docs will work fine as v1.3 DTD. The main change is the addition of a @class attribute to every element, which enables the "extra-css" section in the skinconf to be put to good use. 
+
+
+
+
+
+=head3 Changes between document-v11 and document-v12
+
+doc-v12 enhances doc-v11 by relaxing various restrictions that were found to be unnecessary. 
+
+
+
+
+=over 4
+
+
+
+=item *
+
+
+Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are allowed inside title. 
+
+
+=item *
+
+
+Paragraphs (p|source|note|warning|fixme), table and figure|anchor are allowed inside li. 
+
+
+=item *
+
+
+Paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table, figure|anchor are allowed inside definition lists (dd) and tables (td and dh). 
+
+
+=item *
+
+
+Inline content (strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is allowed in strong and em. 
+
+
+=back
+
+
+
+
+
+
+
+

Propchange: forrest/site/0.6/docs/document-v20.pod
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/0.6/docs/document-v20.xml
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v20.xml?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/document-v20.xml (added)
+++ forrest/site/0.6/docs/document-v20.xml Mon Apr 11 08:11:56 2005
@@ -0,0 +1,399 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  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.
+--><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "document-v13.dtd">
+<document> 
+  <header> 
+    <title>The Apache Forrest xdocs document-v2.0 DTD</title> 
+    <notice>The content of this document doesn't make any sense at all.</notice>
+    <abstract>This is a demonstration document using all possible elements in
+      the current Apache Forrest xdocs <code>document-v20.dtd</code>
+    </abstract> 
+  </header> 
+  <body> 
+    <note>
+      This is a demonstration document using all possible elements in the
+      current Apache Forrest xdocs <code>document-v20.dtd</code>
+      (See the <link href="#changes">DTD changes</link> section at the bottom.)
+    </note>
+    <section id="sample">
+      <title>Sample Content</title>
+      <p><strong>Hint:</strong> See the xml source to see how the various
+      elements are used and see the
+<!-- FOR-321 workaround
+      <a href="site:dtd-docs">DTD reference documentation</a>.
+-->
+      <link href="dtd-docs.html">DTD documentation</link>.
+      </p>
+      <section id="block-inline">
+        <title>Block and inline elements</title>
+      <p>This is a simple paragraph. Most documents contain a fair amount of
+        paragraphs. Paragraphs are called <code>&lt;p&gt;</code>.</p> 
+      <p xml:space="preserve">With the <code>&lt;p xml:space="preserve"&gt;</code> attribute, you can declare
+        that whitespace should    be   preserved, without implying it is in any other
+        way special.</p>
+      <p>
+        This next paragraph has a class attribute of 'quote'.  CSS can
+        be used to present this <code>&lt;p class='quote'&gt;</code> in
+        a different style than the other paragraphs.  The handling of
+        this quoted paragraph is defined in the &lt;extra-css&gt;
+        element in the skinconf.xml.
+      </p>
+      <p class="quote">
+        Anyway, like I was sayin', shrimp is the fruit of the sea. You can
+        barbecue it, boil it, broil it, bake it, sautee it. Dey's uh,
+        shrimp-kabobs, shrimp creole, shrimp gumbo. Pan fried, deep fried,
+        stir-fried. There's pineapple shrimp, lemon shrimp, coconut shrimp,
+        pepper shrimp, shrimp soup, shrimp stew, shrimp salad, shrimp and
+        potatoes, shrimp burger, shrimp sandwich. That- that's about it.
+      </p>
+      <p>A number of in-line elements are available in the DTD, we will show them
+        inside an unordered list (<code>&lt;ul&gt;</code>):</p> 
+      <ul> 
+        <li>Here is a simple list item (<code>&lt;li&gt;</code>).</li> 
+        <li>Have you seen the use of the <code>&lt;code&gt;</code> element in the
+          previous item?</li> 
+        <li>Also, we have <code>&lt;sub&gt;</code> and <code>&lt;sup&gt;</code>
+          elements to show content <sup>above</sup> or <sub>below</sub> the text
+          baseline.</li> 
+        <li>There is a facility to <em>emphasize</em> certain words using the
+          <code>&lt;em&gt;</code> <strong><code>&lt;strong&gt;</code></strong>
+          elements.</li> 
+        <li>We can use
+          <icon height="22" width="26" src="images/icon.png" alt="feather"/>
+          <code>&lt;icon&gt;</code>s too.</li> 
+        <li>Another possibility is the <code>&lt;img&gt;</code> element:
+          <img src="images/icon.png" alt="another feather" height="22" width="26"/>,
+          which offers the ability to refer to an image map.</li> 
+        <li>We have elements for hyperlinking: 
+          <dl> 
+            <dt><code>&lt;a href="../faq.html"&gt;</code></dt> 
+            <dd>Use this to
+              <link href="../faq.html" title="Example of a document via link">link</link>
+              to another document. As per normal, this will open the new document
+              in the same browser window.</dd> 
+
+            <dt><code>&lt;a href="#section"&gt;</code></dt> 
+            <dd>Use this to
+              <link href="#section" title="Example of a document via local anchor">link</link>
+              to the named anchor in the current document.
+            </dd> 
+
+            <dt><code>&lt;a href="../faq.html#overview"&gt;</code></dt> 
+            <dd>Use this to
+              <link href="../faq.html#overview" title="Example of a document via link and anchor">link</link>
+              to another document and go to the named anchor. This will open
+              the new document in the same browser window.
+            </dd> 
+            <dt>Targetted window control with jump and fork.</dt> 
+            <dd>See demonstration
+             <link href="#link-class">using class attribute on links</link>.
+            </dd> 
+        </dl></li> 
+
+        <li>Oh, by the way, a definition list <code>&lt;dl&gt;</code> was used inside
+          the previous list item. We could put another 
+          <ul> 
+            <li>unordered list</li> 
+            <li>inside the list item</li> 
+          </ul>
+          <table>
+            <caption>A sample nested table</caption>
+            <tr><td colspan="1" rowspan="1">Or even tables.. </td><td colspan="1" rowspan="1">
+                <table><tr><td colspan="1" rowspan="1">inside tables..</td></tr></table>
+            </td></tr>
+            <tr><td colspan="1" rowspan="1">or inside lists, but I believe this liberty gets quickly quite
+                hairy as you see.</td></tr>
+          </table>
+        </li>
+      </ul> 
+      <p>So far for the in-line elements, let's look at some paragraph-level
+        elements.</p> 
+      <fixme author="SN">The <code>&lt;fixme&gt;</code> element is used for stuff
+        which still needs work. Mind the <code>author</code> attribute!</fixme> 
+      <note>Use the <code>&lt;note&gt;</code> element to draw attention to something, e.g. ...The <code>&lt;code&gt;</code> element is used when the author can't
+        express himself clearly using normal sentences ;-)</note>
+      <warning>Sleep deprivation can be the result of being involved in an open
+        source project. (a.k.a. the <code>&lt;warning&gt;</code> element).
+      </warning>
+      <note label="Important">If you want your own labels for notes and
+        warnings, specify them using the <code>label</code> attribute.
+      </note>
+      <p>Apart from unordered lists, we have ordered lists too, of course.</p> 
+      <ol> 
+        <li>Item 1</li> 
+        <li>Item 2</li> 
+        <li>This should be 3 if my math is still OK.</li> 
+      </ol>
+      </section>
+
+      <section id="presentations">
+        <title>Various presentation formats</title>
+
+        <p>This sample document, written in document-v20 XML can be presented
+        via Forrest in a number of different formats. The links in the
+        following list show this document in each of the currently available
+        formats.</p>
+
+        <p>Each of the formats can be made available as a link near the top of
+        the page. Actual placement of those links depends on the skin
+        currently in use. Those links are enabled in the skinconf.xml via the
+        &lt;disable-XXX-link&gt; elements in the skinconf.xml</p>
+
+        <table>
+          <tr>
+            <th colspan="1" rowspan="1">Presentation Format</th>
+
+            <th colspan="1" rowspan="1">Description</th>
+
+            <th colspan="1" rowspan="1">skinconf.xml Element</th>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1"><link href="document-v20.html">HTML</link></td>
+
+            <td colspan="1" rowspan="1">This document in HTML format. </td>
+
+            <td colspan="1" rowspan="1">Always generated by default. Cannot be turned off.</td>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1"><link href="document-v20.xml">XML</link></td>
+
+            <td colspan="1" rowspan="1">This document in its raw XML format.</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-xml-link&gt;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1"><link href="document-v20.pdf">PDF</link></td>
+
+            <td colspan="1" rowspan="1">This document as Adobe PDF</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-pdf-link&gt;. By default, set to false, meaning
+            that this link will be shown.</td>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1">Text</td>
+
+            <td colspan="1" rowspan="1">This document as straight text.</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-txt-link&gt;. By default, set to true, meaning
+            that this link will not be shown. NOT YET IMPLEMENTED.</td>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1"><link href="document-v20.pod">POD</link></td>
+
+            <td colspan="1" rowspan="1">This document as Perl POD (Plain Old Documentation). Text with
+            minimal formatting directives. If on a *nix system with perl
+            installed, see "man perlpod".</td>
+
+            <td colspan="1" rowspan="1">&lt;disable-pod-link&gt;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          </tr>
+        </table>
+      </section>
+      <section id="section"> 
+        <title>Using sections</title>
+        <p>You can use sections to put some structure in your document. For some
+          strange historical reason, the section title is an attribute of the
+          <code>&lt;section&gt;</code> element.</p> 
+      </section> 
+      <section id="sub-section">
+        <title>Sections, the sequel</title>
+        <p>Just some second section.</p> 
+        <section id="sub-sub-section">
+          <title>Section 2.1</title>
+          <p>Which contains a subsection (2.1).</p> 
+        </section> 
+      </section> 
+
+      <section id="source">
+        <title>Showing preformatted source code</title> 
+        <p>Enough about these sections. Let's have a look at more interesting
+          elements, <code>&lt;source&gt;</code> for instance:</p> 
+        <source xml:space="preserve"><![CDATA[
+// This example is from the book _Java in a Nutshell_ by David Flanagan.
+// Written by David Flanagan.  Copyright (c) 1996 O'Reilly & Associates.
+// You may study, use, modify, and distribute this example for any purpose.
+// This example is provided WITHOUT WARRANTY either expressed or implied.
+
+import java.applet.*;    // Don't forget these import statements!
+import java.awt.*;
+
+public class FirstApplet extends Applet {
+    // This method displays the applet.
+    // The Graphics class is how you do all drawing in Java.
+    public void paint(Graphics g) {
+        g.drawString("Hello World", 25, 50);
+    }
+}]]></source>
+        <p>CDATA sections are used within 
+          <code>&lt;source&gt;</code> elements so that you can write pointy
+           brackets without needing to escape them with messy
+          <code>&amp;lt;</code> entities ...
+        </p> 
+        <source xml:space="preserve"><![CDATA[
+<pointy>
+  easy
+</pointy>
+]]></source>
+        <p>Please take care to still use a sensible line-length within your
+          source elements.</p>
+      </section>
+
+      <section id="table">
+        <title>Using tables</title>
+        <p>And now for a table:</p>
+        <table>
+          <caption>Table caption</caption>
+          <tr>
+            <th colspan="1" rowspan="1">heading cell 1</th>
+            <th colspan="1" rowspan="1">heading cell 2</th>
+            <th colspan="1" rowspan="1">heading cell 3</th>
+          </tr>
+          <tr>
+            <td colspan="1" rowspan="1">data cell</td>
+            <td colspan="2" rowspan="1">this data cell spans two columns</td>
+          </tr>
+          <tr>
+            <td colspan="1" rowspan="1">
+              Tables can be nested:
+            </td>
+            <td colspan="1" rowspan="1">
+              <table>
+                <tr>
+                  <th colspan="1" rowspan="1">column 1</th>
+                  <th colspan="1" rowspan="1">column 2</th>
+                </tr> 
+                <tr>
+                  <td colspan="1" rowspan="1">cell A</td>
+                  <td colspan="1" rowspan="1">cell B</td>
+                </tr>
+              </table>
+            </td>
+            <td colspan="1" rowspan="1">
+              <ul><li>and can include most other elements</li><li>such as lists</li></ul>
+            </td>
+          </tr>
+        </table> 
+      </section>
+
+      <anchor id="second-figure-anchor"/>
+      <section id="figure"> 
+        <title>Using figures</title>
+        <p>And a <code>&lt;figure&gt;</code> to end all of this.
+          Note that this can also be implemented with an
+          <code>&lt;img&gt;</code> element.
+        </p>
+        <figure src="images/project-logo.png" alt="The fine Forrest logo" width="220" height="65"/>&#9;
+      </section>
+      <section id="link-class">
+        <title>Using class attribute on links</title>
+
+        <p>The document-v13 had elements &lt;fork&gt; and &lt;jump&gt;. In
+        document-v20, those elements no longer exist but the functionality can
+        be duplicated by using the @class attribute.
+        Even though the opening of separate windows should be under the
+        control of the user, these techniques can still be employed.</p>
+
+        <table>
+          <tr>
+            <th colspan="1" rowspan="1"><p>Document V1.3</p></th>
+
+            <th colspan="1" rowspan="1"><p>Document V2.0</p></th>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1"><p>&lt;fork href="../faq.html"&gt;</p></td>
+
+            <td colspan="1" rowspan="1"><link class="fork" href="../faq.html">&lt;a class="fork"
+            href="../faq.html"&gt;</link></td>
+          </tr>
+
+          <tr>
+            <td colspan="1" rowspan="1"><p>&lt;jump href="../faq.html"&gt;</p></td>
+
+            <td colspan="1" rowspan="1"><p><link class="jump" href="../faq.html">&lt;a class="jump"
+            href="../faq.html"&gt;</link></p></td>
+          </tr>
+        </table>
+      </section>
+    </section>
+
+    <section id="changes">
+      <title>DTD changes</title>
+      <p>See the generated
+<!-- FOR-321 workaround
+        <a href="site:dtd-docs">DTD reference documentation</a>.
+-->
+        <link href="dtd-docs.html">DTD documentation</link>.
+      </p>
+      <section id="changes-20">
+        <title>Changes between document-v13 and document-v20</title>
+        <ul>
+          <li>Renamed <strong>&lt;link&gt;</strong>
+             to <strong>&lt;a&gt;</strong>
+          </li>
+          <li>Removed <strong>&lt;fork&gt;</strong>
+             and <strong>&lt;jump&gt;</strong> in favour of the
+             <strong>&lt;a&gt;</strong> element. See demonstration
+             <link href="#link-class">using class attribute on links</link>.
+          </li>
+        </ul>
+      </section>
+      <section id="changes-13">
+        <title>Changes between document-v12 and document-v13</title>
+        <p>
+          All v1.2 docs will work fine as v1.3 DTD. The main change is the
+          addition of a @class attribute to every element, which enables the
+          "extra-css" section in the skinconf to be put to good use.
+        </p>
+      </section>
+      <section id="changes-12">
+        <title>Changes between document-v11 and document-v12</title>
+        <p>
+          doc-v12 enhances doc-v11 by relaxing various restrictions that were
+          found to be unnecessary.
+        </p>
+        <ul>
+          <li>
+            Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are
+            allowed inside title.
+          </li>
+          <li>
+            Paragraphs (p|source|note|warning|fixme), table and figure|anchor are
+            allowed inside li.
+          </li>
+          <li>
+            Paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table,
+            figure|anchor are allowed inside definition lists (dd) and tables (td
+            and dh).
+          </li>
+          <li>
+            Inline content
+            (strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is
+            allowed in strong and em.
+          </li>
+        </ul>
+      </section>
+    </section>
+  </body> 
+  <footer> 
+    <legal>This is a legal notice, so it is <strong>important</strong>.</legal> 
+  </footer>
+</document>
\ No newline at end of file

Propchange: forrest/site/0.6/docs/document-v20.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/0.6/docs/dreams.html
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/dreams.html?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/dreams.html (added)
+++ forrest/site/0.6/docs/dreams.html Mon Apr 11 08:11:56 2005
@@ -0,0 +1,557 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<meta-data></meta-data>
+<title>Forrest dream list (v0.6)</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://forrest.apache.org/">forrest</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="../images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="base-not-selected" href="../contrib.html">Project</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../docs/index.html">O.6 Docs</a>
+</li>
+<li>
+<a class="base-not-selected" href="../howto/index.html">0.6 How-To</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs">
+<a class="base-selected" href="../docs/your-project.html">Core</a> | <a class="base-selected" href="../docs/forrestbot.html">ForrestBot</a> | <a class="base-selected" href="../docs/forrestbar.html">ForrestBar</a>
+</div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Documentation</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/your-project.html">Using Forrest</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/validation.html">XML Validation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/searching.html">Searching</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/skins.html">Default Skins</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/skin-package.html">Skin Packages</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrest-contract.html">Our Contract</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/compliance.html">Standards Compliance</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.10', '../skin/')" id="menu_1.1.10Title" class="menutitle">Advanced Topics</div>
+<div id="menu_1.1.10" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/catalog.html">Using DTD Catalogs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/cap.html">Sourcetype Action</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.11', '../skin/')" id="menu_1.1.11Title" class="menutitle">Upgrading</div>
+<div id="menu_1.1.11" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/upgrading_06.html">Upgrading to 0.6</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/upgrading_05.html">Upgrading to 0.5</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">SubProjects</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/forrestbar.html">ForrestBar</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrestbot.html">Forrestbot</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrestbot-web-interface.html">Forrestbot Webapp</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">Reference docs</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.1', '../skin/')" id="menu_1.3.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.3.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.2', '../skin/')" id="menu_1.3.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v20.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.4', '../skin/')" id="menu_selected_1.4Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Older Docs</div>
+<div id="menu_selected_1.4" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../docs/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/libre-intro.html">Libre</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Dream list</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+    This is documentation for past release v0.6
+   (<a href="http://forrest.apache.org/docs.html">More</a> ...)</div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="dreams.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<div class="trail">
+	        Font size: 
+	          &nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">      
+	          &nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>Forrest dream list</h1>
+<h3>Overview</h3>
+<div id="motd-area">
+    This is documentation for past release v0.6
+   (<a href="http://forrest.apache.org/docs.html">More</a> ...)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Draft+dream+list">Draft dream list</a>
+</li>
+</ul>
+</div>
+ 
+<a name="N10010"></a><a name="Introduction"></a>
+<h2 class="underlined_10">Introduction</h2>
+<div class="section">
+<p>This is the initial attempt to give focus to the Forrest project. 
+   This summary is a loose collection of items from the forrest-dev
+   mailing list. Please add and re-arrange so that it can evolve into a
+   focus document. The <a href="../docs/primer.html">Forrest Primer</a>
+   provides an overview.
+  </p>
+<p>These are the email threads and documents that are currently being
+   summarised. Please see those documents for further detail.
+  </p>
+<ul>
+   
+<li>
+    [RT] my Forrest dream-list
+    Date: Wed, 20 Feb 2002
+    <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101431895118349">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101431895118349</a>
+    [done]
+   </li>
+   
+<li>
+    README 
+    [FIXME: not yet started summarising]
+   </li>
+   
+<li>
+    [phases] Forrest
+    Date: Fri, 22 Feb 2002
+    <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101445744931104">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101445744931104</a>
+    [FIXME: not yet started summarising]
+   </li>
+   
+<li>
+    adding to the dream list
+    Date: Fri, 15 Mar 2002
+    <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101620970016263">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101620970016263</a>
+    [FIXME: not yet started summarising]
+   </li>
+   
+<li>
+    analysis paralysis :-)
+    Date: Mon, 25 Feb 2002
+    <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101465344708301">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101465344708301</a>
+    [FIXME: not yet started summarising]
+   </li>
+   
+<li>
+    documentation architecture?
+    Date: Thu, 25 Apr 2002
+    <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101973705501466">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101973705501466</a>
+    [FIXME: not yet started summarising]
+   </li>
+   
+<li>
+    Topic Maps for Forrest ?
+    Date: Mon, 18 Mar 2002
+    <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101647290524645">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101647290524645</a>
+    [FIXME: not yet started summarising]
+   </li>
+  
+</ul>
+</div>
+
+ 
+<a name="N10051"></a><a name="Draft+dream+list"></a>
+<h2 class="underlined_10">Draft dream list</h2>
+<div class="section">
+<ul>
+  
+<li>
+   Forrest provides a robust technological infrastructure for open software development for the Apache Software Foundation based on ASF software, ASF practices and experience, and modern software design principles.
+  </li>
+ 
+<li>
+  a publishing system for documentation
+ </li>
+ 
+<li>
+  analysis of logs and publishing of results
+ </li>
+
+ 
+<li>
+Ok, first of all: "it hurts my spirit" (I should TM this) to see the
+apache web sites with such a *poor* information infrastructure. Just
+look at sourceforge: it's not the best site of the world, but gives you
+lots of tools and information that we currently don't have (or have
+hidden someplace).
+ </li>
+
+ 
+<li>
+I want Forrest to be the development infrastructure of your dreams,
+something that you'll be proud of showing your boss and say "if only we
+had this in place, we would save big bucks" so...
+ </li>
+
+ 
+<li>
+  Dream #1: Forrest should make Sourceforge look obsolete.
+ </li>
+
+ 
+<li>
+So, in order for this to happen, it must be dynamic.
+Assumption #1: Forrest is a dynamic site.
+The staticity of apache web sites was mostly due to the quest for heavy
+mirroring, Forrest should allow mirroring, so
+ </li>
+
+ 
+<li>
+  Dream #2: Forrest should reduce xml.apache.org bandwidth use dramatically
+ </li>
+
+ 
+<li>
+  Dream #3: Forrest should automate mirroring in a simple and easy way.
+
+My idea is to use the 'command line' features of Cocoon to generate
+static snapshots of sites and produce mirrors directly using a sort of
+rsync or other mean. Anyway, the goal is to make sure mirroring is as
+easy as possible. No, easier than that.
+ </li>
+
+ 
+<li>
+  coherence: all the site should look coherent, same graphics, same
+look-and-feel, same information in the same locations, coherent and nice URI
+space (build to last! so that broken links are reduced!)
+ </li>
+
+ 
+<li>
+  structure: the site should look professional, the structure should be
+flexible enough to fit every need but solid enough to guide users
+browsing and developers adding resources
+ </li>
+
+ 
+<li>
+  scalability
+ </li>
+
+ 
+<li>
+  functionality: everything you ever wanted to have in your project web site
+ </li>
+
+ 
+<li>
+ logs and community rating: I want to have numbers to judge the value
+of a community/effort
+ </li>
+
+ 
+<li>
+Downloads, number of committers, numbers of people subscribed on the users/dev
+list, numbers of mail messages / week on these lists, CVS activity...
+These are the kind of parameters I use to "judge" an Apache project that I
+have not been looking into before.
+ </li>
+
+ 
+<li>
+  Graphs of various statistics.
+ </li>
+
+ 
+<li>
+Having good site metrics will be a valuable aid to those involved in
+maintenance and future re-design phases.
+See some discussion in
+<a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=102238816218885">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=102238816218885</a>
+ 
+</li>
+
+ 
+<li>
+ Built-in search engine: users much have a simple way to find things.
+ Lucene.
+ </li>
+
+ 
+<li>
+ User-writable pages: people should have a way to add things to the pages.
+ See the thread for more detail on this.
+FIXME: get MARC ref
+ </li>
+
+ 
+<li>
+ short bios for the project committers, with pictures: gives a better
+sense of community. Having a weblog there would be great.
+ </li>
+
+ 
+<li>
+ news, announcements, events and project calendaring: the news and
+the announcements will generate a RSS feed, events will be aggregated
+into a project-wide calendar, or an effort-specific calendar, the events
+will also be overwritten on the logs, to indicate how logs were
+influenced by the events (say, a release or a new committer added)
+ </li>
+
+ 
+<li>
+ book-like PDF versions of documentation: easy to print out docs.
+ </li>
+
+ 
+<li>
+  integration with GUMP: dependencies, runs, committer that broke the run
+ </li>
+
+ 
+<li>
+ javadocs seemlessly integrated with the documentation and with the
+search engine.
+ <a class="external" href="http://marc.theaimsgroup.com/?l=forrest-dev&m=101620970016263">http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=101620970016263</a>
+ 
+</li>
+ 
+ 
+<li>
+ mail archive seemlessly integrated with the search engine (one should
+look for something and get results from either docs, javadocs or emails
+messages)
+ </li>
+
+ 
+<li>
+  coherent-looking CVS view
+ </li>
+
+ 
+<li>
+  document translation using Google translation services
+ </li>
+
+ 
+<li>
+ Integrated project management, task management, bug tracking, feature requests, process management. 
+The idea is to integrate Scarab for bug tracking/patches and
+managing/feature requests.
+(As far as team management, this is a serious political issue and I do not
+want to tackle that one yet, not even on the dreamlist.)
+ </li>
+
+ 
+<li>
+  overview doco for all projects ... CVS Usage precis, overview of opensource
+  and links to relevant doco
+ </li>
+
+
+</ul>
+</div>
+
+ 
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2004 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Propchange: forrest/site/0.6/docs/dreams.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/0.6/docs/dreams.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/dreams.pdf?view=auto&rev=160902
==============================================================================
Binary file - no diff available.

Propchange: forrest/site/0.6/docs/dreams.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf



Mime
View raw message