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

svn commit: r591298 [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-...

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:ah@wyona.org">ah@wyona.org</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>



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