Mailing List Archive

Author: crossley
Date: Tue Feb 8 09:44:46 2011
New Revision: 1068306

URL: http://svn.apache.org/viewvc?rev=1068306&view=rev
Log:
Publish from forrestbot

Added:
forrest/site/docs_0_100/
forrest/site/docs_0_100/body-index.html (with props)
forrest/site/docs_0_100/build.html (with props)
forrest/site/docs_0_100/cap.html (with props)
forrest/site/docs_0_100/catalog.html (with props)
forrest/site/docs_0_100/changes.html (with props)
forrest/site/docs_0_100/changes.rss (with props)
forrest/site/docs_0_100/changes.xml (with props)
forrest/site/docs_0_100/dreams.html (with props)
forrest/site/docs_0_100/faq.html (with props)
forrest/site/docs_0_100/faq.xml (with props)
forrest/site/docs_0_100/glossary.html (with props)
forrest/site/docs_0_100/howto/
forrest/site/docs_0_100/howto/cvs-ssh/
forrest/site/docs_0_100/howto/cvs-ssh/howto-cvs-ssh.html (with props)
forrest/site/docs_0_100/howto/howto-asf-mirror.html (with props)
forrest/site/docs_0_100/howto/howto-buildPlugin.html (with props)
forrest/site/docs_0_100/howto/howto-corner-images.html (with props)
forrest/site/docs_0_100/howto/howto-custom-html-source.html (with props)
forrest/site/docs_0_100/howto/howto-editcss.html (with props)
forrest/site/docs_0_100/howto/howto-forrest-from-maven.html (with props)
forrest/site/docs_0_100/howto/howto-pdf-tab.html (with props)
forrest/site/docs_0_100/howto/index.html (with props)
forrest/site/docs_0_100/howto/multi/
forrest/site/docs_0_100/howto/multi/howto-multi.html (with props)
forrest/site/docs_0_100/howto/multi/step1.html (with props)
forrest/site/docs_0_100/howto/multi/step2.html (with props)
forrest/site/docs_0_100/howto/multi/step3.html (with props)
forrest/site/docs_0_100/images/
forrest/site/docs_0_100/images/dir-menu.png (with props)
forrest/site/docs_0_100/images/dir-menu2.png (with props)
forrest/site/docs_0_100/images/dir-menu3.png (with props)
forrest/site/docs_0_100/images/menu.png (with props)
forrest/site/docs_0_100/images/menu2.png (with props)
forrest/site/docs_0_100/images/menu3.png (with props)
forrest/site/docs_0_100/images/new-project.png (with props)
forrest/site/docs_0_100/images/page-areas.png (with props)
forrest/site/docs_0_100/images/snapshot-skin-pelt.png (with props)
forrest/site/docs_0_100/images/snapshot-skin-plain-dev.png (with props)
forrest/site/docs_0_100/images/snapshot-skin-tigris.png (with props)
forrest/site/docs_0_100/images/tabs.png (with props)
forrest/site/docs_0_100/index.html (with props)
forrest/site/docs_0_100/index.xml (with props)
forrest/site/docs_0_100/libre-intro.html (with props)
forrest/site/docs_0_100/linking.html (with props)
forrest/site/docs_0_100/locationmap.html (with props)
forrest/site/docs_0_100/menu-index.html (with props)
forrest/site/docs_0_100/primer.html (with props)
forrest/site/docs_0_100/project-sitemap.html (with props)
forrest/site/docs_0_100/properties.html (with props)
forrest/site/docs_0_100/searching.html (with props)
forrest/site/docs_0_100/sitemap-explain.html (with props)
forrest/site/docs_0_100/sitemap-ref.html (with props)
forrest/site/docs_0_100/skin-package.html (with props)
forrest/site/docs_0_100/skins.html (with props)
forrest/site/docs_0_100/status-themes.html (with props)
forrest/site/docs_0_100/tab-index.html (with props)
forrest/site/docs_0_100/upgrading_010.html (with props)
forrest/site/docs_0_100/validation.html (with props)
forrest/site/docs_0_100/your-project.html (with props)
forrest/site/pluginDocs/plugins_0_100/index.html (with props)
forrest/site/pluginDocs/plugins_0_100/pluginInfrastructure.html (with props)
forrest/site/pluginDocs/plugins_0_100/usingPlugins.html (with props)
forrest/site/trash/
forrest/site/trash/docs_0_50/
forrest/site/trash/docs_0_50/upgrading_05.html (with props)
forrest/site/trash/docs_0_70/
forrest/site/trash/docs_0_70/upgrading_07.html (with props)

Added: forrest/site/docs_0_100/body-index.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/body-index.html?rev=1068306&view=auto
==============================================================================
--- forrest/site/docs_0_100/body-index.html (added)
+++ forrest/site/docs_0_100/body-index.html Tue Feb 8 09:44:46 2011
@@ -0,0 +1,73 @@
+<!DOCTYPE tocitems PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<tocitems></tocitems><!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+--><meta-data></meta-data><div id="content">
+<div id="skinconf-printlink"></div>
+<div id="skinconf-xmllink"></div>
+<div id="skinconf-podlink"></div>
+<div id="skinconf-txtlink"></div>
+<div id="skinconf-pdflink"></div>
+<div id="disable-font-script"></div>
+<h1>Apache Forrest documentation</h1>
+<div id="front-matter">
+<div id="motd-page"></div>
+<div id="skinconf-toc-page"></div>
+</div>
+
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+ This is the <strong>development</strong> version of Apache Forrest.
+ Developers can obtain it from the <a href="../svn.html">Subversion</a>
+ repository.
+ See the notes for obtaining and <a href="../docs_0_100/howto/../build.html">Building Forrest</a>.
+ </div>
+</div>
+
+<p>
+ A good place to get started in our docs is the
+ <a href="../docs_0_100/your-project.html">Using Forrest</a> guide.
+ </p>
+
+<p>
+ There are some <a href="../docs_0_100/upgrading_010.html">upgrading notes</a> for people
+ updating from previous versions of Forrest, along with summaries of some
+ new features.
+ </p>
+
+<p>
+ In the <a href="../docs_0_100/howto/index.html">How-To</a> section you will find various
+ practical guides on how to achieve common objectives in Forrest.
+ </p>
+
+<p>
+ We also have a <a href="../docs_0_100/faq.html">FAQ</a> list that you should consult
+ before posting questions to our user list.
+ </p>
+
+<p>
+ The documentation <a href="../linkmap.html">Table of Contents</a> provides a
+ useful overview of the main documentation. This <a href="../docs_0_100/faq.html#docs">FAQ</a>
+ explains that there is other documentation at the example forrest
+ seed site and that each plugin has its own documentation.
+ </p>
+
+<p>
+ There are docs for <a href="../versions/index.html">other versions</a>
+ too.
+ </p>
+
+</div>

Propchange: forrest/site/docs_0_100/body-index.html
------------------------------------------------------------------------------
svn:eol-style = native

Added: forrest/site/docs_0_100/build.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/build.html?rev=1068306&view=auto
==============================================================================
--- forrest/site/docs_0_100/build.html (added)
+++ forrest/site/docs_0_100/build.html Tue Feb 8 09:44:46 2011
@@ -0,0 +1,495 @@
+<!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.10-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Building Forrest (v0.10-dev)</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 Software Foundation</a> &gt; <a href="http://forrest.apache.org/">Apache 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');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="unselected" href="../contrib.html">Developers</a>
+</li>
+<li class="current">
+<a class="selected" href="../versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="unselected" href="../pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="unselected" href="../tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs">
+<a class="unselected" href="../docs_0_90/index.html">0.90 (current)</a><a class="selected" href="../docs_0_100/index.html">0.100-dev (under development)</a><a class="unselected" href="../docs_0_80/index.html">0.80 (past)</a>
+</div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+ &nbsp;
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">0.100-dev</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/your-project.html">Using Forrest</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.3', '../skin/')" id="menu_selected_1.1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">How-To</div>
+<div id="menu_selected_1.1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.3.2', '../skin/')" id="menu_selected_1.1.3.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Install Forrest</div>
+<div id="menu_selected_1.1.3.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Building Forrest from Source</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/upgrading_010.html">Upgrading to 0.10-dev</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.4', '../skin/')" id="menu_1.1.3.4Title" class="menutitle">Customize Forrest</div>
+<div id="menu_1.1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-explain.html">Sitemaps explained</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-custom-html-source.html">Custom html source</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-editcss.html">Edit CSS (WYSIWYG)</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-pdf-tab.html" title="Generate one pdf-document for all pages of a tab">Create tab PDF</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-corner-images.html">CSS corner SVG</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.5', '../skin/')" id="menu_1.1.3.5Title" class="menutitle">Integrate Forrest with tools</div>
+<div id="menu_1.1.3.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-forrest-from-maven.html">Maven Integration</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/catalog.html">Using DTD Catalogs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.6', '../skin/')" id="menu_1.1.3.6Title" class="menutitle">Extend Forrest</div>
+<div id="menu_1.1.3.6" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-buildPlugin.html">Build a Plugin</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skin-package.html">Package new Skins</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-asf-mirror.html">Download mirror</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8', '../skin/')" id="menu_1.1.3.8Title" class="menutitle">Adding Documentation</div>
+<div id="menu_1.1.3.8" class="menuitemgroup">
+<div class="menuitem">
+<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8.2', '../skin/')" id="menu_1.1.3.8.2Title" class="menutitle">Multipage HowTo</div>
+<div id="menu_1.1.3.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/howto-multi.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step1.html">Step 1</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step2.html">Step 2</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step3.html">Step 3</a>
+</div>
+</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/faq.html">FAQs</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.5', '../skin/')" id="menu_1.1.5Title" class="menutitle">Background</div>
+<div id="menu_1.1.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/searching.html">Search Options in Forrest</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/locationmap.html">Locationmap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/properties.html">Properties system</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skins.html" title="About default skins, their naming and features">Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/status-themes.html">Dispatcher versus Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/cap.html">Sourcetype Action</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/validation.html">XML validation and entity resolution</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/glossary.html">Glossary</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8', '../skin/')" id="menu_1.1.8Title" class="menutitle">Reference docs</div>
+<div id="menu_1.1.8" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.1.8.1', '../skin/')" id="menu_1.1.8.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.1.8.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8.2', '../skin/')" id="menu_1.1.8.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.1.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.html">document-v20</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.9', '../skin/')" id="menu_1.1.9Title" class="menutitle">Older Docs</div>
+<div id="menu_1.1.9" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/dreams.html">Dream list</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/cvs-ssh/howto-cvs-ssh.html">CVS over SSH</a>
+</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">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 id="credit2">
+<a href="http://www.apache.org/events/current-event.html"><img border="0" title="ApacheCon" alt="ApacheCon - logo" src="http://www.apache.org/events/current-event-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<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>Building Forrest</h1>
+<div id="front-matter">
+<div id="motd-area">
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#getting_from_source">Getting the Forrest source</a>
+<ul class="minitoc">
+<li>
+<a href="#Step-by-step+Subversion+%28SVN%29+instructions+for+developers">Step-by-step Subversion (SVN) instructions for developers</a>
+</li>
+<li>
+<a href="#release">Sources are also available in the release</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#building">Building and installing Forrest</a>
+</li>
+<li>
+<a href="#run">Run Forrest, run!</a>
+</li>
+</ul>
+</div>
+</div>
+
+<a name="getting_from_source"></a>
+<h2 class="underlined_10">Getting the Forrest source</h2>
+<div class="section">
+<a name="Step-by-step+Subversion+%28SVN%29+instructions+for+developers"></a>
+<h3 class="underlined_5">Step-by-step Subversion (SVN) instructions for developers</h3>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+ If you are behind a proxy, see
+ <a href="http://subversion.tigris.org/project_faq.html#proxy" rel="nofollow">this
+ FAQ</a>.
+ </div>
+</div>
+<ol>
+
+<li>Make sure you have a recent release of a
+ <a href="http://subversion.tigris.org/" rel="nofollow">Subversion</a>
+ client installed and properly configured.</li>
+
+<li>Read the ASF notes about source repositories and
+ <a href="http://www.apache.org/dev/version-control.html">version control</a>
+ and see Forrest's developer notes about our
+ <a href="../svn.html">SVN</a>.
+ </li>
+
+<li>At a command prompt, enter
+ '<span class="codefrag">svn co http://svn.apache.org/repos/asf/forrest/trunk forrest</span>'
+ (committers should replace <span class="codefrag">http</span> with <span class="codefrag">https</span>).</li>
+
+<li>This will create a directory called "<span class="codefrag">forrest</span>" where the Forrest source will be stored.</li>
+
+<li>Pay attention to README.txt and LICENSE.txt and NOTICE.txt files.</li>
+
+</ol>
+<p>
+ Whenever you want to update your Forrest source tree to the current
+ version, change to the top-level "<span class="codefrag">forrest</span>" directory and
+ invoke '<span class="codefrag">svn update</span>'.
+ </p>
+<p>
+ To see what changes you've made, invoke '<span class="codefrag">svn status</span>'
+ </p>
+<p>
+ SVN is really powerful. See
+ <a href="http://svnbook.red-bean.com/" rel="nofollow">Version Control with
+ Subversion</a> - the opensource SVN book.
+ </p>
+<a name="release"></a>
+<h3 class="underlined_5">Sources are also available in the release</h3>
+<p>
+ Each release of forrest contains a copy of all sources as at the time
+ of the release. So the building instructions below do apply to that.
+ Of course the svn method described above will provide the most up-to-date
+ version for developers.
+ </p>
+</div>
+
+<a name="building"></a>
+<h2 class="underlined_10">Building and installing Forrest</h2>
+<div class="section">
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+ This document applies to this specific version. See other
+ instructions for the
+ <a href="http://forrest.apache.org/docs/dev/build.html">development</a>
+ version.
+ </div>
+</div>
+<p>
+ To build Forrest, change directory to '<span class="codefrag">forrest/main</span>', and
+ then type '<span class="codefrag">build</span>' on Windows or '<span class="codefrag">./build.sh</span>'
+ on Unix. (Requires Java 1.5) If everything is successful, you should see
+ a message similar to:
+ </p>
+<pre class="code">
+ *-----------------------------------------------------------------
+ | Installation notice
+ *-----------------------------------------------------------------
+ | You have built the X.Y-dev version of Forrest.
+ | Please set the environment variable FORREST_HOME point to
+ | /svn/forrest
+ | It is recommended to add
+ | unix: $FORREST_HOME/bin: to your $PATH
+ | win: %FORREST_HOME%\bin; to your %PATH%
+ | Then do 'forrest -projecthelp' to list options for the 'forrest' command
+ | More help at http://forrest.apache.org/
+ *-----------------------------------------------------------------
+ </pre>
+<p>
+ As the message says, you need to add the distribution's
+ <span class="codefrag">bin/</span> ("binary") directory to your PATH variable, so the
+ <span class="codefrag">'forrest'</span> command is available everywhere:
+ </p>
+<pre class="code">
+[~]$ cd /path/to/svn/forrest
+[/svn/forrest]$ export FORREST_HOME=`pwd`
+[/svn/forrest]$ export PATH=$PATH:$FORREST_HOME/bin
+ </pre>
+<div class="warning">
+<div class="label">Warning</div>
+<div class="content">
+ After updating the Forrest source from SVN, if there have been certain
+ types of updates (e.g. Java sources, supporting libraries, build system,
+ etc.) you will need to clean and build forrest again. Do 'cd
+ forrest/main; build clean; build".
+ </div>
+</div>
+</div>
+
+<a name="run"></a>
+<h2 class="underlined_10">Run Forrest, run!</h2>
+<div class="section">
+<p>
+ Forrest is now ready to go. To view and edit the local copy of Forrest
+ core documentation, cd to site-author and do '<span class="codefrag">forrest run</span>'
+ to see the local webapp using the bundled Jetty server. Edit something
+ in content/xdocs/*.xml see the immediate effect.
+ </p>
+<p>
+ The document <a href="../docs_0_100/your-project.html">Using Forrest</a> is your
+ next step.
+ </p>
+</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-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
+<br>
+ Apache Forrest, Forrest, Apache, the Apache feather logo, and the Apache Forrest
+ logos are trademarks of The Apache Software Foundation.
+ </div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>

Propchange: forrest/site/docs_0_100/build.html
------------------------------------------------------------------------------
svn:eol-style = native

Added: forrest/site/docs_0_100/cap.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/cap.html?rev=1068306&view=auto
==============================================================================
--- forrest/site/docs_0_100/cap.html (added)
+++ forrest/site/docs_0_100/cap.html Tue Feb 8 09:44:46 2011
@@ -0,0 +1,474 @@
+<!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.10-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<title>SourceTypeAction (content aware pipelines) (v0.10-dev)</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 Software Foundation</a> &gt; <a href="http://forrest.apache.org/">Apache 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');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="unselected" href="../contrib.html">Developers</a>
+</li>
+<li class="current">
+<a class="selected" href="../versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="unselected" href="../pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="unselected" href="../tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs">
+<a class="unselected" href="../docs_0_90/index.html">0.90 (current)</a><a class="selected" href="../docs_0_100/index.html">0.100-dev (under development)</a><a class="unselected" href="../docs_0_80/index.html">0.80 (past)</a>
+</div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+ &nbsp;
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">0.100-dev</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/your-project.html">Using Forrest</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3', '../skin/')" id="menu_1.1.3Title" class="menutitle">How-To</div>
+<div id="menu_1.1.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.2', '../skin/')" id="menu_1.1.3.2Title" class="menutitle">Install Forrest</div>
+<div id="menu_1.1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/build.html" title="Build and install the current unreleased version">Building Forrest from Source</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/upgrading_010.html">Upgrading to 0.10-dev</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.4', '../skin/')" id="menu_1.1.3.4Title" class="menutitle">Customize Forrest</div>
+<div id="menu_1.1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-explain.html">Sitemaps explained</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-custom-html-source.html">Custom html source</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-editcss.html">Edit CSS (WYSIWYG)</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-pdf-tab.html" title="Generate one pdf-document for all pages of a tab">Create tab PDF</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-corner-images.html">CSS corner SVG</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.5', '../skin/')" id="menu_1.1.3.5Title" class="menutitle">Integrate Forrest with tools</div>
+<div id="menu_1.1.3.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-forrest-from-maven.html">Maven Integration</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/catalog.html">Using DTD Catalogs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.6', '../skin/')" id="menu_1.1.3.6Title" class="menutitle">Extend Forrest</div>
+<div id="menu_1.1.3.6" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-buildPlugin.html">Build a Plugin</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skin-package.html">Package new Skins</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-asf-mirror.html">Download mirror</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8', '../skin/')" id="menu_1.1.3.8Title" class="menutitle">Adding Documentation</div>
+<div id="menu_1.1.3.8" class="menuitemgroup">
+<div class="menuitem">
+<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8.2', '../skin/')" id="menu_1.1.3.8.2Title" class="menutitle">Multipage HowTo</div>
+<div id="menu_1.1.3.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/howto-multi.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step1.html">Step 1</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step2.html">Step 2</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step3.html">Step 3</a>
+</div>
+</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/faq.html">FAQs</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.5', '../skin/')" id="menu_selected_1.1.5Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Background</div>
+<div id="menu_selected_1.1.5" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/searching.html">Search Options in Forrest</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/locationmap.html">Locationmap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/properties.html">Properties system</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skins.html" title="About default skins, their naming and features">Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/status-themes.html">Dispatcher versus Skins</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Sourcetype Action</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/validation.html">XML validation and entity resolution</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/glossary.html">Glossary</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8', '../skin/')" id="menu_1.1.8Title" class="menutitle">Reference docs</div>
+<div id="menu_1.1.8" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.1.8.1', '../skin/')" id="menu_1.1.8.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.1.8.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8.2', '../skin/')" id="menu_1.1.8.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.1.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.html">document-v20</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.9', '../skin/')" id="menu_1.1.9Title" class="menutitle">Older Docs</div>
+<div id="menu_1.1.9" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/dreams.html">Dream list</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/cvs-ssh/howto-cvs-ssh.html">CVS over SSH</a>
+</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">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 id="credit2">
+<a href="http://www.apache.org/events/current-event.html"><img border="0" title="ApacheCon" alt="ApacheCon - logo" src="http://www.apache.org/events/current-event-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<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>SourceTypeAction (content aware pipelines)</h1>
+<div id="front-matter">
+<div id="motd-area">
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Configuration">Configuration</a>
+</li>
+<li>
+<a href="#Usage">Usage</a>
+</li>
+</ul>
+</div>
+</div>
+
+<a name="Introduction"></a>
+<h2 class="underlined_10">Introduction</h2>
+<div class="section">
+<p>
+ SourceTypeAction assigns a "type" (a string) to an XML file. This is
+ done based on information occuring in the header of the XML file, up to
+ the document (root) element. This type is then returned to the sitemap
+ as a variable with the name 'sourcetype'. If no matching sourcetype
+ could be be found, null is returned and thus the contents of the action
+ element will not be executed.
+ </p>
+<p>
+ SourceTypeAction works by pull-parsing the document and collecting
+ information such as the Public Id, the processing instructions, the
+ document element local name and namespace, and the xsi:schemaLocation
+ and xsi:noNamespaceSchemaLocation attributes. This information is then
+ compared with the rules described in the configuration of the
+ SourceTypeAction.
+ </p>
+</div>
+
+<a name="Configuration"></a>
+<h2 class="underlined_10">Configuration</h2>
+<div class="section">
+<p>
+ The action should be declared and configured in the map:actions section
+ of your sitemap. Example:
+ </p>
+<pre class="code">
+&lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;
+ &lt;map:components&gt;
+ &lt;...&gt;<strong>
+&lt;map:actions&gt;
+ &lt;map:action name="sourcetype"
+ src="org.apache.forrest.sourcetype.SourceTypeAction"&gt;
+ &lt;sourcetype name="download-v1.0"&gt;
+ &lt;document-declaration
+ public-id="-//Acme//DTD Download Documentation V1.0//EN" /&gt;
+ &lt;/sourcetype&gt;
+ &lt;/map:action&gt;
+ &lt;/map:actions&gt;</strong>
+
+ &lt;/map:components&gt;
+ &lt;...&gt;
+&lt;/map:sitemap&gt;
+ </pre>
+<p>
+ There are other examples in <span class="codefrag">main/webapp/forrest.xmap</span>
+
+</p>
+<p>
+ Each sourcetype-tag declares a source type. Inside the sourcetype-tag a
+ number of rules can be defined, described below. The sourcetypes will be
+ checked in the same order as they are defined in the configuration, the
+ first sourcetype of which all rules match will be used.
+ </p>
+<p>
+ These are the available rules:
+ </p>
+<dl>
+
+<dt>document-declaration</dt>
+
+<dd>This rule checks the public ID. It takes one attribute
+ <span class="codefrag">public-id</span>.</dd>
+
+<dt>document-element</dt>
+
+<dd>This rule checks the local name and/or namespace of the document
+ element. These are specified with the attributes <span class="codefrag">local-name</span> and
+ <span class="codefrag">namespace</span>. At least one of these two is required.</dd>
+
+<dt>processing-instruction</dt>
+
+<dd>This rule checks a processing instruction. It can take two
+ attributes: <span class="codefrag">target</span> and <span class="codefrag">data</span>. The target attribute is
+ always required, the data attribute is optional.</dd>
+
+<dt>w3c-xml-schema</dt>
+
+<dd>This rule checks the value of the xsi:schemaLocation and
+ xsi:noNamespaceSchemaLocation attributes on the document element. These are
+ specified with the attributes <span class="codefrag">schema-location</span> and
+ <span class="codefrag">no-namespace-schema-location</span>.</dd>
+
+</dl>
+<p>
+ Perhaps you need other methods. Please enhance the source at
+ <span class="codefrag">main/java/org/apache/forrest/sourcetype</span>
+
+</p>
+</div>
+
+<a name="Usage"></a>
+<h2 class="underlined_10">Usage</h2>
+<div class="section">
+<p>
+ The source of which the sourcetype must be defined must be specified
+ using the 'src' attribute on the map:act element.
+ </p>
+<pre class="code">
+&lt;map:act type="sourcetype" src="{1}"&gt;
+...
+&lt;/map:act&gt;
+ </pre>
+<p>
+ See a real-life example in the advanced section of the
+ <a href="your-project.html#adding_new_content_type_2">Using
+ Forrest</a> document.
+ </p>
+</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-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
+<br>
+ Apache Forrest, Forrest, Apache, the Apache feather logo, and the Apache Forrest
+ logos are trademarks of The Apache Software Foundation.
+ </div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>

Propchange: forrest/site/docs_0_100/cap.html
------------------------------------------------------------------------------
svn:eol-style = native

Added: forrest/site/docs_0_100/catalog.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/catalog.html?rev=1068306&view=auto
==============================================================================
--- forrest/site/docs_0_100/catalog.html (added)
+++ forrest/site/docs_0_100/catalog.html Tue Feb 8 09:44:46 2011
@@ -0,0 +1,626 @@
+<!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.10-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Using Catalog Entity Resolver for local DTDs (v0.10-dev)</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 Software Foundation</a> &gt; <a href="http://forrest.apache.org/">Apache 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');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="unselected" href="../contrib.html">Developers</a>
+</li>
+<li class="current">
+<a class="selected" href="../versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="unselected" href="../pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="unselected" href="../tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs">
+<a class="unselected" href="../docs_0_90/index.html">0.90 (current)</a><a class="selected" href="../docs_0_100/index.html">0.100-dev (under development)</a><a class="unselected" href="../docs_0_80/index.html">0.80 (past)</a>
+</div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+ &nbsp;
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">0.100-dev</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/your-project.html">Using Forrest</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.3', '../skin/')" id="menu_selected_1.1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">How-To</div>
+<div id="menu_selected_1.1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.2', '../skin/')" id="menu_1.1.3.2Title" class="menutitle">Install Forrest</div>
+<div id="menu_1.1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/build.html" title="Build and install the current unreleased version">Building Forrest from Source</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/upgrading_010.html">Upgrading to 0.10-dev</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.4', '../skin/')" id="menu_1.1.3.4Title" class="menutitle">Customize Forrest</div>
+<div id="menu_1.1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-explain.html">Sitemaps explained</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-custom-html-source.html">Custom html source</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-editcss.html">Edit CSS (WYSIWYG)</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-pdf-tab.html" title="Generate one pdf-document for all pages of a tab">Create tab PDF</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-corner-images.html">CSS corner SVG</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.3.5', '../skin/')" id="menu_selected_1.1.3.5Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Integrate Forrest with tools</div>
+<div id="menu_selected_1.1.3.5" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-forrest-from-maven.html">Maven Integration</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Using DTD Catalogs</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.6', '../skin/')" id="menu_1.1.3.6Title" class="menutitle">Extend Forrest</div>
+<div id="menu_1.1.3.6" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-buildPlugin.html">Build a Plugin</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skin-package.html">Package new Skins</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-asf-mirror.html">Download mirror</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8', '../skin/')" id="menu_1.1.3.8Title" class="menutitle">Adding Documentation</div>
+<div id="menu_1.1.3.8" class="menuitemgroup">
+<div class="menuitem">
+<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8.2', '../skin/')" id="menu_1.1.3.8.2Title" class="menutitle">Multipage HowTo</div>
+<div id="menu_1.1.3.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/howto-multi.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step1.html">Step 1</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step2.html">Step 2</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step3.html">Step 3</a>
+</div>
+</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/faq.html">FAQs</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.5', '../skin/')" id="menu_1.1.5Title" class="menutitle">Background</div>
+<div id="menu_1.1.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/searching.html">Search Options in Forrest</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/locationmap.html">Locationmap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/properties.html">Properties system</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skins.html" title="About default skins, their naming and features">Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/status-themes.html">Dispatcher versus Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/cap.html">Sourcetype Action</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/validation.html">XML validation and entity resolution</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/glossary.html">Glossary</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8', '../skin/')" id="menu_1.1.8Title" class="menutitle">Reference docs</div>
+<div id="menu_1.1.8" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.1.8.1', '../skin/')" id="menu_1.1.8.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.1.8.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8.2', '../skin/')" id="menu_1.1.8.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.1.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.html">document-v20</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.9', '../skin/')" id="menu_1.1.9Title" class="menutitle">Older Docs</div>
+<div id="menu_1.1.9" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/dreams.html">Dream list</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/cvs-ssh/howto-cvs-ssh.html">CVS over SSH</a>
+</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">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 id="credit2">
+<a href="http://www.apache.org/events/current-event.html"><img border="0" title="ApacheCon" alt="ApacheCon - logo" src="http://www.apache.org/events/current-event-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<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>Using Catalog Entity Resolver for local DTDs</h1>
+<div id="front-matter">
+<div id="motd-area">
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#overview">Overview</a>
+</li>
+<li>
+<a href="#config">General configuration notes</a>
+</li>
+<li>
+<a href="#tools">Configuring specific tools</a>
+<ul class="minitoc">
+<li>
+<a href="#system">Operating system catalog</a>
+</li>
+<li>
+<a href="#xmllint">xmllint validating parser</a>
+</li>
+<li>
+<a href="#vim">Vim</a>
+</li>
+<li>
+<a href="#emacs">Emacs</a>
+</li>
+<li>
+<a href="#onsgmls">onsgmls validating parser</a>
+</li>
+<li>
+<a href="#jedit">jEdit - Open Source programmer's text editor</a>
+</li>
+<li>
+<a href="#oxygenxml">oXygen XML Editor</a>
+</li>
+<li>
+<a href="#xmlspy">xmlspy</a>
+</li>
+<li>
+<a href="#xxe">XMLmind XML Editor (XXE)</a>
+<ul class="minitoc">
+<li>
+<a href="#XXE+v2.5p2+or+older">XXE v2.5p2 or older</a>
+</li>
+<li>
+<a href="#XXE+v2.5p3%2B">XXE v2.5p3+</a>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<a href="#info">Further information and resources</a>
+</li>
+</ul>
+</div>
+</div>
+
+<a name="overview"></a>
+<h2 class="underlined_10">Overview</h2>
+<div class="section">
+<p>
+ This is a collection of notes for configuring the Catalog Entity
+ Resolver with your favourite XML tools (validating parsers and editors).
+ </p>
+<p>
+ All XML documents declare their ruleset - the Document Type Definition
+ (DTD). When Forrest processes the documents, it uses the Resolver to
+ find Forrest's local copies of the DTDs, rather than trundling out onto
+ the network.
+ </p>
+<p>
+ Many Java-based XML tools already have an entity resolver, probably the
+ same one that Forrest uses. Many non-Java tools also have an entity
+ resolver. To use these tools with documents based on the Forrest DTDs,
+ you need to configure the tools.
+ </p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+ The information provided here is not intended to endorse any particular
+ tool.
+ </div>
+</div>
+<p>
+ If you have any other configuration tips for a particular tool, then
+ please send them to the forrest-dev mailing list.
+ </p>
+</div>
+
+<a name="config"></a>
+<h2 class="underlined_10">General configuration notes</h2>
+<div class="section">
+<p>
+ The Forrest DTDs and supporting resources are in the Forrest
+ distribution at <span class="codefrag">main/webapp/resources/schema/</span>
+
+</p>
+<p>
+ Usually all that is required is to direct your tool to the "catalog"
+ supplied by Forrest at either:
+ <span class="codefrag">$FORREST_HOME/main/webapp/resources/schema/catalog.xcat</span>
+ (for XML Catalog) or
+ <span class="codefrag">$FORREST_HOME/main/webapp/resources/schema/catalog</span> (for TR
+ 9401 Catalog).
+ </p>
+</div>
+
+<a name="tools"></a>
+<h2 class="underlined_10">Configuring specific tools</h2>
+<div class="section">
+<a name="system"></a>
+<h3 class="underlined_5">Operating system catalog</h3>
+<p>
+ Some operating systems already provide a system-wide catalog that is
+ used by many tools. This is usually located at
+ <span class="codefrag">/etc/xml/catalog</span> or at
+ <span class="codefrag">/usr/share/sgml/catalog</span> files.
+ </p>
+<p>
+ For an XML Catalog, add this line:
+ </p>
+<pre class="code">
+
+&lt;nextCatalog
+catalog="/usr/local/svn/forrest/main/webapp/resources/schema/catalog.xcat"/&gt;
+
+ </pre>
+<p>
+ For a TR 9401 Catalog, add this line:
+ </p>
+<pre class="code">
+
+CATALOG \
+"/usr/local/svn/forrest/main/webapp/resources/schema/catalog"
+
+ </pre>
+<p>
+ Actually you probably do not want to touch that system catalog, so
+ rather create your own catalog file in your home directory which
+ refers to both the Forrest catalog and your system catalog.
+ </p>
+<a name="xmllint"></a>
+<h3 class="underlined_5">xmllint validating parser</h3>
+<p>
+ "xmllint" is part of the "libxml2" package. It is very fast and
+ powerful, with are many facilities. It can validate whole directories
+ of files at once. Set the SGML_CATALOG_FILES environment variable.
+ </p>
+<pre class="code">
+export SGML_CATALOG_FILES=$SGML_CATALOG_FILES:\
+$FORREST_HOME/main/webapp/resources/schema/catalog
+xmllint --valid --catalogs --noout mydoc.xml
+ </pre>
+<a name="vim"></a>
+<h3 class="underlined_5">Vim</h3>
+<p>
+ The following .vimrc entries are useful:
+ </p>
+<pre class="code">
+au FileType xml set efm=%A%f:%l:\ %.%#error:\ %m,%-Z%p^,%-C%.%#
+au FileType xml set makeprg=xmllint\ --noout\ --valid\ --catalogs\ %
+ </pre>
+<p>
+ See other notes about using
+ <a href="http://www.pinkjuice.com/howto/vimxml/" rel="nofollow">Vim as XML
+ editor</a>.
+ </p>
+<a name="emacs"></a>
+<h3 class="underlined_5">Emacs</h3>
+<p>
+ See <a href="http://www.thaiopensource.com/nxml-mode/" rel="nofollow">nXML
+ mode</a> and
+ <a href="http://www.dpawson.co.uk/relaxng/nxml/" rel="nofollow">FAQ</a>.
+ </p>
+<a name="onsgmls"></a>
+<h3 class="underlined_5">onsgmls validating parser</h3>
+<p>
+ "onsgmls" is part of the "Open SP" package. You need to also tell it
+ where to find an "SGML declaration". The easiest way is to create your
+ own little "my-catalog" file, containing this:
+ </p>
+<pre class="code">
+SGMLDECL "/usr/share/sgml/xml.dcl"
+CATALOG \
+"/usr/local/svn/forrest/main/webapp/resources/schema/catalog"
+ </pre>
+<p>
+ Then point the parser at it:
+ </p>
+<pre class="code">
+onsgmls -c path/to/my-catalog -wall -wxml -s mydoc.xml
+ </pre>
+<a name="jedit"></a>
+<h3 class="underlined_5">jEdit - Open Source programmer's text editor</h3>
+<pre class="code">
+
+Select the menu:
+Utilities &gt; Global Options &gt; Plugins:XML &gt; Catalogs
+Select the "+" button, and use the "File System Browser"
+to specify the TR9401 Catalog file:
+"forrest/main/webapp/resources/schema/catalog"
+
+ </pre>
+<pre class="code">
+
+On version 4.2. Select the menu:
+Plugins &gt; Plugins Options &gt; Plugins:XML &gt; Catalogs
+Select the "+" button, and use the "File System Browser"
+to specify the TR9401 Catalog file:
+"forrest/main/webapp/resources/schema/catalog"
+
+ </pre>
+<a name="oxygenxml"></a>
+<h3 class="underlined_5">oXygen XML Editor</h3>
+<pre class="code">
+
+Select the menu:
+Options &gt; Preferences &gt; XML Catalog
+Specify the XML Catalog file:
+"forrest/main/webapp/resources/schema/catalog.xcat"
+
+ </pre>
+<a name="xmlspy"></a>
+<h3 class="underlined_5">xmlspy</h3>
+<pre class="code">
+
+Add the following entry to the file CustomCatalog.xml
+(located in XMLSpy install directory):
+
+&lt;nextCatalog
+catalog="file://localhost/C:/apache/forrest/main/webapp/
+resources/schema/catalog.xcat"/&gt;
+
+ </pre>
+<a name="xxe"></a>
+<h3 class="underlined_5">XMLmind XML Editor (XXE)</h3>
+<a name="XXE+v2.5p2+or+older"></a>
+<h4>XXE v2.5p2 or older</h4>
+<pre class="code">
+
+Select the menu:
+Options &gt; Options &gt; Schema &gt; Add File
+Specify the XML Catalog file:
+"forrest/main/webapp/resources/schema/catalog.xcat"
+
+ </pre>
+<a name="XXE+v2.5p3%2B"></a>
+<h4>XXE v2.5p3+</h4>
+<p>
+ XXE supports catalogs by automatic detection via configuration
+ files. Download the
+ <a href="http://www.splike.com/howtos/xxe_forrest.html" rel="nofollow">XXE
+ Forrest Config</a> files from splike.com; this also add support
+ for WYSIWYG editing of forrest documents. Note: This configuration
+ suite has recently been added to the Forrest scratchpad.
+ </p>
+</div>
+
+<a name="info"></a>
+<h2 class="underlined_10">Further information and resources</h2>
+<div class="section">
+<p>
+ Forrest and Cocoon use the
+ <a href="http://xml.apache.org/commons/components/resolver/">Catalog
+ Entity Resolver</a> that is provided by the
+ <a href="http://xml.apache.org/commons/">Apache XML Commons</a>
+ project. The resolver is packaged with the Forrest distribution at
+ <span class="codefrag">lib/core/xml-commons-resolver-x.y.jar</span>
+
+</p>
+<p>
+ Other Forrest documentation has some notes about configuring the entity
+ resolver for your own DTDs. See <a href="../docs_0_100/validation.html">XML
+ Validation</a>.
+ </p>
+<p>
+ Cocoon has extensive documentation about the entity resolver. See
+ <a href="http://cocoon.apache.org/2.1/userdocs/concepts/catalog.html">Entity resolution with catalogs</a>.
+ </p>
+</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-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
+<br>
+ Apache Forrest, Forrest, Apache, the Apache feather logo, and the Apache Forrest
+ logos are trademarks of The Apache Software Foundation.
+ </div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>

Propchange: forrest/site/docs_0_100/catalog.html
------------------------------------------------------------------------------
svn:eol-style = native