You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by cr...@apache.org on 2006/02/15 07:36:23 UTC
svn commit: r377949 [4/21] - in /cocoon/site/site/2.1: ./ developing/
developing/portal/ developing/portal/coplets/ developing/webapps/
developing/webapps/authentication/ faq/ howto/ installing/
plan/documentation/ plan/otherplanning/ plan/overview/ sn...
Modified: cocoon/site/site/2.1/howto/howto-author-howto.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/howto/howto-author-howto.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/howto/howto-author-howto.html (original)
+++ cocoon/site/site/2.1/howto/howto-author-howto.html Tue Feb 14 22:36:05 2006
@@ -1,36 +1,65 @@
<!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.8-dev">
+
<meta name="Forrest-skin-name" content="pelt">
+
<title>How to Author a How-To</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>
+
+<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="../../images/cocoon.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> > <a href="http://cocoon.apache.org/">cocoon</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+
+<a href="http://www.apache.org/">apache</a> >
+ <a href="http://cocoon.apache.org/">cocoon</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/cocoon-project-logo.png" title="The Apache Software Foundation"></a>
+
+<a href="http://www.apache.org/">
+ <img class="logoImage" alt="Apache" src="../../images/cocoon-project-logo.png" title="The Apache Software Foundation">
+ </a>
+
</div>
<!--+
|end group logo
@@ -38,8 +67,13 @@
<!--+
|start Project Logo
+-->
+
<div class="projectlogo">
-<a href="http://cocoon.apache.org/"><img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-logo.gif" title="Apache Cocoon"></a>
+
+<a href="http://cocoon.apache.org/">
+ <img class="logoImage" alt="Apache Cocoon" src="../../images/cocoon-logo.gif" title="Apache Cocoon">
+ </a>
+
</div>
<!--+
|end Project Logo
@@ -47,11 +81,18 @@
<!--+
|start Search
+-->
+
<div class="searchbox">
+
<form action="http://www.google.com/search" method="get" class="roundtopsmall">
-<input value="cocoon.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
- <input name="Search" value="Search" type="submit">
+
+<input value="cocoon.apache.org" name="sitesearch" type="hidden">
+ <input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
+
+ <input name="Search" value="Search" type="submit">
+
</form>
+
</div>
<!--+
|end search
@@ -59,32 +100,45 @@
<!--+
|start Tabs
+-->
+
<ul id="tabs">
+
<li>
+
<a class="base-not-selected" href="http://cocoon.apache.org/">Home</a>
+
</li>
+
</ul>
<!--+
|end Tabs
+-->
+
</div>
+
</div>
+
<div id="main">
+
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
+
<div id="level2tabs"></div>
<!--+
|end Endtabs
+-->
+
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
+
</div>
<!--+
|breadtrail
+-->
+
<div class="breadtrail">
@@ -95,1117 +149,2223 @@
<!--+
|start Menu
+-->
+
<div id="menu">
+
<div onclick="SwitchMenu('menu_1.1', '../../skin/')" id="menu_1.1Title" class="menutitle">About</div>
+
<div id="menu_1.1" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/index.html">Index</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/features.html">Features</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/news.html">News</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/license.html">License</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/mirror.cgi">Download</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_selected_1.2', '../../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Documentation</div>
+
<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+
<div class="menuitem">
+
<a href="../../2.1/introduction.html">Introduction</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.2', '../../skin/')" id="menu_1.2.2Title" class="menutitle">Tracks</div>
+
<div id="menu_1.2.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/tracks/index.html">Introduction</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/tracks/first-steps-track.html">First steps</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/tracks/web-publishing-track.html">Web publishing</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.3', '../../skin/')" id="menu_1.2.3Title" class="menutitle">Installation</div>
+
<div id="menu_1.2.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/mirror.cgi">Download</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/installing/index.html">Intro</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/installing/requirements.html">System requirements</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/installing/updating-older.html">Updating to version 2.1.5</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/installing/jars.html">Jars</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/installing/tests.html">Overview</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/overview.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5', '../../skin/')" id="menu_1.2.5Title" class="menutitle">User Guide</div>
+
<div id="menu_1.2.5" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/index.html">User Documentation</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.2', '../../skin/')" id="menu_1.2.5.2Title" class="menutitle">Concepts</div>
+
<div id="menu_1.2.5.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/index.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.2.2', '../../skin/')" id="menu_1.2.5.2.2Title" class="menutitle">Sitemap</div>
+
<div id="menu_1.2.5.2.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/sitemap.html">Section Home</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/sitemap/sitemap-examples.html">Example sitemap snippets</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/views.html">Views</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/caching.html">Caching</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/actions.html">Actions</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/matchers_selectors.html">Matchers and Selectors</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/catalog.html">Entity Catalogs</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/mrustore.html">MRUMemoryStore</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/persistence.html">Persistence</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/storejanitor.html">StoreJanitor</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/xmlsearching.html">XML Searching</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/validation.html">XML Validation</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/databases.html">Databases</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/modules.html">Modules</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/modules-ref.html">Modules Reference</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/redirection.html">Redirection</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/profiler.html">Profiler</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/concepts/errorhandling.html">Error Handling</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3', '../../skin/')" id="menu_1.2.5.3Title" class="menutitle">Sitemap Components</div>
+
<div id="menu_1.2.5.3" class="menuitemgroup">
+
<div onclick="SwitchMenu('menu_1.2.5.3.1', '../../skin/')" id="menu_1.2.5.3.1Title" class="menutitle">Generators</div>
+
<div id="menu_1.2.5.3.1" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/generators.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.1.2', '../../skin/')" id="menu_1.2.5.3.1.2Title" class="menutitle">Default</div>
+
<div id="menu_1.2.5.3.1.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/default/file-generator.html">File Generator</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.1.3', '../../skin/')" id="menu_1.2.5.3.1.3Title" class="menutitle">Core</div>
+
<div id="menu_1.2.5.3.1.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/calendar-generator.html">Calendar Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/directory-generator.html">Directory Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/file-generator.html">File Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/imagedirectory-generator.html">Imagedirectory Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/jx-generator.html">Jx Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/linkstatus-generator.html">Linkstatus Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/mp3directory-generator.html">MP3directory Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/error-generator.html">Notifying Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/request-generator.html">Request Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/sessionattribute-generator.html">SessionAttribute Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/status-generator.html">Status Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/stream-generator.html">Stream Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xpathdirectory-generator.html">Xpathdirectory Generator</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.1.4', '../../skin/')" id="menu_1.2.5.3.1.4Title" class="menutitle">Optional</div>
+
<div id="menu_1.2.5.3.1.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/extractor-generator.html">Fragment Extractor Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/html-generator.html">HTML Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/jsp-generator.html">JSP Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/php-generator.html">PHP Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/profile-generator.html">Profile Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/script-generator.html">Script Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/search-generator.html">Search Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/serverpages-generator.html">Server Pages Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/velocity-generator.html">Velocity Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/wsproxy-generator.html">Web Service Proxy Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xmldbcollection-generator.html">XML:DB Collection Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xmldb-generator.html">XML:DB Generator</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.2', '../../skin/')" id="menu_1.2.5.3.2Title" class="menutitle">Transformers</div>
+
<div id="menu_1.2.5.3.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/transformers.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.2.2', '../../skin/')" id="menu_1.2.5.3.2.2Title" class="menutitle">Default</div>
+
<div id="menu_1.2.5.3.2.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/default/xslt-transformer.html">XSLT Transformer</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.2.3', '../../skin/')" id="menu_1.2.5.3.2.3Title" class="menutitle">Core</div>
+
<div id="menu_1.2.5.3.2.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/extractor-transformer.html">Fragment Extractor Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/i18nTransformer.html">I18n Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/jpath-transformer.html">JPath Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/log-transformer.html">Log Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/filter-transformer.html">Filter Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/readdomsession-transformer.html">Read DOM Session Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/rolefilter-transformer.html">RoleFilter Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/simpleform-transformer.html">SimpleForm Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/simpleforminstance-transformer.html">SimpleFormInstance Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/writedomsession-transformer.html">Write DOM Session Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xinclude-transformer.html">Xinclude Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/cinclude-transformer.html">Cinclude Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/encodeurl-transformer.html">EncodeUrl Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/sourcewriting-transformer.html">Sourcewriting Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/augment-transformer.html">Augment Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/jx-template-transformer.html">JX Template Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xslt-transformer.html">XSLT Transformer</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.2.4', '../../skin/')" id="menu_1.2.5.3.2.4Title" class="menutitle">Optional</div>
+
<div id="menu_1.2.5.3.2.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/ldap-transformer.html">LDAP Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/lexer-transformer.html">Lexical Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/parser-transformer.html">Parser Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/pattern-transformer.html">Pattern Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/session.html">Session Transformer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/sql-transformer.html">SQL Transformer</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.3', '../../skin/')" id="menu_1.2.5.3.3Title" class="menutitle">Serializers</div>
+
<div id="menu_1.2.5.3.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/serializers.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.3.2', '../../skin/')" id="menu_1.2.5.3.3.2Title" class="menutitle">Default</div>
+
<div id="menu_1.2.5.3.3.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/default/html-serializer.html">HTML Serializer</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.3.3', '../../skin/')" id="menu_1.2.5.3.3.3Title" class="menutitle">Core</div>
+
<div id="menu_1.2.5.3.3.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/html-serializer.html">HTML Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xhtml-serializer.html">XHTML Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xml-serializer.html">XML Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/text-serializer.html">Text Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/wap-serializer.html">WAP/WML Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/svg-serializer.html">SVG Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/svgxml-serializer.html">SVG/XML Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/svgjpeg-serializer.html">SVG/JPEG Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/svgpng-serializer.html">SVG/PNG Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/svgtiff-serializer.html">SVG/TIFF Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/vrml-serializer.html">VRML Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/link-serializer.html">Link Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/ziparchive-serializer.html">Zip archive Serializer</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.3.4', '../../skin/')" id="menu_1.2.5.3.3.4Title" class="menutitle">Optional</div>
+
<div id="menu_1.2.5.3.3.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/pdf-serializer.html">PDF Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/ps-serializer.html">PS Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/pcl-serializer.html">PCL Serializer</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xls-serializer.html">HSSF (XLS) Serializer</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.4', '../../skin/')" id="menu_1.2.5.3.4Title" class="menutitle">Matchers</div>
+
<div id="menu_1.2.5.3.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/matchers.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.4.2', '../../skin/')" id="menu_1.2.5.3.4.2Title" class="menutitle">Default</div>
+
<div id="menu_1.2.5.3.4.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/default/wildcarduri-matcher.html">WildCard URI Matcher</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.4.3', '../../skin/')" id="menu_1.2.5.3.4.3Title" class="menutitle">Core</div>
+
<div id="menu_1.2.5.3.4.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/core/wildcarduri-matcher.html">WildCard URI Matcher</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/core/wildcardheader-matcher.html">WildCard Header Matcher</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.4.4', '../../skin/')" id="menu_1.2.5.3.4.4Title" class="menutitle">Optional</div>
+
<div id="menu_1.2.5.3.4.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/template-matcher.html">Template Matcher</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.5', '../../skin/')" id="menu_1.2.5.3.5Title" class="menutitle">Selectors</div>
+
<div id="menu_1.2.5.3.5" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/selectors.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.5.2', '../../skin/')" id="menu_1.2.5.3.5.2Title" class="menutitle">Default</div>
+
<div id="menu_1.2.5.3.5.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/default/browser-selector.html">Browser Selector</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.5.3', '../../skin/')" id="menu_1.2.5.3.5.3Title" class="menutitle">Core</div>
+
<div id="menu_1.2.5.3.5.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/browser-selector.html">Browser Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/host-selector.html">Host Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/parameter-selector.html">Parameter Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/requestattribute-selector.html">Request Attribute Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/requestmethod-selector.html">Request Method Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/requestparameter-selector.html">Request Parameter Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/resourceexists-selector.html">Resource Exists Selector</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/regular-expression-header-selector.html">Regular-expression Header Selector</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.5.4', '../../skin/')" id="menu_1.2.5.3.5.4Title" class="menutitle">Scratchpad</div>
+
<div id="menu_1.2.5.3.5.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/scratchpad/date-selector.html">Date Selector</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.6', '../../skin/')" id="menu_1.2.5.3.6Title" class="menutitle">Actions</div>
+
<div id="menu_1.2.5.3.6" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/actions.html">Overview</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/database-actions.html">Database</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.6.3', '../../skin/')" id="menu_1.2.5.3.6.3Title" class="menutitle">Optional</div>
+
<div id="menu_1.2.5.3.6.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/sendmail-action.html">Sendmail Action</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/session-action.html">Session Action</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/script-action.html">Script Action</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.7', '../../skin/')" id="menu_1.2.5.3.7Title" class="menutitle">Readers</div>
+
<div id="menu_1.2.5.3.7" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/readers.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.7.2', '../../skin/')" id="menu_1.2.5.3.7.2Title" class="menutitle">Default</div>
+
<div id="menu_1.2.5.3.7.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/default/resource-reader.html">Resource Reader</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.7.3', '../../skin/')" id="menu_1.2.5.3.7.3Title" class="menutitle">Core</div>
+
<div id="menu_1.2.5.3.7.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/core/image-reader.html">Image Reader</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/core/resource-reader.html">Resource Reader</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.7.4', '../../skin/')" id="menu_1.2.5.3.7.4Title" class="menutitle">Optional</div>
+
<div id="menu_1.2.5.3.7.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/axisrpc-reader.html">AxisRPC Reader</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/database-reader.html">Database Reader</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/optional/jsp-reader.html">JSP Reader</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.3.7.5', '../../skin/')" id="menu_1.2.5.3.7.5Title" class="menutitle">Scratchpad</div>
+
<div id="menu_1.2.5.3.7.5" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/scratchpad/directoryziparchiver-reader.html">Directory ZIP Archiver</a>
+
</div>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.4', '../../skin/')" id="menu_1.2.5.4Title" class="menutitle">Flow</div>
+
<div id="menu_1.2.5.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/index.html">Introduction</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/continuations.html">Continuations</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/how-does-it-work.html">How does it work?</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/using.html">Usage</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/tutor.html">Tutorial</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/sitemap.html">Sitemap</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/api.html">Flowscript</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/java.html">Calling Java</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/views.html">Views</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/jxtemplate.html">JXTemplate</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/jpath.html">JPath</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/flow/velocity.html">Velocity</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.5', '../../skin/')" id="menu_1.2.5.5Title" class="menutitle">Cocoon Forms</div>
+
<div id="menu_1.2.5.5" class="menuitemgroup">
+
<div onclick="SwitchMenu('menu_1.2.5.5.1', '../../skin/')" id="menu_1.2.5.5.1Title" class="menutitle">Basics</div>
+
<div id="menu_1.2.5.5.1" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/basics/index.html">Introduction</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/basics/sample.html">Sample</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/basics/improving_sample.html">Improving the sample</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.5.2', '../../skin/')" id="menu_1.2.5.5.2Title" class="menutitle">Widgets</div>
+
<div id="menu_1.2.5.5.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_form.html">form</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_field.html">field</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_multivaluefield.html">multivaluefield</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_booleanfield.html">booleanfield</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_repeater.html">repeater</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_output.html">output</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_submit.html">submit</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_action.html">action</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_repeater_action.html">repeater-action</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_row_action.html">row-action</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_aggregatefield.html">aggregatefield</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_upload.html">upload</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_messages.html">messages</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_imagemap.html">imagemap</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_tree.html">tree</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_group.html">group/struct</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_union.html">union</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgets/widget_class.html">class/new</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.5.3', '../../skin/')" id="menu_1.2.5.5.3Title" class="menutitle">Widget Concepts</div>
+
<div id="menu_1.2.5.5.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgetconcepts/validation.html">Validation</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgetconcepts/eventhandling.html">Event Handling</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgetconcepts/datatypes.html">Datatypes</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgetconcepts/selectionlists.html">Selection lists</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/widgetconcepts/widgetstates.html">Widget states</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.5.4', '../../skin/')" id="menu_1.2.5.5.4Title" class="menutitle">Form Publishing</div>
+
<div id="menu_1.2.5.5.4" class="menuitemgroup">
+
<div onclick="SwitchMenu('menu_1.2.5.5.4.1', '../../skin/')" id="menu_1.2.5.5.4.1Title" class="menutitle">Templating</div>
+
<div id="menu_1.2.5.5.4.1" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/publishing/templating.html">Section Home</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/publishing/templating/templategenerator.html">Template Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/publishing/templating/templatetransformer.html">Template Transformer</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/publishing/formsgenerator.html">Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/publishing/xslt.html">XSLT</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/binding.html">Binding Framework</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xmlbinding.html">Simple XML Binding</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.5.7', '../../skin/')" id="menu_1.2.5.5.7Title" class="menutitle">API</div>
+
<div id="menu_1.2.5.5.7" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/api/api_javascript.html">Javascript (Flowscript)</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/api/api_java.html">Java</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/formlibraries.html">Form libraries</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/ajax.html">Ajax</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://wiki.apache.org/cocoon/Forms">Forms @ Wiki</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.6', '../../skin/')" id="menu_1.2.5.6Title" class="menutitle">XSP</div>
+
<div id="menu_1.2.5.6" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/index.html">Overview</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.6.2', '../../skin/')" id="menu_1.2.5.6.2Title" class="menutitle">XSP</div>
+
<div id="menu_1.2.5.6.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xsp.html">Section Home</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xsp/logicsheet.html">XSP Guide</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xsp/xsp-internals.html">XSP Internals</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xsp/logicsheet-concepts.html">XSP Logicsheets</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/xsp/sessions.html">Sessions</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.6.3', '../../skin/')" id="menu_1.2.5.6.3Title" class="menutitle">Logicsheets</div>
+
<div id="menu_1.2.5.6.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/logicsheets/request.html">Request</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/logicsheets/session.html">Session</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/logicsheets/esql.html">ESQL</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/logicsheets/logicsheet-forms.html">Forms</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/logicsheets/sendmail.html">Sendmail</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.5.7', '../../skin/')" id="menu_1.2.5.7Title" class="menutitle">Offline</div>
+
<div id="menu_1.2.5.7" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/offline/index.html">Overview</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/offline/cli.html">Command Line</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/offline/configuration.html">CLI Configuration</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/offline/ant.html">Ant</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/userdocs/offline/bean.html">Cocoon Bean</a>
+
</div>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.6', '../../skin/')" id="menu_1.2.6Title" class="menutitle">Developer's Guide</div>
+
<div id="menu_1.2.6" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/developing/index.html">Index</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.6.2', '../../skin/')" id="menu_1.2.6.2Title" class="menutitle">Concepts</div>
+
<div id="menu_1.2.6.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/developing/httprequest.html">Internals</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/extending.html">Extending</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/avalon.html">Avalon</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/source.html">Source Handling</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/stores.html">Stores</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/datasources.html">Using Databases</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/parent-component-manager.html">Parent CM</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/deliquick.html">DELI Quick Start</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/deli.html">DELI</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.6.3', '../../skin/')" id="menu_1.2.6.3Title" class="menutitle">Developing Webapps</div>
+
<div id="menu_1.2.6.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/index.html">Overview</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/session.html">Sessions</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/contexts.html">Session Contexts</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.6.3.4', '../../skin/')" id="menu_1.2.6.3.4Title" class="menutitle">Authentication</div>
+
<div id="menu_1.2.6.3.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication.html">Section Home</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/authentication-handler.html">The Authentication Handler</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/authenticating_user.html">Authenticating a User</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/user_management.html">User Management</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/application_management.html">Application Management</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/module_management.html">Module Management</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/user_administration.html">User Administration</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/summary.html">Configuration Summary</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/authentication/pipeline_patterns.html">Pipeline Patterns</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/forms.html">Simple Forms</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/webapps/portal.html">Portal FW</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.6.4', '../../skin/')" id="menu_1.2.6.4Title" class="menutitle">Building a portal using the Portal Engine</div>
+
<div id="menu_1.2.6.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/index.html">Index</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/portal-block.html">Portal Engine</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.6.4.3', '../../skin/')" id="menu_1.2.6.4.3Title" class="menutitle">Configuring Coplets</div>
+
<div id="menu_1.2.6.4.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/coplets.html">Section Home</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/coplets/uricoplet.html">The URICoplet</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/coplets/cachinguricoplet.html">The CachingURICoplet</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/layout_skins.html">Layout and Skins</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/events.html">Event Handling</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/profiles.html">Profiles</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/wsrp.html">WSRP Support</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/authentication.html">Authentication</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/forms.html">Form handling</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/portal/basket.html">A Basket</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/developing/web3.html">Connect to SAP R/3</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/2.1/apidocs/index.html">API (Javadoc)</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.7', '../../skin/')" id="menu_1.2.7Title" class="menutitle">Tutorials</div>
+
<div id="menu_1.2.7" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/tutorial/index.html">Index</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/tutorial/tutorial-develop-webapp.html">WebApp</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/tutorial/tutorial-generator.html">Custom Generator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/tutorial/tutorial-shots.html">Tutorial screenshots</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/tutorial/tutorial-rmi-generator.html">RMIServer</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.8', '../../skin/')" id="menu_1.2.8Title" class="menutitle">FAQ</div>
+
<div id="menu_1.2.8" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/faq/index.html">Index</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-install.html">Install</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-configure-environment.html">Configure</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-cvs.html">CVS/SVN</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-configure-c2.html">Configure C2</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-databases.html">Databases</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-xsp.html">XSP</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-xslt.html">XSLT</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-debugging.html">Debugging</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-sitemap.html">Sitemap</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-generators.html">Generators</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-transformers.html">Transformers</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-serializers.html">Serializers</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-matchers.html">Matchers</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-selectors.html">Selectors</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-actions.html">Actions</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/faq/faq-aggregators.html">Aggregators</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_selected_1.2.9', '../../skin/')" id="menu_selected_1.2.9Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">How Tos</div>
+
<div id="menu_selected_1.2.9" class="selectedmenuitemgroup" style="display: block;">
+
<div class="menuitem">
+
<a href="../../2.1/howto/index.html">Index</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-explore-samples.html">Samples</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-paginator-transformer.html">Paginator</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-html-pdf-publishing.html">HTML-PDF</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/wsproxy-generator.html">Web Syndication</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-flow-debugger.html">Flow Debugger</a>
+
</div>
+
<div class="menupage">
+
<div class="menupagetitle">Author How-To</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-author-faq.html">Author FAQ</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-author-snippet.html">Author Snippet</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-author-core-docs.html">Author Docs</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-patch.html">Prepare patch</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/howto/howto-bugzilla.html">Bugzilla</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/performancetips.html">Performance</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.2.11', '../../skin/')" id="menu_1.2.11Title" class="menutitle">Snippets</div>
+
<div id="menu_1.2.11" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/snippet/index.html">Index</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/snippet/snippet-xslt-options.html">XSLT Processor Options</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/snippet/snippet-internal-pipeline.html">Internal Pipeline</a>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="http://wiki.apache.org/cocoon/">Wiki Docs</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.3', '../../skin/')" id="menu_1.3Title" class="menutitle">Status</div>
+
<div id="menu_1.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/changes.html">Changes</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/todo.html">To Do</a>
+
</div>
+
<div onclick="SwitchMenu('menu_1.3.3', '../../skin/')" id="menu_1.3.3Title" class="menutitle">Planning Notes</div>
+
<div id="menu_1.3.3" class="menuitemgroup">
+
<div onclick="SwitchMenu('menu_1.3.3.1', '../../skin/')" id="menu_1.3.3.1Title" class="menutitle">Overview</div>
+
<div id="menu_1.3.3.1" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/plan/overview/index.html">Planning Overview</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/plan/overview/roadmap.html">Roadmap</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.3.3.2', '../../skin/')" id="menu_1.3.3.2Title" class="menutitle">Documentation</div>
+
<div id="menu_1.3.3.2" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/plan/documentation/doc.html">Overview</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/plan/documentation/linkstatus.html">Fix broken links</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.3.3.3', '../../skin/')" id="menu_1.3.3.3Title" class="menutitle">Other Planning</div>
+
<div id="menu_1.3.3.3" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/plan/otherplanning/release.html">Release Plan</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/plan/otherplanning/samples.html">Cocoon Samples</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/plan/otherplanning/proposed-toc.html">Proposed TOC</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/plan/otherplanning/updating.html">Updating Cocoon</a>
+
</div>
+
</div>
+
</div>
+
<div class="menuitem">
+
<a href="http://issues.apache.org/jira/browse/COCOON">Patch queue</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.4', '../../skin/')" id="menu_1.4Title" class="menutitle">Community</div>
+
<div id="menu_1.4" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="../../2.1/bylaws-addendum.html">Cocoon Bylaws</a>
+
</div>
+
<div class="menuitem">
+
<a href="../../2.1/who.html">Hall of Fame</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/community/contrib.html">Contributing</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/community/mail-lists.html">Mail Lists</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/community/mail-archives.html">Mail Archives</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.5', '../../skin/')" id="menu_1.5Title" class="menutitle">Project</div>
+
<div id="menu_1.5" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="http://issues.apache.org/jira/browse/COCOON">Bug Database</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://svn.apache.org/viewcvs.cgi/cocoon/branches/BRANCH_2_1_X/?root=Apache-SVN">Code Repository</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/mirror.cgi#nightly">Dev Snapshots</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.6', '../../skin/')" id="menu_1.6Title" class="menutitle">Other Releases</div>
+
<div id="menu_1.6" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/1.x/">Cocoon 1.x</a>
+
</div>
+
<div class="menuitem">
+
<a href="http://cocoon.apache.org/2.0/">Cocoon 2.0</a>
+
</div>
+
</div>
+
<div onclick="SwitchMenu('menu_1.7', '../../skin/')" id="menu_1.7Title" class="menutitle">External</div>
+
<div id="menu_1.7" class="menuitemgroup">
+
<div class="menuitem">
+
<a href="http://wiki.apache.org/cocoon/GT2005Hackaton">2005 Get Together</a>
+
</div>
+
</div>
+
<div id="credit"></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>
+
+<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 id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+
+<div id="credit2"></div>
+
</div>
<!--+
|end Menu
@@ -1213,44 +2373,74 @@
<!--+
|start content
+-->
+
<div id="content">
+
<h1>How to Author a How-To</h1>
-<a name="N10007"></a><a name="Overview"></a>
+
+<a name="N10007"></a>
+ <a name="Overview"></a>
+
<h2 class="h3">Overview</h2>
+
<div class="section">
+
<p>This How-To describes the steps necessary to write an effective How-To for
Cocoon. The Cocoon documentation project needs your help. Writing a Cocoon
How-To is a valuable way to give back to the community.</p>
+
</div>
-<a name="N1000D"></a><a name="Purpose"></a>
+
+<a name="N1000D"></a>
+ <a name="Purpose"></a>
+
<h2 class="h3">Purpose</h2>
+
<div class="section">
+
<p>These guidelines are based on successful How-To document structures used by
other open source projects with diverse author groups. Following these tried and
true guidelines will help to insure the effectiveness of your work and make it
easy for committers to apply it to the cvs.</p>
+
</div>
-<a name="N10013"></a><a name="Intended+Audience"></a>
+
+<a name="N10013"></a>
+ <a name="Intended+Audience"></a>
+
<h2 class="h3">Intended Audience</h2>
+
<div class="section">
+
<p>Cocoon users who are ready to share their knowledge and experiences with the
larger Cocoon community.</p>
+
</div>
-<a name="N10019"></a><a name="Prerequisites"></a>
+
+<a name="N10019"></a>
+ <a name="Prerequisites"></a>
+
<h2 class="h3">Prerequisites</h2>
+
<div class="section">
+
<p>How-To authors should have:</p>
+
<ul>
-
+
<li>A unique How-To topic, related to using Cocoon, which fulfills a specific
-need. Check out <a href="../../2.1/howto/index.html">existing How-Tos</a> to find a niche for
+need. Check out
+
+ <a href="../../2.1/howto/index.html">existing How-Tos</a> to find a niche for
your work. Consider posting your idea for the How-To to cocoon-user list, to
-make sure another author's draft is not already in process.</li>
-
+make sure another author's draft is not already in process.
+
+ </li>
+
<li>A sufficient ability in English to write the FAQ. If you need a little extra
help with language, consider partnering with another user with more advanced
English writing skills.</li>
-
+
<li>Currently, the Cocoon documentation project is still working out the exact
details for a How-To dtd and template. For now, just edit the most recent
version of any similar How-To, filling in your own content as necessary. For
@@ -1258,85 +2448,147 @@
include images. Make sure you use most recent version of document dtd to
validate any How-To file before submitting. You will find it in
src/documentation/xdocs/dtd in your cocoon distribution.</li>
-
+
</ul>
+
</div>
-<a name="N1002E"></a><a name="Steps"></a>
+
+<a name="N1002E"></a>
+ <a name="Steps"></a>
+
<h2 class="h3">Steps</h2>
+
<div class="section">
+
<p>Here's how to proceed.</p>
-<a name="N10034"></a><a name="1.+Write+the+Overview"></a>
+
+<a name="N10034"></a>
+ <a name="1.+Write+the+Overview"></a>
+
<h3 class="h4">1. Write the Overview</h3>
+
<p>An overview helps potential readers to determine quickly if a particular
How-To matches their interests or needs. In a few sentences, summarize the main
points of your How-To. Make sure to include any critical definitions which will
help readers evaluate the utility of your How-To. Consider writing the overview
last, after you have completed all other sections.</p>
-<a name="N1003A"></a><a name="2.+Describe+your+Intended+Audience"></a>
+
+<a name="N1003A"></a>
+ <a name="2.+Describe+your+Intended+Audience"></a>
+
<h3 class="h4">2. Describe your Intended Audience</h3>
+
<p>If your How-To is targetted at a specific audience, describe it here. For
example, potential readers will have different levels of skill using Cocoon.
They will also bring different areas of expertise and backgrounds to their
How-To learning experience. When you clarify your target audience up front, you
will save all other readers time and confusion.</p>
-<a name="N10040"></a><a name="3.+State+the+Purpose"></a>
+
+<a name="N10040"></a>
+ <a name="3.+State+the+Purpose"></a>
+
<h3 class="h4">3. State the Purpose</h3>
+
<p>State the purpose of your How-To. Explain how the reader will benefit by
reading it. Give your reader an incentive or two to continue.</p>
-<a name="N10046"></a><a name="4.+List+any+Prerequsites"></a>
+
+<a name="N10046"></a>
+ <a name="4.+List+any+Prerequsites"></a>
+
<h3 class="h4">4. List any Prerequsites</h3>
+
<p>Inform your reader about any required knowledge, configuration, or resources
they may need before stepping through your How-To. Assist them in this
preparation by linking to other useful resources on the Cocoon site or the web.
Helping your readers to prepare increases the likelihood that they will continue
reading your How-To.</p>
-<a name="N1004C"></a><a name="5.+Describe+the+Steps+of+your+How-To"></a>
+
+<a name="N1004C"></a>
+ <a name="5.+Describe+the+Steps+of+your+How-To"></a>
+
<h3 class="h4">5. Describe the Steps of your How-To</h3>
+
<p>In a precise, step-by-step approach, walk your reader through the process.
Make sure your reader can reproduce your intended result by following your exact
steps. Make the learning process efficient by supplying sample code snippets or
configuration details as necessary.</p>
-<a name="N10052"></a><a name="6.+Extend+the+Learning"></a>
+
+<a name="N10052"></a>
+ <a name="6.+Extend+the+Learning"></a>
+
<h3 class="h4">6. Extend the Learning</h3>
+
<p>Provide your reader with a few real-world examples of how the techniques or
capabilities gained from your How-To could be applied. Reward the reader for
successfully completing the How-To with a few ideas about how it will pay off.
</p>
-<a name="N10058"></a><a name="7.+Summarize+the+Entire+Process"></a>
+
+<a name="N10058"></a>
+ <a name="7.+Summarize+the+Entire+Process"></a>
+
<h3 class="h4">7. Summarize the Entire Process</h3>
+
<p>In a few sentences, remind the reader what they have just learned. This helps
to reinforce the main points of your How-To.</p>
-<a name="N1005E"></a><a name="8.+Additional+Tips+or+FAQs"></a>
+
+<a name="N1005E"></a>
+ <a name="8.+Additional+Tips+or+FAQs"></a>
+
<h3 class="h4">8. Additional Tips or FAQs</h3>
+
<p>In some cases, step-by-step instructions simply aren't enough. Use this
section to pass on any other tips or frequently asked questions. Anticipating
the needs of your readers will increase the overall success of your writing
effort.</p>
-<a name="N10064"></a><a name="9.+References"></a>
+
+<a name="N10064"></a>
+ <a name="9.+References"></a>
+
<h3 class="h4">9. References</h3>
+
<p>Remember to acknowledge any third-party resources or individuals who
contributed to the development of your How-To. Consider providing links for
those motivated readers who want to learn more.</p>
-<a name="N1006A"></a><a name="10.+Comments"></a>
+
+<a name="N1006A"></a>
+ <a name="10.+Comments"></a>
+
<h3 class="h4">10. Comments</h3>
+
<p>If you'd like to receive comments about your How-To, provide a comments
section. Include instructions and perhaps an email address if you want users to
contact you. This helps keep your How-To current and relevant for users.</p>
-<a name="N10070"></a><a name="11.+Get+some+feedback"></a>
+
+<a name="N10070"></a>
+ <a name="11.+Get+some+feedback"></a>
+
<h3 class="h4">11. Get some feedback</h3>
+
<p>Ask a few other Cocoon users to proofread your How-To. Or, post a text
version of it to the cocoon-user list, and ask for comments.</p>
-<a name="N10076"></a><a name="12.+Review+your+work"></a>
+
+<a name="N10076"></a>
+ <a name="12.+Review+your+work"></a>
+
<h3 class="h4">12. Review your work</h3>
+
<p>Consider asking someone proofread your work for embarrassing spelling or
grammatical errors. At least check your document with a spell checker before
submitting it.</p>
-<a name="N1007C"></a><a name="13.+Validate+your+How-To+document"></a>
+
+<a name="N1007C"></a>
+ <a name="13.+Validate+your+How-To+document"></a>
+
<h3 class="h4">13. Validate your How-To document</h3>
+
<p>Use the most recent version of the document dtd to validate your How-To
content. You will find it in the src/documentation/xdocs/dtd directory.</p>
-<a name="N10082"></a><a name="14.+Update+any+related+pages"></a>
+
+<a name="N10082"></a>
+ <a name="14.+Update+any+related+pages"></a>
+
<h3 class="h4">14. Update any related pages</h3>
+
<p>It would help committers if you also edited the How-To main (index.xml) and
menu (book.xml) files found at src/documentation/xdocs/howto/ to include links
to your new How-To. You can validate these files with their corresponding dtds
@@ -1345,24 +2597,44 @@
this, run the appropriate build script inside the cocoon-2.1 directory,
specifying docs as the build target. A docs build not only validates your files
but also checks for broken links.</p>
-<a name="N10088"></a><a name="15.+Prepare+any+related+patches"></a>
+
+<a name="N10088"></a>
+ <a name="15.+Prepare+any+related+patches"></a>
+
<h3 class="h4">15. Prepare any related patches</h3>
+
<p>Any new How-To file is already a patch, at least as far as Jira is concerned.
However, if you also edited the How-To main (index.xml) and menu (book.xml)
files, you will need to create a patch for them before submitting all files. If
you don't know how to create a patch, follow the instructions in
-<a href="../../2.1/howto/howto-patch.html">How to Prepare a Patch.</a>
+
+
+ <a href="../../2.1/howto/howto-patch.html">How to Prepare a Patch.</a>
+
</p>
-<a name="N10091"></a><a name="16.+Submit+via+Jira"></a>
+
+<a name="N10091"></a>
+ <a name="16.+Submit+via+Jira"></a>
+
<h3 class="h4">16. Submit via Jira</h3>
+
<p>Create an attachment for your How-To document, and submit it via Jira. If you
don't know how to submit via Jira, follow the instructions in
-<a href="../../2.1/howto/howto-bugzilla.html">How to Contribute a Patch via Jira.</a>
+
+
+ <a href="../../2.1/howto/howto-bugzilla.html">How to Contribute a Patch via Jira.</a>
+
</p>
+
</div>
-<a name="N1009A"></a><a name="Real+World+Ideas+for+How-Tos"></a>
+
+<a name="N1009A"></a>
+ <a name="Real+World+Ideas+for+How-Tos"></a>
+
<h2 class="h3">Real World Ideas for How-Tos</h2>
+
<div class="section">
+
<p>Cocoon solutions can be extended to cover many different problem domains. A
nearly unlimited number of potential How-To topics, from simple to complex, are
available right now, limited only by your imagination. Perhaps you just
@@ -1373,28 +2645,50 @@
knowledge already extend them with a more comprehensive How-To. Take a minute to
imagine how advanced the Cocoon community would become if each and every Cocoon
user took the time to contribute a single, unique How-To. Think about it.</p>
+
</div>
-<a name="N100A0"></a><a name="Frequently+Asked+Questions"></a>
+
+<a name="N100A0"></a>
+ <a name="Frequently+Asked+Questions"></a>
+
<h2 class="h3">Frequently Asked Questions</h2>
+
<div class="section">
-<a name="N100A4"></a><a name="Q.+What%27s+the+difference+between+a+How-To+and+a+tutorial%3F"></a>
+
+<a name="N100A4"></a>
+ <a name="Q.+What%27s+the+difference+between+a+How-To+and+a+tutorial%3F"></a>
+
<h3 class="h4">Q. What's the difference between a How-To and a tutorial?</h3>
+
<p>A. The goal of a How-To is to help the reader to accomplish a specific task
with clear and consise instructions. While tutorials may contain How-To-like
instructions and content, they also include additional background and conceptual
content to help teach their readers higher order concepts along the way. How-Tos
are concerned about filling an immediate, short-term need. Tutorials often
provide long-term knowledge which can be applied across a range of needs.</p>
-<a name="N100AA"></a><a name="Q.+What+spelling+convention+should+I+follow%3F"></a>
+
+<a name="N100AA"></a>
+ <a name="Q.+What+spelling+convention+should+I+follow%3F"></a>
+
<h3 class="h4">Q. What spelling convention should I follow?</h3>
+
<p>A. Use whatever spelling convention (American, British, etc.) that is most
intuitive to you. More importantly, take the time to spell check your work.</p>
+
</div>
-<a name="N100B0"></a><a name="Tips"></a>
+
+<a name="N100B0"></a>
+ <a name="Tips"></a>
+
<h2 class="h3">Tips</h2>
+
<div class="section">
-<a name="N100B4"></a><a name="Ask+for+help+when+you+need+it"></a>
+
+<a name="N100B4"></a>
+ <a name="Ask+for+help+when+you+need+it"></a>
+
<h3 class="h4">Ask for help when you need it</h3>
+
<p>Writing effectively about a "glue" framework like Cocoon, which integrates
many diverse technologies, is difficult, no doubt about it. Navigating your way
through the SVN, Jira, the patch process, as well as all of the steps of
@@ -1407,83 +2701,144 @@
others to fill down the road. This is in tune with open source, community-based
development. Contribute what you can, when you have an irresistible "itch" to
"scratch". Others will pick up where you left off.</p>
-<a name="N100BA"></a><a name="Starting+with+a+shell+document"></a>
+
+<a name="N100BA"></a>
+ <a name="Starting+with+a+shell+document"></a>
+
<h3 class="h4">Starting with a shell document</h3>
+
<p>To start your new document, make a copy of this document that you are now
reading.</p>
-<a name="N100C0"></a><a name="The+upcoming+How-To+DTD"></a>
+
+<a name="N100C0"></a>
+ <a name="The+upcoming+How-To+DTD"></a>
+
<h3 class="h4">The upcoming How-To DTD</h3>
+
<p>The document structure of Cocoon's How-To pages is likely to change soon.
Please note that this HOWTO page is likely to change as well. However, do not
worry as clever Cocoon will be able to translate the old documents to the new
structure.</p>
-<a name="N100C6"></a><a name="How+to+spell+How-To"></a>
+
+<a name="N100C6"></a>
+ <a name="How+to+spell+How-To"></a>
+
<h3 class="h4">How to spell How-To</h3>
+
<p>The Cocoon project's style convention is hyphenated words with word caps, as
in "How-To". Thanks for using the same convention in your work.</p>
+
</div>
-<a name="N100CC"></a><a name="References"></a>
+
+<a name="N100CC"></a>
+ <a name="References"></a>
+
<h2 class="h3">References</h2>
+
<div class="section">
+
<p>This is not the first, nor will it be the last, How-To on writing How-Tos.
For other ideas and opinions on the matter, check out the following sources.
</p>
+
<ul>
-
+
<li>Joel D. Canfield's
-<a class="external" href="http://www.evolt.org/article/How_To_Write_A_How_To/9741/18250/index.html">How
-to Write a How-To</a> on evolt.org.</li>
+
+ <a class="external" href="http://www.evolt.org/article/How_To_Write_A_How_To/9741/18250/index.html">How
+to Write a How-To</a> on evolt.org.
+
+ </li>
+
<li>The Linux Documentation Project's
-<a class="external" href="http://www.tldp.org/HOWTO/HOWTO-INDEX/index.html">HOWTO</a> index page
-provides many excellent How-To documents to inspire your efforts.</li>
+
+ <a class="external" href="http://www.tldp.org/HOWTO/HOWTO-INDEX/index.html">HOWTO</a> index page
+provides many excellent How-To documents to inspire your efforts.
+
+ </li>
+
</ul>
+
</div>
-<a name="N100E2"></a><a name="Comments"></a>
+
+<a name="N100E2"></a>
+ <a name="Comments"></a>
+
<h2 class="h3">Comments</h2>
+
<div class="section">
+
<p>Care to comment on this How-To? Got another tip? Help keep this How-To
relevant by passing along any useful feedback to the author,
-<a href="mailto:shannon.at.apache.org">Diana Shannon.</a>
+
+
+ <a href="mailto:shannon.at.apache.org">Diana Shannon.</a>
+
</p>
+
<div class="daisy-edit-link">
+
<p>
+
<em>Errors and Improvements?</em>
If you see any errors or potential improvements in this document
please help us:
- <a class="external" href="http://cocoon.zones.apache.org/daisy/legacydocs/628">
+
+
+ <a class="external" href="http://cocoon.zones.apache.org/daisy/legacydocs/628">
View, Edit or comment on
</a> the latest development version (registration required).
- </p>
+
+
+ </p>
+
</div>
+
</div>
+
</div>
<!--+
|end content
+-->
+
<div class="clearboth"> </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 ©
- 1999-2005 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ 1999-2005
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+
</div>
+
<div id="feedback">
Send feedback about the website to:
- <a id="feedbackto" href="mailto:dev@cocoon.apache.org?subject=[WEBSITE]%C2%A02.1/howto/howto-author-howto.html">dev@cocoon.apache.org</a>
+
+ <a id="feedbackto" href="mailto:dev@cocoon.apache.org?subject=[WEBSITE]%C2%A02.1/howto/howto-author-howto.html">dev@cocoon.apache.org</a>
+
</div>
<!--+
|end bottomstrip
+-->
+
</div>
+
</body>
+
</html>
Modified: cocoon/site/site/2.1/howto/howto-author-snippet.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/howto/howto-author-snippet.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/howto/howto-author-snippet.html (original)
+++ cocoon/site/site/2.1/howto/howto-author-snippet.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
<!--+
|alternative credits
+-->
-<div id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
</div>
<!--+
|end Menu
@@ -1333,7 +1331,7 @@
in java, XSP, and XSLT files. If your Snippet answers a FAQ, consider adding a
FAQ, with a short description and link, to serve as a gateway to your
contribution. If you don't know how, follow the instructions in
-<a href="../../2.1/howto/howto-author-faq.html">How to Author a FAQ.</a> Take a minute to imagine how
+<a href="../../2.1/howto/howto-author-faq-document.html">How to Author a FAQ.</a> Take a minute to imagine how
advanced the Cocoon community would become if each and every Cocoon user took
the time to contribute a single, unique Code Snippet. Think about it.</p>
</div>
Modified: cocoon/site/site/2.1/howto/howto-bugzilla.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/howto/howto-bugzilla.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/howto/howto-bugzilla.html (original)
+++ cocoon/site/site/2.1/howto/howto-bugzilla.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
<!--+
|alternative credits
+-->
-<div id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
</div>
<!--+
|end Menu
Modified: cocoon/site/site/2.1/howto/howto-explore-samples.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/howto/howto-explore-samples.html?rev=377949&r1=377948&r2=377949&view=diff
==============================================================================
--- cocoon/site/site/2.1/howto/howto-explore-samples.html (original)
+++ cocoon/site/site/2.1/howto/howto-explore-samples.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
<!--+
|alternative credits
+-->
-<div id="credit2">
-<a href="http://apachecon.com/"><img border="0" title="ApacheCon US 2005" alt="ApacheCon US 2005 - logo" src="http://apache.org/images/ac2005us_blue_125x125.jpg" style="width: 125px;height: 125px;"></a>
-</div>
+<div id="credit2"></div>
</div>
<!--+
|end Menu