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

[email protected]
Newsgroups gmane.comp.cms.lenya.cvs
Message-ID <[email protected]>
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>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.