svn commit: r591298 [9/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]>
Modified: lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3ef03870-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/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790096.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790096.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790096.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790096.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/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3ef03870-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3ef03870-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="1193910790096" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910763541"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781625339" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781604799"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.1193910801884.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.1193910801884.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.1193910801884.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.1193910801884.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/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3f0287f0-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>Meta Data</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/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801884.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801884.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801884.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910801884.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>Meta Data</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/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/3f0287f0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/3f0287f0-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="1193910801884" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771903"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781617328" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781604552"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.1193910795106.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.1193910795106.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.1193910795106.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.1193910795106.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,131 @@
+<?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: metadata.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>Meta Data</title>
+    
+    
+    
+  </header>
+
+  <body>
+    
+    <section>
+      <title>Introduction</title>
+
+      <p>Meta data is kept directly inside the xml document. It is
+      based on the <a href="http://dublincore.org">Dublin Core</a>
+      standard.</p>
+
+      <p>There are basically three use cases:</p>
+      <ol>
+	<li>Create Meta Data</li>
+	<li>Display Meta Data</li>
+	<li>Modify Meta Data</li>
+      </ol>
+
+    </section>
+
+    <section>
+      <title>Implementation</title> 
+
+      <p/>
+
+      <section>
+	<title>Create Meta Data</title>
+
+	<p>Upon creation of a document a sample is copied from the
+	sample doctype directory. This sample already contains some
+	sample meta data. The creator then applies an XSLT
+	transformation to this sample which adapts the sample values
+	to the values suplied in the creator request. This values are
+	partially filled in by the user (subject, desciption, etc.)
+	and partly by the system (creator, creation data). This is
+	done in the <code>create</code> ant task which at the end
+	invokes an xslt task which applies the
+	<code>addMetaData.xsl</code> stylesheet which adapts the meta
+	data according to the request values.</p>
+
+      </section>
+
+      <section>
+	<title>Display Meta Data</title>
+
+	<p>The display of meta data is handled by the <code>meta.xsp</code> xsp.</p>
+
+      </section>
+
+      <section>
+	<title>Modify Meta data</title>
+
+	<p>The modification of meta data is handled in the
+	<code>info.xmap</code> sitemap. The matcher makes sure to
+	check the document out before the modification and checking it
+	back in after the modification. This is done using the
+	<code>ReservedCheckoutTestAction</code> and
+	<code>ReservedCheckinAction</code>.  If there is an error the
+	request is redirected to the meta data screen which displays a
+	warning saying that the checkout or checkin failed and who was
+	locking the document since what date and time.</p>
+
+	<p>Once the document is checked out the modifications are
+	applied with the help of an ant task. There is a target named
+	<code>save-meta-data</code> which simply invokes the ant task
+	<code>WriteDCParametersTask</code>.  This task saves the meta
+	data using the <code>DublinCore</code> interface.</p>
+
+      </section>
+    </section>
+
+    <section>
+      <title>Involved classes, XSPs and XSLTs</title>
+
+      <p>The following classes, XSPs and XSLTs are involved in meta
+      data handling:</p>
+      <dl>
+	<dt>org.apache.lenya.cms.ant.WriteDCParametersTask</dt>
+	<dd>A simple ant task which saves the meta data which is
+	  passed as arguments to file using the
+	<code>DublinCore</code> class.</dd>
+	<dt>$publication-id/config/tasks/targets.xml</dt>
+	<dd>Defines the <code>save-meta-data</code> target which
+	handles saving of meta data with the help of the
+	<code>WriteDCParametersTask</code> ant task. Also defines
+	the <code>create</code> target which is used create new
+	documents and to change the meta data according to the request
+	values from the creation request.</dd>
+	<dt>org.apache.lenya.cms.publication.DublinCore</dt>
+	<dd>A simple interface to save and retrieve dublin core meta
+	data.</dd>
+	<dt>org.apache.lenya.cms.cocoon.acting.ReservedCheckoutTestAction</dt>
+	<dd>Action that tests if a document can be checked out and if
+	yes does check it out (See <a href="../revisioncontrol/revisioncontroller.html">Revision Controller</a>).</dd>
+	<dt>org.apache.lenya.cms.cocoon.acting.ReservedCheckinAction</dt>
+	<dd>Action that checks a document in (See <a href="../revisioncontrol/revisioncontroller.html">Revision Controller</a>).</dd>
+	<dt>src/webapp/lenya/content/info/meta.xsp, src/webapp/lenya/xslt/info/info.xsl</dt>
+	<dd>Handle the display of the meta data in the info area. This
+	is also a form which can be used to modify the meta data via a
+	POST request.</dd>
+	<dt>src/webapp/lenya/xslt/authoring/addMetaData.xsl</dt>
+	<dd>Simple XSLT stylesheet that modifies the meta data
+	according to the input parameters.</dd>
+      </dl>
+    </section>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/403bf250-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>Meta Data 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/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795106.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795106.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795106.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795106.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>Meta Data 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/403bf250-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/403bf250-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/403bf250-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="1193910795106" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910767040"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781621672" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781610474"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.1193910795567.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.1193910795567.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.1193910795567.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.1193910795567.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/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/40428200-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>Multilingual Documents</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/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795567.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795567.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795567.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910795567.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>Multilingual Documents</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/40428200-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/40428200-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/40428200-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="1193910795567" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910767698"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781626731" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605757"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.1193910786056.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.1193910786056.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.1193910786056.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.1193910786056.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,223 @@
+<?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: multilingual.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>Mulitilingual Document handling</title>
+    
+    
+    
+  </header>
+
+  <body>
+    
+    <section>
+      <title>Introduction</title>
+
+      <p>Mulitilingual Document handling deals with documents of
+      different languages. This affects virtually every part of Lenya,
+      namely many aspects of work flow such as creation, publication,
+      deactivation, deletion. It also affects access control, meta
+      data, etc.</p>
+
+      <p>The multilingual capabilities are not a mandatory feature of
+      Lenya. You can easily create monolingual publication by simply
+      replacing a few properties in
+      <code>publication.xconf</code>.</p>
+
+      <p>The multilingual capabilities are deeply ingrained in the
+      core of Lenya and as such a conceptual overview has to delve
+      into many areas of Lenya. The main parts of the multilingual
+      capabilities are as follows:</p>
+
+      <dl>
+	<dt>Site tree</dt>
+	<dd>The <a href="../publication/siteTree.html">site
+	tree</a> contains information about documents. It has been
+	expanded to also contain information about different language
+	versions of the same document. Different language versions of
+	the same document share the same
+	<code>document-id</code>.</dd>
+
+	<dt>Default language</dt> 
+	<dd>A publication has a default language. This is the language
+	in which the document is created. However it is not
+	necessarily the case that there is always a document version
+	in the default language as the user is allowed to remove any
+	language version even the one for the default language.<br/>
+	If you specify an URL without a language suffix you are
+	redirected to the default language document.</dd>
+
+	<dt>publication.xconf</dt>
+	<dd>This is where the available languages and the default
+	language are specified.</dd>
+
+	<dt>page-envelope</dt> 
+	<dd>The <a href="../publication/pageenvelopemodule.html">page
+	envelope</a> exports document specific information such as
+	document-id via an input module. Naturally language specific
+	information for the current document is also available via the
+	page envelope.
+	</dd>
+
+	<dt>Redirection</dt>
+	<dd>If you request a document <code>foo.html</code> in a
+	multilingual publication you will internally be redirected to
+	<code>foo_en.html</code> if "en" is the default language.</dd>
+
+	<dt>Special cases</dt>
+	<dd>Some special care has to be taken when removing language
+	versions. The current implementation does not allow the user
+	to remove all language versions of a document. There always
+	has to be at least one language version.
+	</dd>
+      </dl>
+
+
+    </section>
+
+    <section>
+      <title>Implementation</title>
+
+      <p/>
+
+      <section>
+	<title>Site tree</title>
+
+	<p>The site tree contains nodes for each document. Each node
+	can contain multiple <code>label</code> nodes for each
+	language version of the document.</p>
+
+	<source xml:space="preserve"><![CDATA[
+<node id="doctypes">
+	<label xml:lang="de">Dokumenttypen</label>
+	<label xml:lang="en">Document types</label>
+	<node id="1column">
+		<label xml:lang="de">1 Spalte</label>
+	</node>
+</node>
+]]></source>
+
+	<p>The classe <code>SiteTree</code> and
+	<code>SiteTreeNode</code> provide interfaces to the nodes and
+	the corresponding label nodes.</p>
+
+      </section>
+
+      <section>
+	<title>publication.xconf</title>
+
+	<p>The <code>languages</code> node in
+	<code>publication.xconf</code> defines the languages that are
+	available for this publication and also defines the default language.</p>
+	<source xml:space="preserve"><![CDATA[
+<languages>
+  <language default="true">de</language>
+  <language>en</language>
+</languages>
+]]></source>
+
+	<p>This information is available via the
+	<code>Publication</code> class
+	(<code>getDefaultLanguage()</code> and
+	<code>getLanguages()</code> methods).</p>
+      </section>
+
+      <section>
+	<title>page-envelope</title>
+
+	<p>The <a href="../publication/pageenvelopemodule.html">page-envelope
+	input module</a> exports language related information,
+	namely <code>default-language</code>,
+	<code>document-label</code>, <code>document-language</code>,
+	<code>document-languages</code> and
+	<code>document-languages-csv</code>.</p>
+      </section>
+
+      <section>
+	<title>Redirection</title>
+
+	<p>The <code>DefaultDocumentBuilder</code> which implements the
+	<code>DocumentBuilder</code> interface, takes care of
+	redirecting language agnostic URLs (such as
+	<code>foo.html</code>) to language aware links
+	(<code>foo_en.html</code>), i.e. language agnostic links are
+	redirected to the language aware link with the default language.</p>
+      </section>
+
+      <section>
+	<title>Addition and removal</title>
+
+	<p>More language versions are added with the "Create new
+	language version" screen. Existing language versions can be
+	removed with the "Remove Language" screen. These screens are
+	generated by <code>create-language.xsp</code>,
+	<code>create-language.xsl</code>, <code>removelabel.xsp</code>
+	and <code>removelabel.xsl</code>.</p>
+
+	<p>The creation of a new language version is done via the
+	<code>create-language</code> target which uses the
+	<code>InsertLabelTask</code> ant task to insert a label in the
+	site tree.</p>
+
+	<p>The removal of a language version is done via the
+	<code>remove-language</code> target, which uses the
+	<code>RemoveLabelTask</code> ant task (which removes the label
+	from the site tree).</p>
+      </section>
+    </section>
+
+    <section>
+      <title>Involved classes, XSPs and XSLTs</title>
+
+      <p>The following classes, XSPs and XSLTs are involved in
+      multilingual document handling:</p>
+      <dl>
+	<dt>org.apache.lenya.cms.publication.SiteTree and org.apache.lenya.cms.publication.SiteTreeNode</dt>
+	<dd>These interfaces provide acces to the label nodes.</dd>
+	<dt>org.apache.lenya.cms.publication.Publication</dt>
+	<dd>Provides access to the default language and to all
+	available languages.</dd>
+	<dt>org.apache.lenya.cms.publication.PageEnvelope</dt>
+	<dd>Exports language related information such as
+	<code>default-language</code>, <code>document-language</code>,
+	etc.</dd>
+	<dt>org.apache.lenya.cms.publication.DefaultDocumentBuilder</dt>
+	<dd>Builds a document with the given language. The default
+	implementation also takes care of redirecting
+	<code>foo.html</code> to <code>foo_en.html</code>.</dd>
+<!-- 	FIXME: move this to the core -->
+	<dt>$publication-id/lenya/content/authoring/create-language.xsp,
+	$publication-id/lenya/xslt/authoring/create-language.xsl
+	</dt>
+	<dd>Generate the "Create new language version" screen.</dd>
+	<dt>src/webapp/lenya/content/authoring/removelabel.xsp, src/webapp/lenya/xslt/authoring/removelabel.xsl
+	</dt>
+	<dd>Generate the "Remove Language" screen.</dd>
+	<dt>org.apache.lenya.cms.ant.InsertLabelTask</dt>
+	<dd>Ant task to add a label to the site tree.</dd>
+	<dt>org.apache.lenya.cms.ant.RemoveLabelTask</dt>
+	<dd>Ant task to remove a label from the site tree.</dd>
+	<dt>$publication-id/config/tasks/targets.xml</dt>
+	<dd>Defines the <code>create-language</code> and the
+	<code>remove-language</code> target which
+	handle the addition and removal of language versions of a document.</dd>  
+      </dl>
+    </section>
+  </body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/41795450-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>Multilingual Document 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/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910786056.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910786056.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910786056.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910786056.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>Multilingual Document 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/41795450-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/41795450-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/41795450-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="1193910786056" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910770536"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781617631" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605008"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.1193910777059.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.1193910777059.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.1193910777059.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.1193910777059.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/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/417e8470-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>Tasks</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/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910777059.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910777059.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910777059.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910777059.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>Tasks</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/417e8470-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/417e8470-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/417e8470-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="1193910777059" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910763526"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781630791" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781610070"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.1193910780736.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.1193910780736.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.1193910780736.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.1193910780736.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,49 @@
+<?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: concept.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>The Task Concept</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<p>
+In Lenya CMS, a <strong>task</strong> is used to implement a process
+which can be invoked by the user. Tasks are triggered
+from the sitemap using a <a href="taskaction.html">
+<code>TaskAction</code>
+</a>
+or <a href="scheduling.html">scheduled</a> using a <code>TaskJob</code>.
+</p>
+<p>
+Typical tasks are
+</p>
+<ul>
+  <li>publishing a page,</li>
+  <li>exporting a page to a live server,</li>
+  <li>manipulating a file,</li>
+  <li>sending an e-mail, or</li>
+  <li>creating a backup of your site.</li>
+</ul>
+
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/42d16a40-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>The Task Concept</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/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780736.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780736.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780736.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780736.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>The Task Concept</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/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/42d16a40-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/42d16a40-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="1193910780736" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765992"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633386" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781611765"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.1193910782313.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.1193910782313.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.1193910782313.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.1193910782313.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,158 @@
+<?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: defining.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>Defining Tasks</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<p>
+All tasks to be used in a publication must be declared in the file
+<code>[publication-directory]/content/tasks.xconf</code>.
+A typical task configuration file looks like follows:
+</p>
+<source xml:space="preserve"><![CDATA[
+
+<?xml version="1.0"?>
+<tasks>
+
+  <!-- publish page -->
+  <task id="publish">
+    <label>Publish</label>
+    <task id="publish" class="org.lenya.cms.publishing.DefaultFilePublisher">
+      <parameter name="live-path" value="content/live"/>
+      <parameter name="tree-live-path" value="content/live/tree.xml"/>
+    </task>
+    <task id="export" class="org.lenya.cms.publishing.StaticHTMLExporter">
+      <parameter name="export-path" value="resources/export/pending"/>
+      <parameter name="substitute-regexp" value="s/\/lenya\/your-publication//g"/>
+    </task>
+  </task>
+</tasks>
+
+]]></source>
+<p>
+Every task must have a unique <code>id</code> attribute. This identifier is
+used to address the task from the sitemap.
+Every top-level task must have a child element <code>&lt;label&gt;</code>. The
+content of this element is used, e. g., by the scheduler to let the user choose
+a task from a list. The actual implementation of a task is identified using the
+<code>class</code> attribute.
+</p>
+
+<section>
+<title>Parameters</title>
+<p>
+Usually, a task needs some parameters to be executed properly.
+There are two possibilities to pass parameters to a task:</p>
+<ol>
+  <li>
+    You can define all parameters or a subset of them in the <code>tasks.xconf</code> file.
+  </li>
+  <li>
+    The remainig parameters can be handled to the <code>TaskAction</code> or the
+    <code>TaskJob</code> that executes the task. Request parameters always have a higher
+    priority than parameters from the <code>tasks.xconf</code> file.
+  </li>
+</ol>
+<p>
+To simplifiy the passing of parameters to tasks, the <code>TaskAction</code> and
+<code>TaskJob</code> objects create some default parameters based on
+the request and session objects:</p>
+<ul>
+  <li>
+    <code>Task.PARAMETER_SERVLET_CONTEXT</code> - the path of the servlet context<br/>
+    <code>/home/user_id/build/jakarta-tomcat/webapps/lenya</code>
+  </li>
+  <li>
+    <code>Task.PARAMETER_SERVER_URI</code> - the server URI<br/>
+    <code>http://www.yourhost.com:8080/lenya/publication/index.html</code>
+  </li>
+  <li>
+    <code>Task.PARAMETER_SERVER_PORT</code> - the server port<br/>
+    <code>http://www.yourhost.com:8080/lenya/publication/index.html</code>
+  </li>
+  <li>
+    <code>Task.PARAMETER_CONTEXT_PREFIX</code> - the part of the URI that precedes the publication ID<br/>
+    <code>http://www.yourhost.com:8080/lenya/publication/index.html</code>
+  </li>
+  <li>
+    <code>Task.PARAMETER_PUBLICATION_ID</code> - the publication ID<br/>
+    <code>http://www.yourhost.com:8080/lenya/publication/index.html</code>
+  </li>
+</ul>
+</section>
+
+<section>
+<title>Task Sequences</title>
+<p>
+Tasks can be nested using so-called <em>task sequences</em>. Sub-tasks of other
+tasks don't need to have <code>&lt;label&gt;</code> elements because they can't
+be addressed independently. Whenever a task sequence is executed, all sub-tasks
+are executed in the same order as they are declared.
+</p>
+<p>
+When you group tasks, the enclosing <code>&lt;task&gt;</code> element does not
+need a <code>&lt;class&gt;</code> attribute. If you omit it, the <code>TaskSequence</code>
+class is used as default. If you want to implement your own task grouping
+mechanism using a subclass of <code>TaskSequence</code>, you can append a
+class attribute.
+</p>
+<p>
+All parameters that are passed to a TaskSequence are forwarded to all tasks
+in the sequence. By creating a subclass of <code>TaskSequence</code> you could implement
+a parameter selection mechanism, e. g. using namespace prefixes.
+</p>
+</section>
+
+<section>
+<title>Assigning Tasks to Document Types</title>
+<p>
+Every document type can support a set of tasks. The labels of these tasks
+are displayed on the scheduler screen of a document of this type.
+To assign a task to a document type, you have to edit the file
+<code>[publication-directory]/config/doctypes/doctypes.xconf</code>:
+</p>
+<source xml:space="preserve"><![CDATA[
+
+<doctypes>
+  <doc type="Simple-Document">
+    <tasks>
+      <task id="publish"/>
+      <task id="backup"/>
+      ...
+    </tasks>
+  </doc>
+  ...
+</doctypes>
+
+]]></source>
+<p>
+You can associate every task with an arbitrary number of document types.
+</p>
+
+</section>
+
+
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/4403cfc0-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>Defining Tasks</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/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910782313.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910782313.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910782313.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910782313.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>Defining Tasks</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/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/4403cfc0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/4403cfc0-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="1193910782313" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910767559"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633323" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781611661"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.1193910789447.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.1193910789447.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.1193910789447.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.1193910789447.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,124 @@
+<?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: taskaction.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>The TaskAction: Triggering a Task from the Sitemap</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<section>
+<title>Declaring the Action</title>
+<p>
+To invoke a task from a sitemap pipeline, you use a <code>TaskAction</code>. The
+task ID is handled to the action by a <code>task</code> parameter:
+</p>
+
+<source xml:space="preserve"><![CDATA[
+
+<map:components>
+  ...
+  <map:actions>
+    <map:action name="publisher"
+                src="org.lenya.cms.cocoon.acting.TaskAction">
+      <task id="publish"/>
+    </map:action>
+  </map:actions>
+  ...
+</map:components>
+
+]]></source>
+<p>
+The <code>TaskAction</code> collects the request parameters and forwards them
+to the task.
+</p>
+<source xml:space="preserve"><![CDATA[
+
+<map:match pattern="lenya/publish*">
+  <map:act type="publisher">
+    <map:redirect-to uri="{parent_uri}" session="true"/>
+  </map:act>
+  <map:redirect-to uri="publishScreen?status=failed" session="true"/>
+</map:match>
+
+]]></source>
+
+<p>
+You can also pass the task ID as a <code>task-id</code> parameter directly in the pipeline:
+</p>
+
+<source xml:space="preserve"><![CDATA[
+
+
+<map:actions>
+  <map:action name="task" src="org.lenya.cms.cocoon.acting.TaskAction"/>
+</map:actions>
+
+...
+
+<map:match pattern="lenya/publish*">
+  <map:act type="task">
+    <map:parameter name="task-id" value="publish-article"/>
+    <map:redirect-to uri="{parent_uri}" session="true"/>
+  </map:act>
+  <map:redirect-to uri="publishScreen?status=failed" session="true"/>
+</map:match>
+
+]]></source>
+
+</section>
+
+<section>
+<title>Scheduling a Task</title>
+<p>
+See section <strong>Scheduler</strong>.
+</p>
+</section>
+
+<section>
+<title>Developing Your Own Tasks</title>
+
+<p>
+Every task must implement the <code>org.lenya.cms.task.Task</code> interface.
+</p>
+<p>
+The easiest way to develop your own task is to extend the <code>AbstractTask</code> class.
+Its <code>parameterize()</code> method simply replaces old parameter values with new
+ones. All you have to do is implementing the <code>execute(String contextPath)</code>
+method.
+</p>
+<p>
+You may wonder why we pass the <code>contextPath</code> as a method parameter
+since we already pass it as a task parameter. This ensures that the task is always
+able to access the Lenya CMS directory, even if it is not created by a <code>TaskAction</code>
+or a <code>TaskJob</code>. Furthermore, if you enter a task in the <code>jobs.xml</code>
+file manually, you won't have to provide a hard-coded <code>servlet-context</code> parameter.
+</p>
+<p>
+<strong>This feature may be subject to changes. If you have any suggestions to improve
+the task implementation, just contact me (Andreas Hartmann) at</strong>
+<a href="mailto:[email protected]">[email protected]</a>.
+</p>
+</section>
+
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/452aeaa0-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>The TaskAction</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/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910789447.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910789447.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910789447.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910789447.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>The TaskAction</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/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/452aeaa0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/452aeaa0-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="1193910789447" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910762339"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781626307" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605554"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.1193910790993.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.1193910790993.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.1193910790993.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.1193910790993.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,37 @@
+<?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: scheduling.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>Scheduling a Task</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<section>
+<title>Scheduling a Task</title>
+<p>
+See section <strong>Scheduler</strong>.
+</p>
+</section>
+
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/468dd600-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>Scheduling a Task</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/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790993.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790993.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790993.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910790993.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>Scheduling a Task</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/468dd600-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/468dd600-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/468dd600-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="1193910790993" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910764342"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781628031" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781607356"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.1193910785276.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.1193910785276.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.1193910785276.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.1193910785276.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/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/469465b0-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>Included tasks</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/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785276.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785276.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785276.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910785276.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>Included tasks</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/469465b0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/469465b0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/469465b0-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="1193910785276" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910769674"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781620384" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781608671"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.1193910783649.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.1193910783649.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.1193910783649.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.1193910783649.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,194 @@
+<?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: anttask.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>The AntTask</title>
+     
+     
+     
+</header> 
+<body> 
+
+<p>
+The <code>org.apache.lenya.cms.task.AntTask</code> class can be used to invoke targets
+of an Ant project.
+</p>
+
+<section>
+<title>Task Parameters</title>
+<p>
+The task parameters are:
+</p>
+<ul>
+  <li>
+<strong>
+<code>publication-id</code>
+</strong>: The publication ID</li>
+  <li>
+<strong>
+<code>buildfile (optional)</code>
+</strong>: The location of the build file
+      relative to the publication directory. If this parameter is
+      not provided, the file is loaded from the default location (see section <a href="#File+Locations">File Locations</a>).</li>
+  <li>
+<strong>
+<code>target (optional)</code>
+</strong>: The build target. If this parameter
+      is not provided, the default target is executed.</li>
+  <li>
+<strong>
+<code>properties.*</code>
+</strong>: The project properties.</li>
+  <li>
+<strong>
+<code>ant.*</code>
+</strong>: The command-line parameters for Ant <strong>(not implemented yet!)</strong>
+</li>
+</ul>
+</section>
+
+<section>
+<title>Logging</title>
+
+<p>
+Every time an <code>AntTask</code> is invoked, a log file is created unsing
+the <code>XmlLogger</code>
+(<a href="http://ant.apache.org/manual/listeners.html">manual entry</a>,
+<a href="http://issues.apache.org/gump/javadoc/ant/build/javadocs/org/apache/tools/ant/XmlLogger.html">JavaDoc</a>).
+For the location of the log files, see section <a href="#File+Locations">File Locations</a>.
+The log history can be viewed at the URI
+</p>
+<source xml:space="preserve">
+http://.../&lt;publication&gt;/logs/tasks/index.html
+</source>
+</section>
+
+<section>
+<title>Writing AntTask Buildfiles</title>
+<p>
+Any Ant project file can be used as a buildfile for the <code>AntTask</code>.
+There is one implicit property that is always set when an
+<code>AntTask</code> is executed:
+</p>
+<ul>
+  <li>
+<strong>
+<code>pub.dir</code>
+</strong>: The absolute path of publication directory.</li>
+</ul>
+<p>
+The runtime properties of the target can be set using task parameters
+with the prefix <code>properties</code>, e. g. <code>properties.filename</code>
+for a buildfile property named <code>filename</code>.
+</p>
+</section>
+
+<section>
+<title>Using custom Ant Tasks</title>
+<p>
+The implementation of custom Ant tasks is described in the
+<a href="http://ant.apache.org/manual/index.html">Ant User Manual</a>.
+If you want to write a general Lenya task, put it into the package
+<code>org.lenya.cms.ant</code>. If you want to write a task
+that is only suited for your publication, put it in the
+<code>&lt;publication&gt;/java/src/</code> directory.
+</p>
+</section>
+
+<section>
+<title>File Locations</title>
+
+<p>Default buildfile location:</p>
+<source xml:space="preserve">&lt;publication&gt;/config/tasks/targets.xml</source>
+
+<p>Log files:</p>
+<source xml:space="preserve">&lt;publication&gt;/logs/tasks/*.xml</source>
+
+<p>Log file presentation stylesheets:</p>
+<source xml:space="preserve">&lt;webapp&gt;/lenya/xslt/logs/*.xsl</source>
+</section>
+
+<section>
+<title>Example</title>
+
+<p>
+The following buildfile contains the target <code>publish</code>
+that can be invoked using the <code>AntTask</code>:
+</p>
+<source xml:space="preserve">
+<![CDATA[<project name="Example Project" default="publish" basedir=".">
+
+  <!-- implicit properties (set by the AntTask) -->
+  <property name="pub.dir" value=""/>
+
+  <!-- publishing properties -->
+  <property name="authoring.dir" value="content/authoring"/>
+  <property name="live.dir" value="content/live"/>
+  <property name="publish.sources" value=""/>
+
+  <target name="publish">
+    <echo>Publish: Copying files from ${authoring.dir} to ${live.dir}</echo>
+    <copy todir="${pub.dir}/${live.dir}">
+      <fileset dir="${pub.dir}/${authoring.dir}">
+        <include name="${publish.sources}"/>
+      </fileset>
+    </copy>
+  </target>
+
+</project>]]>
+</source>
+
+<p>
+You define the task in your <code>tasks.xconf</code> file:
+</p>
+<source xml:space="preserve">
+<![CDATA[<task id="ant" class="org.lenya.cms.task.AntTask"/>]]>
+</source>
+
+<p>
+To invoke the task from your sitemap, you have to define an appropriate
+<code>TaskAction</code> instance:
+</p>
+<source xml:space="preserve">
+<![CDATA[<map:action name="publish"
+    src="org.lenya.cms.cocoon.acting.TaskAction">
+  <task id="ant"/>
+</map:action>]]>
+</source>
+
+<p>
+You call the action in a pipeline:
+</p>
+<source xml:space="preserve">
+<![CDATA[<map:match pattern="publish.html">
+  <map:act type="publish">
+    ...
+  </map:act>
+</map:match>]]>
+</source>
+
+<p>And finally, go to your browser and call the URI with the appropriate
+parameter(s):</p>
+<source xml:space="preserve">http://.../publish.html?properties.publish.sources=test.xml</source>
+
+</section>
+
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/47e305c0-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>AntTask</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/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783649.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783649.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783649.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783649.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>AntTask</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/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/47e305c0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/47e305c0-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="1193910783649" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910768455"/>
 <CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781626033" version="1"/>
 <CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605340"/>
 </XPSRevisionControl>

Added: lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.1193910787081.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.1193910787081.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.1193910787081.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.1193910787081.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,97 @@
+<?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: publisher.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>The DefaultFilePublisher Task</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<p>
+The DefaultFilePublisher is a task that copies XML source files from
+the authoring directory to another location, usually the live directory.
+It needs the following parameters:
+</p>
+<ul>
+ <li>
+<strong>publication-id</strong>: the publication identifier</li>
+ <li>
+<strong>authoring-path</strong>: the authoring path</li>
+ <li>
+<strong>tree-authoring-path</strong>: the location of the <code>tree.xml</code> file</li>
+ <li>
+<strong>live-path</strong>: the live path</li>
+ <li>
+<strong>tree-live-path</strong>: the location of the <code>tree.xml</code> file</li>
+ <li>
+<strong>sources</strong>: a comma-separated list of files to publish</li>
+</ul>
+<p>
+All paths are relative to the publication directory. Usually, the path information is read
+from the <code>[publication-directory]/config/publishing/publisher.xconf</code> file:
+</p>
+<source xml:space="preserve"><![CDATA[
+
+<publication>
+  <authoring>
+    <documents href="content/authoring"/>
+    <tree href="content/authoring/tree.xml"/>
+  </authoring>
+  <live>
+    <documents href="content/live"/>
+    <tree href="content/live/tree.xml"/>
+  </live>
+  ...
+</publication>
+
+]]></source>
+
+<p>
+You can override the paths in the task configuration file <code>tasks.xconf</code>,
+e. g. to use several publishers to publish into different directories:
+</p>
+
+<source xml:space="preserve"><![CDATA[
+
+<tasks>
+
+  <task id="publish-test" class="org.apache.lenya.cms.publishing.DefaultFilePublisher">
+    <label>Publish</label>
+    <parameter name="live-path" value="content/live-test"/>
+    <parameter name="tree-live-path" value="content/live-test/tree.xml"/>
+  </task>
+  
+  <task id="publish-real" class="org.apache.lenya.cms.publishing.DefaultFilePublisher">
+    <label>Publish</label>
+    <parameter name="live-path" value="content/live"/>
+    <parameter name="tree-live-path" value="content/live/tree.xml"/>
+  </task>
+
+</tasks>
+
+]]></source>
+<p>
+The remaining parameters, <code>publication-id</code> and <code>sources</code>, are
+passed to the task as request parameters.
+</p>
+</body>
+</document>

Modified: lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/490b0b00-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/490b0b00-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>DefaultFilePublisher</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>
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.