You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lenya.apache.org by an...@apache.org on 2007/11/02 12:00:40 UTC

svn commit: r591298 [8/37] - in /lenya/sandbox/pubs/docu/content/authoring: 0033e320-8731-11dc-ae46-9e7b5d14892d/ 003a4bc0-8731-11dc-ae46-9e7b5d14892d/ 018a9980-8731-11dc-ae46-9e7b5d14892d/ 02f9e0f0-8731-11dc-ae46-9e7b5d14892d/ 043dd2a0-8731-11dc-ae46-...

Added: lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.1193910799757.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.1193910799757.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.1193910799757.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.1193910799757.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,190 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: lucene.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document> 
+
+<header> 
+    <title>Lucene</title>
+     
+     
+     
+</header> 
+<body> 
+
+<section>
+<title>Overview</title>
+<p>There are two URL for the search screen relative to your publication: 
+    <code>search-live/lucene</code> to search the live area, <code>search-authoring/lucene</code> to 
+    search the authoring area of your publication.</p>
+<p>If you want to customize the layout of  the search screen for your publication, 
+    place a stylesheet at <code>lenya/xslt/search/search-and-results.xsl</code>
+     relative to your publication root.</p>
+<p>Lucene indices are stored within the <code>work/search/index/$AREA/index</code> directory of your 
+    publication. The <code>work/search/htdocs_dump/$AREA</code> directory holds content from crawling (see below).</p>
+
+<p>The search pipelines are defined within <code>global-sitemap.xmap</code> and <code>lucene.xmap</code>
+</p>
+</section>
+
+<section>
+<title>Crawling a website</title>
+<p>
+Crawl a website by running
+</p>
+<source xml:space="preserve">
+<![CDATA[
+ant -f build/lenya/webapp/lenya/bin/crawl_and_index.xml -Dcrawler.xconf=build/lenya/webapp/lenya/pubs/default/config/search/crawler-live.xconf crawl
+]]>
+</source>
+<p>
+Note that there is a search.properties file in build/lenya/webapp/lenya/bin that you may have to change.
+crawler.xconf needs to have the following elements:
+</p>
+<source xml:space="preserve">
+<![CDATA[
+<crawler>
+  <user-agent>lenya</user-agent>
+
+  <base-url href="http://lenya.apache.org/index.html"/>
+  <scope-url href="http://lenya.apache.org/"/>
+
+  <uri-list src="work/search/lucene/uris.txt"/>
+  <htdocs-dump-dir src="work/search/lucene/htdocs_dump/lenya.apache.org"/>
+
+  <!-- <robots src="robots.txt" domain="lenya.apache.org"/> -->
+</crawler>
+]]>
+</source>
+<ul>
+    <li>user-agent is the HTTP user agent that will be used for the crawler</li>
+    <li>base-url is the start URL for the crawler</li>
+    <li>scope-url limits the scope of the crawl to that site, or subdirectory</li>
+    <li>uri-list is a reference to a file that will contain all URLs found during the crawl</li>
+    <li>htdocs-dump-dir specifies the directory that will contain the crawled site</li>
+    <li>robots specifies an (optional) robots file that follows the <a href="http://www.robotstxt.org/wc/norobots.html">Robot Exclusion Standard</a>
+</li>
+</ul>
+<p>
+If you want to fine-tune the crawling (and do not have access to the remote server to put a robots.txt there), then
+you can specify exlusions in a local robots.txt file:
+</p>
+<source xml:space="preserve">
+<![CDATA[
+# lenya.apache.org
+
+User-agent: *
+Disallow: /there_seems_to_be_a_bug_within_websphinx_Robot_Exclusion.html
+
+#Disallow:
+
+User-agent: lenya
+Disallow: /do/not/crawl/this/page.html
+]]>
+</source>
+</section>
+
+<section>
+<title>Creating an index from the command line</title>
+<source xml:space="preserve">
+<![CDATA[
+ant -f build/lenya/webapp/lenya/bin/crawl_and_index.xml -Dlucene.xconf=build/lenya/webapp/lenya/pubs/default/config/search/lucene-live.xconf index
+]]>
+</source>
+<p>
+Note that there is a search.properties file in build/lenya/webapp/lenya/bin that you may have to change.
+lucene-live.xconf has the following elements
+</p>
+<source xml:space="preserve">
+<![CDATA[
+<lucene>
+  <update-index type="new"/>
+  <!--
+  <update-index type="incremental"/>
+  -->
+
+  <index-dir src="../../work/search/lucene/index/index"/>
+    <htdocs-dump-dir src="../../work/search/lucene/htdocs_dump"/>
+
+    <indexer class="org.apache.lenya.lucene.index.DefaultIndexer"/>
+</lucene>
+]]>
+</source>
+</section>
+
+<section>
+<title>Indexing XML documents</title>
+
+<p>
+In order to index XML documents one needs to configure the <code>org.apache.lenya.lucene.index.ConfigurableIndexer</code> (see above).
+</p>
+
+<p>
+With namespaces:
+</p>
+<source xml:space="preserve">
+<![CDATA[
+<?xml version="1.0"?>
+
+<luc:document xmlns:luc="http://apache.org/cocoon/lenya/lucene/1.0">
+  <luc:field name="currwfstate" type="Text" xpath="/wf:history/wf:version[last()]/@state">
+    <namespace prefix="wf">http://apache.org/cocoon/lenya/workflow/1.0</namespace>
+  </luc:field>
+</luc:document>
+]]>
+</source>
+
+<p>
+Concatenating element values and setting default values in case element value doesn't exist:
+</p>
+<source xml:space="preserve">
+<![CDATA[
+<?xml version="1.0"?>
+
+<luc:document xmlns:luc="http://apache.org/cocoon/lenya/lucene/1.0">
+  <luc:field name="title" type="Text" xpath="/article/head/title"/>
+  <luc:field name="subtitle" type="Text" xpath="/article/head/subtitle"/>
+  <luc:field name="lead" type="UnStored" xpath="/article/head/abstract"/>
+  <luc:field name="contents" type="UnStored" xpath="/"/>
+  <luc:field name="author" type="UnStored"/>
+    <namespace prefix="lenya">http://apache.org/cocoon/lenya/page-envelope/1.0</namespace>
+    <namespace prefix="dc">http://purl.org/dc/elements/1.1/</namespace>
+    <xpath>/*/lenya:meta/dc:contributor</xpath>
+  </luc:field>
+  <luc:field name="date" type="Text">
+    <namespace prefix="lenya">http://apache.org/cocoon/lenya/page-envelope/1.0</namespace>
+    <xpath default="1969">/*/lenya:meta/year</xpath><text>.</text><xpath default="02">/*/lenya:meta/month</xpath><text>.</text><xpath default="16">/*/lenya:meta/day</xpath>
+  </luc:field>
+</luc:document>
+]]>
+</source>
+</section>
+
+<section>
+<title>Extract text from a PDF document</title>
+<source xml:space="preserve">
+<![CDATA[
+ant -f build/lenya/webapp/lenya/bin/crawl_and_index.xml -Dhtdocs.dump.dir=build/lenya/webapp/lenya/pubs/default/work/search/lucene/htdocs_dump xpdf
+]]>
+</source>
+<p>
+Also see the targets <code>pdfbox</code> and <code>pdfadobe</code>.
+</p>
+</section>
+
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Searching with Lucene</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799757.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799757.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799757.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799757.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Searching with Lucene</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/38645900-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910799757" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910770396"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781628849" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781609135"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.1193910801938.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.1193910801938.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.1193910801938.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.1193910801938.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+  http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: index.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Apache Lenya Documentation</title>
+  </header>
+  <body>
+    <p>
+      This is a Forrest Document 2.0 sample.
+    </p>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>URI Handling</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801938.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801938.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801938.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801938.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>URI Handling</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/386b36d0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910801938" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771933"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781619329" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781607178"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.1193910801331.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.1193910801331.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.1193910801331.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.1193910801331.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: URIParametrizer.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document> 
+  <header> 
+    <title>URI Parametrizer</title>
+    <version major="0" minor="1">Initial version</version>
+     
+    <notice/> 
+    <abstract>Desciption of the URI Parametrizer which is a key
+    element of the site tree framework.</abstract>
+  </header> 
+  <body> 
+
+    <section>
+      <title>Motivation</title>
+
+      <p>The problem of <a href="../publication/siteTree.html">determining the doctype</a>
+      independent of request URI needs a flexible and yet simple
+      solution. This is where the URI Parametrizer comes to the
+      rescue.</p>
+
+    </section>
+
+    <section>
+      <title>Rationale</title>
+
+      <p>The URI Parametrizer is an action which given an arbitrary
+      URI return a configurable number of parameters which it infers
+      from this URI. Typical parameters include source document type,
+      navigation location, etc. The action itself delegates to task of
+      determining the parameters to the Cocoon sitemap, i.e. the
+      parameters are determinined using the normal sitemap pipeline
+      matching mechanism.</p>
+
+      <section>
+	<title>Overview</title>
+	
+	<p>The flow of information is outlined in the following
+	diagram:</p>
+
+	<figure alt="Diagram of URIParametrizer" src="lenya-document:67cfef60-8731-11dc-ae46-9e7b5d14892d"/>
+
+      </section>
+      <section>
+	<title>Interfaces</title>
+
+	<p>The URIParametrizerAction expects an arbitrary number of
+	parameters. Each parameter contains a key value pair which
+	denotes the name of the parameter and the source. A typical
+	example is as follows:</p>
+	<source xml:space="preserve"><![CDATA[
+<map:act type="uriparametrizer">
+  <map:parameter name="doctype"
+	  value="cocoon://uri-parameter/{publication-id}/doctype"/>
+  <map:parameter name="path"
+	  value="cocoon://uri-parameter/{publication-id}/path"/>
+  <map:generate src="cocoon:/{doctype}/{path}"/>
+</map:act>
+]]></source>
+
+	<p>The <code>uri-parameter</code> prefix is a standard prefix
+	which invokes a pipeline in the root sitemap which mounts a
+	subsitemap in your publication with the name
+	<code>parameter-{parameterName}.xmap</code>.</p> 
+
+	<p>The action basically just issues a request back to cocoon
+	for each parameter. It uses the URI given in the value
+	attribute where it also adds the original request URI. So for
+	a given request URI <code>foo.html</code> and the parameters
+	given above the action basically issues to requests using the
+	<code>cocoon:</code> protocol:</p>
+	<source xml:space="preserve">
+cocoon://uri-parameter/{publication-id}/doctype/foo.html
+cocoon://uri-parameter/{publication-id}/path/foo.html</source>
+
+	<p>The matcher for uri-parameter in the root sitemap then
+	tries to mount the sitemaps
+	<code>parameter-doctype.xmap</code> and
+	<code>parameter-path.xmap</code> in the publication. Then the
+	reuest is matched against the parameter sitemap. Here's a very
+	simple example of a parameter sitemap:</p>
+
+	<source xml:space="preserve"><![CDATA[
+<?xml version="1.0"?>
+
+<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
+
+  <map:components>
+    <map:generators default="file"/>
+    <map:transformers default="xslt"/>
+    <map:readers default="resource"/>
+    <map:serializers default="html"/>
+    <map:matchers default="wildcard"/>
+    <map:actions/>
+  </map:components>
+
+  <map:views/>
+
+  <map:resources/>
+
+  <map:pipelines>
+
+    <map:pipeline>
+      
+      <map:match pattern="**">
+	<map:generate type="serverpages" src="content/parameters/doctype.xsp">
+          <map:parameter name="value" value="{1}"/>
+        </map:generate>
+	<map:serialize type="xml"/>
+      </map:match>
+      
+    </map:pipeline>
+
+  </map:pipelines>
+</map:sitemap>]]></source>
+
+	<p>A more serious example could possibly include matchers
+	using the SourceTypeAction from the Forrest Project or a
+	HashMapAction as outlined in the <a href="../publication/siteTree.html">SiteTree proposal</a>.</p>
+
+	<p>After a match has been found the pipeline in the parameter
+	sitemap returns an XML snippet in the following form:</p>
+
+	<source xml:space="preserve"><![CDATA[
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<parameter xmlns="http://apache.org/cocoon/lenya/uri-parameters/1.0">article</parameter>
+]]></source>
+
+	<p>This xml is consequently parsed by the action and returned
+	as a HashMap. Inside the action the parameters will be
+	available under the names as they were specified in the
+	parameters to the action.</p>
+      </section>
+
+      <p>The fact that the actual determination is delegated back to
+      the sitemap allows for a combination of the <a href="../publication/siteTree.html">original proposals</a> where
+      solutions such as Hashmap and SourceTypeAction were
+      outlined.</p>
+    </section>
+
+  </body> 
+  <footer> 
+    <legal>© 2003 wyona.org</legal> 
+  </footer>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>URI Parametrizer</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801331.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801331.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801331.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801331.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>URI Parametrizer</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/39b06100-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910801331" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771343"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781619238" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781607111"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.1193910785591.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.1193910785591.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.1193910785591.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.1193910785591.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: standardURI.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document> 
+  <header> 
+    <title>URI Scheme</title>
+    <version major="0" minor="2">Version 0.2</version>
+     
+    <abstract>Proposal for a standardization of URIs which are used
+      for CMS functionality. </abstract> 
+  </header> 
+  <body> 
+
+    <section>
+      <title>Introduction</title>
+      <p>We want to standardize CMS functionality across different
+      publications so that we can consolidate them in a standard root
+      sitemap.</p>
+
+      <p>In order to achieve this one precondition is to standardize
+      on the URIs how the CMS functionality is invoked.</p>
+
+      <p>There are different ways to achieve this. We either reserve
+      part of the URI space (e.g. /lenya/foo) or we reserve part of
+      the request parameter space (e.g. /foo?lenya=bar)</p>
+
+      <section>
+	<title>Dynamic URIs</title>
+
+	<p>We decided to go mostly for the second solution so that we
+	  can leave the URI space as required by the publication and use
+	  request parameters to invoke CMS actions.</p>
+
+	<p>We define two standard request parameters which we use to
+	  invoke all CMS actions in a standard way:</p>
+	<dl>
+	  <dt>
+<code>lenya.usecase</code>
+</dt>
+	  <dd>The name of the use case, e.g. "publish"</dd>
+	  <dt>
+<code>lenya.step</code>
+</dt>
+	  <dd>Each use case can have multiple steps,
+	    e.g. "showscreen"</dd> 
+	</dl>
+        <p>
+        For further information about usecases, see section <a href="usecases.html">Usecases</a>.
+        </p>
+      </section>
+      
+      <section>
+	<title>Static URIs</title>
+
+	<p>There are also some static URIs that are needed for the Lenya
+	  CMS. They are mostly internal pipelines for resources such as
+	  the menu, css or support files for Xopus and Bitflux
+	  editors.</p>
+
+	<p>There is currently no consistent standard as to under which
+	  URI space these resources should be located. Some are
+	  residing in <code>/xopus/**</code> or
+	  <code>/bitflux/**</code> and others are in
+	  <code>/lenya/**</code>.</p>
+	
+      </section>
+    </section>
+
+    <section id="uri_definition">
+      <title>URI definition</title>
+      
+      <p>Given the URI
+      <code>/lenya/computerworld/authoring/news/foo.html</code> we
+      define the following parts:</p>
+      <table>
+	<tr>
+	  <th colspan="1" rowspan="1">URI fragment</th>
+	  <th colspan="1" rowspan="1">Name</th>
+	</tr>
+	<tr>
+	  <td colspan="1" rowspan="1">lenya</td>
+	  <td colspan="1" rowspan="1">
+<code>context-prefix</code>
+</td>
+	</tr>
+	<tr>
+	  <td colspan="1" rowspan="1">computerworld</td>
+	  <td colspan="1" rowspan="1">
+<code>publication-id</code>
+</td>
+	</tr>
+	<tr>
+	  <td colspan="1" rowspan="1">authoring</td>
+	  <td colspan="1" rowspan="1">
+<code>area</code>
+</td>
+	</tr>
+	<tr>
+	  <td colspan="1" rowspan="1">news/foo</td>
+	  <td colspan="1" rowspan="1">
+<code>document-id</code>
+</td>
+	</tr>
+      </table>
+    </section>
+
+    <section>
+      <title>Static URIs</title>
+
+      <p>Currently different fragments of the URI space are reserved
+	(e.g. <code>/xopus/**</code>, <code>/bitflux/**</code> and
+	everything under <code>/lenya/**</code> that hasn't been
+	defined previously).</p>
+
+      <fixme author="ce">The reserved URI space needs to be
+      consolidated and standardized.</fixme>
+    </section>
+    
+    <section>
+      <title>Dynamic URIs</title>
+
+        <p>The dynamic URIs that are used for usecases are explained in the
+        section <a href="usecases.html">Usecases</a>.
+        </p>
+      
+    </section>
+  </body> 
+  <footer> 
+    <legal>© 200 wyona.org</legal> 
+  </footer>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>URI Scheme</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785591.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785591.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785591.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785591.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>URI Scheme</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3b1ee520-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910785591" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910770364"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781616505" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781603718"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.1193910787402.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.1193910787402.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.1193910787402.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.1193910787402.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,616 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: usecases.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document> 
+  <header> 
+    <title>Usecases</title>
+  </header> 
+  <body> 
+
+    <section>
+      <title>Introduction</title>
+      <p>
+      Usecases are sequences of pages that are orthogonal to the website,
+      i.e. they can be executed without leaving the current URI.
+      They are mainly used to execute CMS functions, e.g., to publish a page.
+      Usecases are specified by
+      </p>
+      <ul>
+      <li>a <strong>name</strong> and</li>
+      <li>a set of <strong>steps</strong>.</li>
+      </ul>
+      <p>
+      A usecase is executed using the request parameters <code>lenya.usecase</code> and
+      <code>lenya.step</code>.
+      </p>
+    </section>
+    
+    <section>
+<title>Matching Usecases</title>
+    
+    <p>
+    To match a usecase in a sitemap, the <code>WildcardRequestParameterMatcher</code>
+    is used on the <code>lenya.usecase</code> and <code>lenya.step</code> request
+    parameters. The predefined matchers have the types <code>usecase</code> and
+    <code>step</code>. A simple example of a usecase pipeline would be:
+    </p>
+<source xml:space="preserve">
+<![CDATA[<map:match type="usecase" pattern="publish">
+      
+  <!-- confirmation screen -->
+  <map:match type="step" pattern="showscreen">
+    <map:generate type="serverpages"
+        src="content/publishing/publish-screen.xsp"/>
+    <map:transform src="xslt/publishing/publish-screen.xsl"/>
+    <map:serialize/>
+  </map:match>
+
+  <!-- call publish task -->
+  <map:match type="step" pattern="publish">
+    <map:act type="task">
+      <map:parameter name="publication-id" value="{../../1}"/>
+      <map:parameter name="task-id" value="{request-param:task-id}"/>
+      <map:redirect-to uri="{request:requestURI}" session="true"/>
+    </map:act>
+  </map:match>
+        
+</map:match>]]>
+</source>
+    
+</section>
+
+<section>
+<title>The Usecase Sitemap</title>
+
+  <p>
+  The main usecase sitemap supports a set of generic usecases.
+  It is located at <code>lenya/usecase.xmap</code>.
+  To implement your publication-specific usecases or to override a generic
+  usecase, just add a <code>usecase.xmap</code>
+  sitemap to your publication directory. The Lenya usecase sitemap looks for it
+  and mounts it before the generic usecases are matched.
+  </p>
+
+</section>
+
+  <section>
+    <title>Overview of use cases</title>
+    <p>The following use cases are known:</p>
+
+    <table>
+      <tr>
+        <th colspan="1" rowspan="1">Use case</th>
+        <th colspan="1" rowspan="1">
+<code>lenya.usecase=</code>
+</th>
+        <th colspan="1" rowspan="1">
+<code>lenya.step=</code>
+</th>
+        <th colspan="1" rowspan="1">Comment</th>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Reject Approval</td>
+        <td colspan="1" rowspan="1">reject</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to reject a document from approval.</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">reject</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Submit for Approval</td>
+        <td colspan="1" rowspan="1">submit</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to submit a document to approval.</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">submit</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Archive</td>
+        <td colspan="1" rowspan="1">archive</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to archive a document.</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">archive</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Checkin</td>
+        <td colspan="1" rowspan="1">checkin</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm the checkin of this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">checkin</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Checkout</td>
+        <td colspan="1" rowspan="1">checkout</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm the checkout of this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">checkout</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Copy</td>
+        <td colspan="1" rowspan="1">copy</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to copy a document.  (The document is held in a clipboard until it is pasted again)</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">copy</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Create</td>
+        <td colspan="1" rowspan="1">create</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Show a form allowing to specify the parameters for
+        creation of a document</td> 
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">create</td>
+        <td colspan="1" rowspan="1">Create the document</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Cut</td>
+        <td colspan="1" rowspan="1">cut</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to cut a document.  (The document is held in a clipboard until it is pasted again)</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">cut</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Deactivate</td>
+        <td colspan="1" rowspan="1">deactivate</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to deactivate a document.</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">deactivate</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Delete</td>
+        <td colspan="1" rowspan="1">delete</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to delete a document.</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">delete</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Logout</td>
+        <td colspan="1" rowspan="1">logout</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm the logout</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Paste</td>
+        <td colspan="1" rowspan="1">paste</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to paste a document.  (The document which is held in a clipboard until is pasted)</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">paste</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Publish</td>
+        <td colspan="1" rowspan="1">publish</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm the publication of this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">publish</td>
+        <td colspan="1" rowspan="1">Publish this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Asset upload</td>
+        <td colspan="1" rowspan="1">aset</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Show a form allowing to specify the parameters for
+          uploading of an asset</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">upload</td>
+        <td colspan="1" rowspan="1">Upload the asset</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">insert</td>
+        <td colspan="1" rowspan="1">Insert an already uploaded asset</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">upload-and-insert</td>
+        <td colspan="1" rowspan="1">Upload and insert an asset</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">remove</td>
+        <td colspan="1" rowspan="1">Remove a previously uploaded asset</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1">Rename</td>
+        <td colspan="1" rowspan="1">rename</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Confirm to rename a document.</td>
+      </tr>
+       <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">rename</td>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Rollback</td>
+        <td colspan="1" rowspan="1">rollback</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Show a list of all versions of this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">view</td>
+        <td colspan="1" rowspan="1">View a particular version of this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">rollback</td>
+        <td colspan="1" rowspan="1">Roll back to a particular version of this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Schedule</td>
+        <td colspan="1" rowspan="1">schedule</td>
+        <td colspan="1" rowspan="1">showscreen</td>
+        <td colspan="1" rowspan="1">Show a list of all task scheduled for this document</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">add</td>
+        <td colspan="1" rowspan="1">Add a new task</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">modify</td>
+        <td colspan="1" rowspan="1">Modify an existing task</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">delete</td>
+        <td colspan="1" rowspan="1">Delete an existing task</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Edit</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1"/>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">Administration</td>
+        <td colspan="1" rowspan="1">userAddUser</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Add a user</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">userDeleteUser</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Show a form for adding users</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">userChangeProfile</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the profile of a user</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">userChangePasswordUser</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the password as a user</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">userChangePasswordAdmin</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the password as an administrator</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">userChangeGroups</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the group affiliation of a user</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">iprangeAddIPRange</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Add an IP range</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">iprangeDeleteIPRange</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Delete an IP range</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">iprangeChangeProfile</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the profile of an IP range</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">iprangeChangeGroups</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the group affiliation of an IP range</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">groupAddGroup</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Add a group</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">groupDeleteGroup</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Delete a group</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">groupChangeProfile</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the profile of a group</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">groupChangeMembers</td>
+        <td colspan="1" rowspan="1"/>
+        <td colspan="1" rowspan="1">Change the members of a group</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1">View Logs</td>
+        <td colspan="1" rowspan="1">view-logs</td>
+        <td colspan="1" rowspan="1">overview</td>
+        <td colspan="1" rowspan="1">Show the logfile list for this publication</td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"> </td>
+        <td colspan="1" rowspan="1"> </td>
+        <td colspan="1" rowspan="1">log</td>
+        <td colspan="1" rowspan="1">Show a single logfile</td>
+      </tr>
+    </table>
+
+  </section>
+
+  <section>
+    <title>Use cases</title>
+
+    <section>
+      <title>Resource upload</title>
+
+      <p>
+<code>lenya.usecase=upload</code>
+</p>
+
+      <table>
+        <tr>
+          <th colspan="1" rowspan="1">
+<code>lenya.step=</code>
+</th>
+          <th colspan="1" rowspan="1">additional parameters</th>
+          <th colspan="1" rowspan="1">sample value</th>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">showscreen</td>
+          <td colspan="1" rowspan="1">xpath</td>
+          <td colspan="1" rowspan="1">/NewsML/body.content/block[1]/*[1]</td>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">insertBefore [optional]</td>
+          <td colspan="1" rowspan="1">true</td>
+        </tr>
+
+        <tr>
+          <td colspan="1" rowspan="1">upload</td>
+          <td colspan="1" rowspan="1">documentid</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">xpath</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">insertBefore [optional]</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">uploadFile</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">identifier [optional]</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="2" rowspan="1">All Dublin core identifiers are also accepted</td>
+        </tr>
+      </table>
+    </section>
+
+    <section>
+      <title>Create</title>
+
+      <p>
+<code>lenya.usecase=create</code>
+</p>
+
+      <table>
+        <tr>
+          <th colspan="1" rowspan="1">
+<code>lenya.step=</code>
+</th>
+          <th colspan="1" rowspan="1">additional parameters</th>
+          <th colspan="1" rowspan="1">sample value</th>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">showscreen</td>
+          <td colspan="1" rowspan="1">parentid</td>
+          <td colspan="1" rowspan="1">/dossiers/2003</td>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">doctype</td>
+          <td colspan="1" rowspan="1">Dossier</td>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">create</td>
+          <td colspan="1" rowspan="1">parentid</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">childid</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1">doctype</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+      </table>
+
+    </section>
+
+    <section>
+      <title>Rollback</title>
+
+      <p>
+<code>lenya.usecase=rollback</code>
+</p>
+
+      <table>
+        <tr>
+          <th colspan="1" rowspan="1">
+<code>lenya.step=</code>
+</th>
+          <th colspan="1" rowspan="1">additional parameters</th>
+          <th colspan="1" rowspan="1">sample value</th>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">showscreen</td>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">view</td>
+          <td colspan="1" rowspan="1">version</td>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+      </table>
+    </section>
+
+    <section>
+      <title>View Logs</title>
+
+      <p>
+<code>lenya.usecase=view-logs</code>
+</p>
+
+      <table>
+        <tr>
+          <th colspan="1" rowspan="1">
+<code>lenya.step=</code>
+</th>
+          <th colspan="1" rowspan="1">additional parameters</th>
+          <th colspan="1" rowspan="1">sample value</th>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">overview</td>
+          <td colspan="1" rowspan="1"/>
+          <td colspan="1" rowspan="1"/>
+        </tr>
+        <tr>
+          <td colspan="1" rowspan="1">log</td>
+          <td colspan="1" rowspan="1">logfile</td>
+          <td colspan="1" rowspan="1">2003-05-13-18-34-00-314.xml</td>
+        </tr>
+      </table>
+    </section>
+<section>
+<title id="head-2e3e0110bd5e2eadb614e4e61873e220fc9a4f74">Usecases versus FlowScript</title>
+
+<p>The usecase concept in Lenya 1.2 is inferior to FlowScript. Lenya 2.0-dev contains a simple <a href="lenya-document:9e7b6860-8730-11dc-ae46-9e7b5d14892d"> Usecase Framework</a> for writing usecases based on flow, JX templates, and Java classes for business logic. </p>    </section>
+
+  </section>
+      
+  </body> 
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Usecases</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787402.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787402.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787402.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910787402.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Usecases</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3c5c2010-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910787402" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771445"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781626894" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781606022"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.1193910780468.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.1193910780468.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.1193910780468.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.1193910780468.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+  http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: index.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Apache Lenya Documentation</title>
+  </header>
+  <body>
+    <p>
+      This is a Forrest Document 2.0 sample.
+    </p>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Asset Management</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780468.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780468.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780468.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780468.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Asset Management</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3c62d6d0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910780468" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765870"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781625934" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605319"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.1193910793005.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.1193910793005.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.1193910793005.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.1193910793005.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: management.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Asset Management</title>
+    
+    
+    
+  </header>
+
+  <body>
+    
+    <section>
+      <title>Introduction</title>
+      <p>Asset management is the process by which assets, such as pdf
+      files or images are uploaded to the server and inserted into a
+      document.</p>
+
+      <p>Assets can be either inserted directly into a document or can
+      be uploaded for later insertion. Direct insertion happens when
+      editing the document, upload and removal can be done in the
+      asset tab in the site area.</p>
+    </section>
+
+
+    <section>
+      <title>Asset upload</title> 
+
+      <p>The upload of assets is done quite simply with a multipart
+      request. The Upload screen is generated by an xsp
+      (<code>asset.xsp</code>) which handles asset upload, image
+      upload, asset insertion and image insertion. This screen then
+      generates the multipart request which is eventually handled by
+      the <code>AssetUploadAction</code>. This action stores the asset
+      in the resources directory and generates a meta file with the
+      dublin core meta data that was passed in as request parameter or
+      with data that was extracted from the request (mime type,
+      size). Where the asset is stored is determined by the
+      <code>ResourcesManager</code>.</p>
+
+    </section>
+
+    <section>
+      <title>Asset insertion (via "enable asset upload" screen)</title> 
+
+      <p>Once the asset is uploaded, a reference to it has to be
+      inserted in the original document. Images and "plain" assets are
+      handled slighly different but the basic mechanism is the
+      same.</p>
+
+      <p>The insertion is done via an ant task
+      (<code>insert-asset</code>). This task generates a temporary
+      XSLT stylesheet using <code>generate-insertAsset-xsl.xsl</code>
+      as a meta stylesheet and an XML template which defines the XML
+      snippet that will be inserted in the refering document. The path
+      to the XML template is passed as a parameter to the ant
+      task. Usually these templates are located in
+      <code>config/asset</code>. The generated temporary stylesheet is
+      then applied to the document where the reference to the asset is
+      to be inserted. It will insert the appropriate XML snippet.</p>
+    </section>
+
+    <section>
+      <title>Asset insertion (via Bitflux editor)</title> 
+
+      <p>Images and assets can also be inserted from within the Bitflux editor.</p>
+
+      <p>The insertion is done via a XSLT stylesheet 
+      (<code>image.xsl</code> or <code>asset.xsl</code> in <code>xslt/bxe</code>). 
+      These stylesheets create a popup window that let the user select an asset or image
+      and insert it into the currently opened document via javascript.</p>
+      </section>
+
+    <section>
+      <title>Asset removal</title>
+
+      <p>Assets can be removed in the asset tab in the site area. This
+      removes the asset from the resources directory. It does not
+      however remove any references to it.</p>
+
+      <p>Removal is done with an ant task (<code>remove-asset</code>)
+      which simply deletes the asset from the resources directory.</p>
+    </section>
+
+    <section>
+      <title>Involved classes, XSPs and XSLTs</title>
+
+      <p>The following classes, XSPs and XSLTs are involved in the
+      asset upload:</p>
+      <dl>
+	<dt>src/webapp/lenya/content/authoring/asset.xsp, src/webapp/lenya/xslt/authoring/asset.xsl</dt>
+	<dd>Take care of displaying the proper asset upload
+	screen. There are different screens for image and asset upload
+	and for upload with or without subsequent insertion.</dd> 
+	<dt>org.apache.lenya.cms.cocoon.acting.UploadAction</dt>
+	<dd>Handles the upload request, stores the asset in
+	<code>resources/authoring/$document-id/$resource-name</code>,
+	and creates a file containing the dublin core meta data for
+	the asset.</dd>
+	<dt>$publication-id/config/assets/*</dt>
+	<dd>Define the XML snippets that is to be inserted in lieu of a
+	refernce to an asset.</dd>
+	<dt>src/webapp/lenya/xslt/util/generate-insertAsset-xsl.xsl</dt>
+	<dd>The meta stylesheet which generates the XSLT the will
+	insert the proper XML snippet to link to the asset in the
+	refering document.</dd>
+	<dt>$publication-id/config/tasks/targets.xml</dt>
+	<dd>Defines the <code>insert-asset</code> target which handles
+	asset insertion. Also defines the <code>remove-asset</code>
+	target.</dd> 
+	<dt>org.apache.lenya.cms.publication.ResourcesManager</dt>
+	<dd>Manages resources and hides away some of the iplementaion
+	details where resources and their meta data is stored.</dd>
+      </dl>
+    </section>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Asset Management</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793005.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793005.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793005.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910793005.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Asset Management</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3da62c40-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910793005" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766008"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781616477" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781603675"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.1193910799279.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.1193910799279.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.1193910799279.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.1193910799279.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+  http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: index.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Apache Lenya Documentation</title>
+  </header>
+  <body>
+    <p>
+      This is a Forrest Document 2.0 sample.
+    </p>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov  2 03:57:25 2007
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Link Management</value>
 </element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
 <element key="extension">
 <value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
 </element>
 <element key="resourceType">
 <value>forrestDocument20</value>

Added: lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799279.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799279.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799279.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910799279.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata xmlns="http://apache.org/lenya/metadata/1.0">
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Link Management</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>

Modified: lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3dadf470-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov  2 03:57:25 2007
@@ -1,5 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910799279" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910770144"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781623892" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781613181"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.1193910790096.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.1193910790096.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.1193910790096.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.1193910790096.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,197 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 1999-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!-- $Id: link-management.xml 55543 2004-10-26 00:14:59Z gregor $ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document>
+  <header>
+    <title>Link Management</title>
+    
+    
+    
+  </header>
+
+  <body>
+    
+    <section>
+      <title>Introduction</title>
+
+      <p>Link Managements deals with internal links, i.e. documents
+      that refer to other documents within the same publication. These
+      links might have to be changed.</p>
+      <ol>
+	<li>if a document not yet live,</li>
+	<li>if it is withdrawn from live or </li>
+	<li>if its document-id has changed because it is moved to a
+        different location within the site tree.</li>
+	<li>references in authoring have to link to documents in
+	<code>authoring</code>, however once they are published they
+	need to refer to documents in <code>live</code>
+</li>
+      </ol>
+
+      <p>These four cases have to be dealt with separately.</p>
+      <section>
+	<title>A document is not yet live</title>
+	<p>This case can happen if the user tries to publish a
+	document which has a reference to another document which has
+	not been published yet. The reference will be stale as the
+	refered document is not in the live area yet. A warning will
+	be issued during the publishing process.</p>
+      </section>
+
+      <section>
+	<title>A document is withdrawn from live</title>
+	<p>If a document which is has references to it is withdrawn
+	from the live area the references will be stale, as the
+	refered document is no longer available in the live area. A
+	warning will be issued during the deactivation process.</p>
+      </section>
+
+      <section>
+	<title>A document-id changes</title>
+	<p>If a document is moved within the site tree such that it
+	changes its document-id (e.g. cut a document and paste it
+	somewhere else in the hierarchy in the site area) then all
+	references to this document have to be changed. This is done
+	transparently in the course of the paste.</p>
+      </section>
+
+      <section>
+	<title>Rewrite internal links in live</title>
+	<p>Internal links refer to documents in authoring as long as
+	they are not published. However as soon as they are published,
+	i.e. reside in the live area their references have to go to
+	documents in the live area. A transformer takes care of
+	rewriting the internal links.</p>
+      </section>
+    </section>
+
+    <section>
+      <title>Implementation</title> <p>The implementation is pretty
+      straight-forward and is mostly handled in XSPs and associated
+      helper classes. The heavy lifting us done is the class
+      <code>Grep</code> and the helper class
+      <code>DocumentReferencesHelper</code>. The <code>Grep</code>
+      class can traverse the repository and find references to the
+      current document or can also find references from the current
+      document to other documents. A transformer
+      (SimpleLinkRewritingTransformer) is used to rewrite the internal
+      links in the live area.</p>
+
+      <note>
+        The <code>DocumentReferencesHelper</code> mimics the behaviour of
+        the <code>DefaultDocumentBuilder</code>, therefore the reference check
+        doesn't work with arbitrary <code>DocumentBuilder</code> implementations
+        (see <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37718">bug 37718</a>)
+      </note>
+      
+      <section>
+	<title>A document is not yet live</title>
+
+	<p>This is implemented as an extension to the publish xsp. It
+	  queries the <code>DocumentReferencesHelper</code> (using the
+	  <code>getInternalReferences</code> method) to ask if there
+	  are references from the current document to other documents
+	  which have not been published yet. The
+	  <code>DocumentReferencesHelper</code> in turn uses the
+	  <code>Grep#findPattern</code> method to search the current
+	  document for patterns of a reference. The pattern is defined
+	  in <code>DocumentReferencesHelper#getInternalLinkPattern</code>.</p>
+      </section>
+
+      <section>
+	<title>A document is withdrawn from live</title>
+
+	<p>This is implemented as an extension to the deactivate
+	  xsp. It queries the <code>DocumentReferencesHelper</code>
+	  (using the <code>getReferences</code> method) to ask if any
+	  other documents refer to the current document. The
+	  <code>DocumentReferencesHelper</code> in turn uses the
+	  <code>Grep#find</code> method to search the repository for
+	  documents which contain a patterns of a reference. The
+	  pattern is defined in
+	  <code>DocumentReferencesHelper#getReferencesSearchString()</code>.</p>
+      </section>
+
+      <section>
+	<title>A document-id changes</title>
+
+	<p>This is implemented with an ant task
+	  (<code>org.apache.lenya.cms.ant.LinkRewriteTask</code>)
+	  which traverses the repository and pipes all documents
+	  through an XSLT stylesheet
+	  (<code>src/webapp/lenya/xslt/util/linkRewrite.xsl</code>) to
+	  modify all references to the document that changed its
+	  document-id.
+	</p>
+      </section>
+
+      <section>
+	<title>Rewrite internal links in live</title>
+
+	<p>The
+	  <code>org.apache.lenya.cms.cocoon.transformation.SimpleLinkRewritingTransformer</code>
+	  transformer takes care of rewriting internal links to ensure
+	  they refer to the appropriate area.
+	</p>
+      </section>
+
+    </section>
+
+    <section>
+      <title>Involved classes, XSPs and XSLTs</title>
+
+      <p>The following classes, XSPs and XSLTs are involved in link
+      management:</p>
+      <dl>
+	<dt>org.apache.lenya.cms.publication.xsp.DocumentReferencesHelper</dt>
+	<dd>A helper class for the publish and deactivate
+	xsps. Defines the regular expressions for internal links. Has
+	methods to deteremine all references from the current document
+	to other documents (<code>getInternalReferences</code>) and to
+	determine all references from other documents to the current
+	document (<code>getReferences</code>).</dd>
+	<dt>org.apache.lenya.search.Grep</dt>
+	<dd>User by <code>DocumentReferencesHelper</code> to search
+	for patterns in a file or in a directory tree.</dd> 
+	<dt>org.apache.lenya.cms.ant.LinkRewriteTask</dt>
+	<dd>An ant task that upon change of a document-id pipes all
+	documents of the repository through a XSLT stylesheet which
+	rewrites internal links that were refering to the old
+	document-id to refere to the new one.</dd> 
+	<dt>org.apache.lenya.cms.cocoon.transformation.SimpleLinkRewritingTransformer</dt>
+	<dd>A transformer that rewrites internal links for the
+	appropriate area.</dd>
+	<dt>$publication-id/config/tasks/targets.xml</dt>
+	<dd>Defines the <code>move-and-rewrite</code> target which
+	handles the link rewriting in the case of a paste, i.e. when a
+	document-id has changed.</dd>  
+	<dt>src/webapp/lenya/xslt/util/linkRewrite.xsl</dt>
+	<dd>The XSLT transformation used by
+	<code>LinkRewriteTask</code> to actually rewrite the internal links.</dd>
+	<dt>src/webapp/lenya/content/publishing/screen.xsp, src/webapp/lenya/xslt/publishing/publish-screen.xsl</dt>
+	<dd>Query the <code>DocumentReferencesHelper</code> to display
+	a warning in case the current document contains references to
+	documents which have not been published yet.</dd>
+	<dt>src/webapp/lenya/content/info/deactivate.xsp, src/webapp/lenya/xslt/info/deactivate.xsl</dt>
+	<dd>Query the <code>DocumentReferencesHelper</code> to display
+	a warning in case there are links to the current document
+	which is about to be deactivated.</dd>
+      </dl>
+    </section>
+  </body>
+</document>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org