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 [6/37] - in /lenya/sandbox/pubs/docu/content/authoring: 0033e320-8731-11dc-ae46-9e7b5d14892d/ 003a4bc0-8731-11dc-ae46-9e7b5d14892d/ 018a9980-8731-11dc-ae46-9e7b5d14892d/ 02f9e0f0-8731-11dc-ae46-9e7b5d14892d/ 043dd2a0-8731-11dc-ae46-...

Added: lenya/sandbox/pubs/docu/content/authoring/24406720-8731-11dc-ae46-9e7b5d14892d/en.1193910787564.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/24406720-8731-11dc-ae46-9e7b5d14892d/en.1193910787564.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/24406720-8731-11dc-ae46-9e7b5d14892d/en.1193910787564.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/24406720-8731-11dc-ae46-9e7b5d14892d/en.1193910787564.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,238 @@
+<?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: kupu.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>Kupu</title>
+</header> 
+<body> 
+
+<p>Kupu is a browser based WYSIWYG XHTML editor which is developed independently of Lenya by  <a href="http://www.oscom.org/">OSCOM</a>
+ and is available at <a href="http://kupu.oscom.org/"> http://kupu.oscom.org/</a>. Kupu can and actually is being used in other projects as well, that have nothing to do with 
+ Java, XML or the Apache software stack. Lenya is just prepared for the Kupu Editor to be plugged in, and ships with Kupu pre-installed. </p>
+
+<section>
+<title id="head-9b4594a57c32f9b79007a4319d02bc57c1656c90">Kupu as a sample for integrating editors in general</title>
+
+<p>Understanding the Kupu integration in Lenya is helpful to understand how editors are integrated into Lenya at all. This knowledge is
+ important if you are looking into changing the way Kupu is used inside Lenya or if you are thinking about taking any other editor and integrate it in Lenya. </p>
+
+</section>
+<section>
+<title id="head-cb7dd8a2b1dc471e0805416826a330e77b1cce07">What integrating an editor is all about</title>
+
+<p>From the user's perspective using an editor in Lenya works like this: </p>
+<ol>
+<li>
+<p>Navigate to the item that is to be edited </p>
+</li>
+<li>
+<p>Click on a link to start the editing process (mostly from a pull-down menu, but there are other options) </p>
+
+</li>
+<li>
+<p>Edit </p>
+</li>
+<li>
+<p>Save </p>
+</li>
+<li>
+<p>Enjoy the changes </p>
+</li>
+</ol>
+<p>The link to start the editing is nohting but a GET request to an editing usecase. (See: [<a href="http://wiki.apache.org/lenya/CreatePageWalkthrough">CreatePageWalkthrough</a>]
+ for some background on Usecases). The reply to that request is the page that contains the editor with the to be edited file loaded. 
+ As simple as that sounds, there is a number of things Lenya has to go through. </p>
+<p>Between Step 2. and 3. (the user clicking on 'Edit' and the editor showing up) Lenya has to </p>
+
+<ol>
+<li>
+<p>Make sure the editor is installed at all </p>
+</li>
+<li>
+<p>Determine the file to be edited </p>
+</li>
+<li>
+<p>Make sure editing is allowed (i.e. the file is not checked out reserved by someone else) </p>
+</li>
+<li>
+<p>Aggregate the content that is to be edited, the editor part of the page itself and whatever parameter the editor needs and serve it to the browser. </p>
+</li>
+</ol>
+<p>Between Step 3. and 4. (Edit and Save) Lenya has to  </p>
+<ol>
+
+<li>
+<p>Make sure the file is still checked out so it can be edited </p>
+</li>
+<li>
+<p>Extract the edited page content from the HTTP POST </p>
+</li>
+<li>
+<p>Save the edited file </p>
+</li>
+<li>
+<p>Check in the edited file </p>
+</li>
+<li>
+<p>Trigger and workflow events on the document that belong to the "edit" event. </p>
+</li>
+</ol>
+<p>
+<em>Note: Kupu allows the user to Save in between and continue editing. This is achieved by using HTTP POST operations. Thus Lenya needs to be prepared to 
+receive multiple updates of the same page and save it before the user might click on 'Exit and Save' so that Step 5 (Display the changed page) is finally triggered.</em> </p>
+
+</section>
+<section>
+<title id="head-e5a2711688441b7644fbdb11a61307c04fbf2061">The Kupu usecase pipeline in detail</title>
+<section>
+<title id="head-42ce962db03bd610fa943bc40b509ba6985810fd">step="open"</title>
+
+
+<source xml:space="preserve">
+        &lt;map:match pattern="kupu" type="usecase"&gt;
+          &lt;map:match pattern="open" type="step"&gt;
+            &lt;map:match pattern="*/authoring/**.html"&gt;
+
+              &lt;!-- Check for Kupu--&gt;
+              &lt;map:act type="resource-exists" src="resources/kupu/common/kupueditor.js"&gt;
+
+                &lt;map:act type="reserved-checkout"&gt;
+                  &lt;map:generate type="serverpages" src="content/rc/{exception}.xsp"&gt;
+                    &lt;map:parameter name="user" value="{user}"/&gt;
+                    &lt;map:parameter name="filename" value="{filename}"/&gt;
+
+                    &lt;map:parameter name="date" value="{date}"/&gt;
+                    &lt;map:parameter name="message" value="{message}"/&gt;
+                  &lt;/map:generate&gt;
+                  &lt;map:transform src="xslt/rc/rco-exception.xsl"/&gt;
+                  &lt;map:call resource="style-cms-page"/&gt;
+                &lt;/map:act&gt;
+
+                &lt;map:generate src="resources/kupu/apache-lenya/kupumacros.html"/&gt;
+                &lt;map:transform src="resources/kupu/apache-lenya/kupumacros-xhtml.xsl"&gt;
+                  &lt;map:parameter name="contentfile" value="{page-envelope:context-prefix}/{../1}/authoring/{../2}.html?lenya.usecase=kupu&amp;amp;lenya.step=content"/&gt;
+                  &lt;map:parameter name="context" value="{request:contextPath}"/&gt;
+                  &lt;map:parameter name="document-path" value="{page-envelope:document-path}"/&gt;
+
+                  &lt;map:parameter name="root" value="{page-envelope:context-prefix}"/&gt;
+                  &lt;map:parameter name="save-destination" value="{page-envelope:context-prefix}/{../1}/authoring/{../2}.html?lenya.usecase=kupu&amp;amp;lenya.step=save"/&gt;
+                  &lt;map:parameter name="reload-on-save" value="0"/&gt; &lt;!-- 1 means you can see the saving --&gt;
+                  &lt;map:parameter name="use-css" value="1"/&gt;
+                  &lt;map:parameter name="redirect-to" value="{page-envelope:document-name}.html"/&gt;
+
+                &lt;/map:transform&gt;
+                &lt;map:serialize type="html"/&gt;
+              &lt;/map:act&gt;
+              &lt;map:generate src="resources/misc/kupu/download.xhtml"/&gt;
+              &lt;map:call resource="style-cms-page"/&gt;
+            &lt;/map:match&gt;
+
+          &lt;/map:match&gt;
+</source>
+
+</section>
+<section>
+<title id="head-f6ed65665fa1e56a5371d0ab376effe42403dfae">step="content"</title>
+
+
+<source xml:space="preserve">
+          &lt;map:match pattern="content" type="step"&gt;
+            &lt;map:match pattern="*/authoring/**.html"&gt;
+              &lt;map:generate src="pubs/{1}/content/authoring/{page-envelope:document-path}"/&gt;
+
+              &lt;map:transform src="resources/kupu/apache-lenya/kupucontent-xhtml.xsl"&gt;
+                &lt;map:parameter name="css" value="{page-envelope:context-prefix}/{1}/authoring/css/page.css"/&gt;
+              &lt;/map:transform&gt;
+              &lt;map:transform src="xslt/util/strip_namespaces.xsl"/&gt;
+                &lt;map:serialize type="xhtml"/&gt;
+            &lt;/map:match&gt;
+
+          &lt;/map:match&gt;
+</source>
+
+</section>
+<section>
+<title id="head-211e1aede1d0c03aa8411a1d19a43d3f5d18ccc9">step="save"</title>
+
+
+<source xml:space="preserve">
+          &lt;map:match pattern="save" type="step"&gt;
+            &lt;map:select type="request-method"&gt;
+              &lt;map:when test="PUT"&gt;
+
+                &lt;map:act type="reserved-checkout-test"&gt;
+                  &lt;map:generate type="serverpages" src="../../content/rc/{exception}.xsp"&gt;
+                    &lt;map:parameter name="user" value="{user}"/&gt;
+                    &lt;map:parameter name="filename" value="{filename}"/&gt;
+                    &lt;map:parameter name="date" value="{date}"/&gt;
+                    &lt;map:parameter name="message" value="{message}"/&gt;
+
+                  &lt;/map:generate&gt;
+                  &lt;map:transform src="../../xslt/rc/rco-exception.xsl"/&gt;
+                  &lt;map:call resource="style-cms-page"/&gt;
+                &lt;/map:act&gt;
+
+                &lt;map:aggregate element="edit-envelope"&gt;
+                  &lt;map:part element="edited" src="cocoon:/kupu-stream"/&gt;
+
+                  &lt;map:part element="original" src="pubs/{page-envelope:publication-id}/content/authoring/{page-envelope:document-path}"/&gt;
+                &lt;/map:aggregate&gt;
+
+                &lt;map:transform src="resources/kupu/apache-lenya/kupusave-xhtml.xsl"/&gt;
+
+                &lt;map:act type="reserved-checkin"&gt;
+                  &lt;map:generate src="content/rc/{exception}.xsp" type="serverpages"&gt;
+
+                    &lt;map:parameter name="user" value="{user}"/&gt;
+                    &lt;map:parameter name="filename" value="{filename}"/&gt;
+                    &lt;map:parameter name="checkType" value="{checkType}"/&gt;
+                    &lt;map:parameter name="date" value="{date}"/&gt;
+                    &lt;map:parameter name="message" value="{message}"/&gt;
+                  &lt;/map:generate&gt;
+
+                  &lt;map:transform src="xslt/rc/rco-exception.xsl"/&gt;
+                  &lt;map:serialize/&gt;
+                &lt;/map:act&gt;
+
+                &lt;map:transform src="xslt/authoring/edit/addSourceTags.xsl"&gt;
+                  &lt;map:parameter name="source" value="pubs/{page-envelope:publication-id}/content/authoring/{page-envelope:document-path}"/&gt;
+                &lt;/map:transform&gt;
+
+                &lt;map:transform type="write-source"/&gt;
+
+                &lt;!-- Trigger workflow with *edit* action --&gt;
+                &lt;map:act type="workflow"&gt;
+                  &lt;map:parameter name="area" value="{page-envelope:area}"/&gt;
+                  &lt;map:parameter name="document-id" value="{page-envelope:document-id}"/&gt;
+                  &lt;map:parameter name="language" value="{page-envelope:document-language}"/&gt;
+
+                  &lt;map:parameter name="event" value="edit"/&gt;
+                &lt;/map:act&gt;
+
+                &lt;map:serialize type="xml" status-code="204"/&gt;
+              &lt;/map:when&gt;
+            &lt;/map:select&gt;
+          &lt;/map:match&gt;
+
+</source>
+</section>
+</section>
+</body>
+</document>

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

Added: lenya/sandbox/pubs/docu/content/authoring/257bcd50-8731-11dc-ae46-9e7b5d14892d/en.1193910783856.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/257bcd50-8731-11dc-ae46-9e7b5d14892d/en.1193910783856.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/257bcd50-8731-11dc-ae46-9e7b5d14892d/en.1193910783856.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/257bcd50-8731-11dc-ae46-9e7b5d14892d/en.1193910783856.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,192 @@
+<?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: xopus.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>Xopus</title>
+     
+     
+     
+</header> 
+<body> 
+
+<section>
+<title>About Xopus</title>
+<p>Xopus is a browser based validating in-place wysiwyg XML editor. It uses Javascript, XML Schema and XSLT.
+    At this time, it only works on Internet Explorer. If you need a cross-platform solution, take a look at
+    BXE. Note that Xopus is not open source, but a commerical product by Q42.</p>
+</section>
+    
+<section>
+<title>Demo</title>
+<p>There is an online <a href="http://www.xopus.com/demo/index.html">XOPUS demo</a> available. You need Internet
+    Explorer 5.5 or newer to view the demo.</p>
+</section>
+
+<section>
+<title>Configuration</title>
+<p>Lenya is expecting an <em>@XOPUS:CONTEXT@</em> (e.g. Xopus-2.1.66) directory 
+within your <em>@XOPUS:PATH@</em> (e.g. <em>webapps/ROOT</em>) directory. 
+<em>@XOPUS:CONTEXT@</em> and <em>@XOPUS:PATH@</em> are configured 
+within your <em>local.build.properties</em> (xopus.context resp. xopus.path). 
+The path is relative to <em>usecase.xmap</em>. 
+</p>
+</section>
+
+<section>
+<title>Saving via POST</title>
+<p>To enable saving via POST, one needs to modify <code>$XOPUS/xopusPlugins/datadriver.js</code> as follows</p>
+<source xml:space="preserve">
+<![CDATA[
+    // Save data START
+    alert('Save XML via POST');
+    var result = Application.sendXML(doc, 'POST', name);
+
+    switch (result.status)
+    {
+      case 200:
+        //OK
+        var resultXML = result.responseXML;
+        alert('XML saved');
+        return;
+      case -1:
+        alert('Error while saving ' + name + ':\n\n' + result.responseText);
+        break;
+      default:
+        alert('Server responded not ok while saving ' + name + ':\n\nstatus:' + result.status + '\nmessage: ' + resul
+t.responseText);
+    }
+    // Save data END
+]]>
+</source>
+<p>
+You may change the text of the alerts by something else.
+</p>
+</section>
+
+<section>
+<title>Exit Xopus</title>
+<p>To exit Xopus one needs to modify <code>$XOPUS/xopusPlugins/cmsdriver.js</code> as follows</p>
+<source xml:space="preserve">
+<![CDATA[
+  getExitURL: function(path)
+  {
+    exitURL = path.substring(0, path.indexOf('?'));
+    alert('Exit to: ' + exitURL);
+    return exitURL;
+  },
+]]>
+</source>
+<p>
+You may replace the text of the alert by something else.
+</p>
+</section>
+
+<section>
+<title>Making a page editable with Xopus: Schemas, Views (XSLT) and Menus</title>
+<p>Xopus needs an XML Schema for validation and an XSLT to view the document. The Schemas and XSLTs need to be located at:</p>
+<source xml:space="preserve">
+<![CDATA[
+$PUBLICATION/config/doctypes/schemas/$DOCTYPE.xsd
+$PUBLICATION/lenya/xslt/xopus/$DOCTYPE.xsl
+]]>
+</source>
+<p>
+You might want to use <a href="http://www.thaiopensource.com/relaxng/trang.html">Trang</a> to generate XML Schemas.
+</p>
+<p>
+Editing with Xopus is implemented as a usecase. One can add a menu item as follows:
+</p>
+<source xml:space="preserve">
+<![CDATA[
+<item uc:usecase="xopus" uc:step="open" href="?doctype=$DOCTYPE">Edit&#160;with&#160;Xopus</item>
+]]>
+</source>
+<p>In addition, you may want to study the oscom publication which has an Xopus integration example, 
+    as well as the root xopus.xmap, the xopus.xmap in the oscom publication, and the section in 
+    usecase.xmap pertaining to xopus. This will help you understand how the integration was done
+    (which admittedly is a bit clunky as it predates many Lenya concepts).
+    </p>
+</section>
+<section>
+<title>Things to watch out for</title>
+<section>
+    <title>Check your Internet Explorer cache settings</title>
+<p>Make sure that the page is loaded from scratch everytime you visit it, because
+otherwise you'll always see a cached version. This cached version will be
+saved if you click on 'save' in Xopus.</p>
+</section>
+<section>
+    <title>Check your local.build.properties</title>
+<p>Your variable settings could look like this:</p>
+<source xml:space="preserve">
+<![CDATA[
+  xopus.context=Xopus-2.1.72   root directory for all Xopus files
+  xopus.path=../../ROOT        relative path from usecase.xmap to Xopus root
+                               directory
+]]>
+</source>
+</section>
+    <section>
+    <title>Check your schema files</title>
+<p>I had troubles with schemas including other schema files. You have to insert a
+separate pipeline for this kind of architecture. Unfortunately I couldn't
+figure out if I had to put this matcher in
+'$PUBLICATION/publication-sitemap.xmap' or elsewhere. I ended up using one and
+only one schema file for a specific doctype.</p>
+</section>
+<section>
+    <title>Check your CSS files</title>
+<p>You have to provide a stylesheet for Xopus in
+'$PUBLICATION/lenya/xslt/xopus/$DOCTYPE.xsl'. If you use a *.css file to
+control layout and style of the XML file displayed by Xopus, you'll have to
+insert a pipeline matcher in '$PUBLICATION/publication-sitemap.xmap':</p>
+<source xml:space="preserve">
+<![CDATA[
+  <map:pipeline>
+    <map:match pattern="**/xopus.css">
+      <map:read src="resources/shared/css/xopus.css" mime-type="text/css"/>
+    </map:match>
+  </map:pipeline>
+]]>
+</source>
+</section>
+<section>
+<title>Missing preparexinclude.xsl</title>
+<p>If Xopus complains that it cannot find <code>$XOPUS/xopusPlugins/preparexinclude.xsl</code>, then add the following at that location:</p>
+<source xml:space="preserve">
+<![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+                       xmlns:x="http://www.w3.org/2001/XInclude"
+                       xmlns:xlink="http://www.w3.org/1999/xlink"
+                       xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                       >
+
+  <xsl:template match="@*|node()">
+    <xsl:copy>
+      <xsl:apply-templates select="@*|node()"/>
+    </xsl:copy>
+  </xsl:template>
+</xsl:stylesheet>]]>
+</source>
+</section>
+</section>
+</body>
+</document>

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

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

Added: lenya/sandbox/pubs/docu/content/authoring/26cabb80-8731-11dc-ae46-9e7b5d14892d/en.1193910799162.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/26cabb80-8731-11dc-ae46-9e7b5d14892d/en.1193910799162.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/26cabb80-8731-11dc-ae46-9e7b5d14892d/en.1193910799162.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/26cabb80-8731-11dc-ae46-9e7b5d14892d/en.1193910799162.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,236 @@
+<?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: navigation.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 Navigation Framework</title>
+  </header> 
+  <body> 
+
+<section>
+  <title>Introduction</title>
+
+  <p>
+    To goal of the navigation framework is to
+  </p>
+  <ul>
+    <li>
+      simplify and standardize the generation of navigation
+      widgets like menubars, tabs, breadcrumb paths.
+    </li>
+  </ul>
+
+  <p>With the approach that is presented here it shall be possible to
+  </p>
+  <ul>
+    <li>
+      use pre-defined XHTML navigation components and present them
+      with a custom CSS,
+    </li>
+    <li>
+      override these components in a publication whereby the logic
+      can be reused, and
+    </li>
+    <li>
+      create and integrate new publication-specific navigation components
+      using the same scheme.
+    </li>
+  </ul>
+</section>
+    
+<section>
+  <title>Architecture</title>
+  
+  <p>
+    The navigation framework consists of the following components:
+  </p>
+    
+  <dl>
+    <dt>
+<code>/lenya/navigation.xmap</code>
+</dt>
+    <dd>The sitemap where the navigation components are loaded.<br/>
+<br/>
+</dd>
+    <dt>
+<code>/lenya/xslt/navigation/*.xsl</code>
+</dt>
+    <dd>The default navigation components that are shipped with Lenya.<br/>
+<br/>
+</dd>
+    <dt>
+<code>/lenya/pubs/lenya/xslt/navigation/*.xsl</code>
+</dt>
+    <dd>Custom navigation components of the publication.<br/>
+<br/>
+</dd>
+  </dl>
+  
+</section>
+
+<section>
+  <title>Using the Navigation Framework</title>  
+  
+  <section>
+<title>Loading a Navigation Component</title>
+  
+    <p>
+      You can load a navigation component from the following URI:
+    </p>
+<source xml:space="preserve"><![CDATA[
+cocoon://navigation/<pub-id>/<component>/<path>.xml
+]]></source>
+
+<p>
+The URI steps are:
+</p>
+<dl>
+  <dt>
+<code>&lt;pub-id&gt;</code>
+</dt>
+  <dd>The publicaton ID.</dd>
+  <dt>
+<code>&lt;component&gt;</code>
+</dt>
+  <dd>The navigation component to load (tabs, menu, etc.).</dd>
+  <dt>
+<code>&lt;path&gt;</code>
+</dt>
+  <dd>The navigation path. It is a concatenation of the <code>href</code>
+    attributes of the sitetree nodes that lead to the current node,
+    e.g. <code>demo/oscom.html</code> for the sitetree
+    fragment
+  </dd>
+</dl>
+<source xml:space="preserve"><![CDATA[
+<site xmlns="http://apache.org/cocoon/lenya/sitetree/1.0">
+  <node href="demo/" label="Demo">
+    <node href="oscom.html" label="OSCOM"/>
+    ...
+  </node>
+  ...
+</site>
+]]></source>
+  
+  </section>
+  
+  <section>
+<title>Aggregating the Navigation Components</title>
+  
+  <p>
+    The basic principle is shown in the following figure:
+  </p>
+  <p>
+  <img alt="" src="lenya-document:6824ed30-8731-11dc-ae46-9e7b5d14892d"/>
+  </p>
+  
+  <p>
+    In the publication sitemap (<code>lenya/pubs/&lt;pub-id&gt;/sitemap.xmap</code>)
+    the navigation components are aggregated. Here you decide which components
+    you want to use:
+  </p>
+<source xml:space="preserve"><![CDATA[
+    <map:pipeline>
+      <map:match pattern="navigation/**.html">
+(1)       <map:aggregate element="page" prefix="page"
+              ns="http://apache.org/cocoon/lenya/cms-page/1.0">
+              
+(2)         <map:part src="cocoon://navigation/
+                {publication-id}/breadcrumb/{../1}.html.xml"/>
+                
+(3)         <map:part src="cocoon://navigation/
+                {publication-id}/tabs/{../1}.html.xml"/>
+                
+(4)         <map:part src="cocoon://navigation/
+               {publication-id}/menu/{../1}.html.xml"/>
+               
+          </map:aggregate>
+          
+(5)       <map:transform src="xslt/page2xhtml.xsl">
+(6)          <map:parameter name="root"
+                 value="{context}/{publication-id}/"/>
+          </map:transform>
+        
+(7)     <map:serialize type="xhtml"/>
+
+      </map:match>
+    </map:pipeline>
+]]></source>
+  
+<ol>
+  <li>
+    The navigation elements are aggregated together with other document parts.
+  </li>
+  <li>
+    Load the breadcrumb XHTML fragment.
+  </li>
+  <li>
+    Load the tabs XHTML fragment.
+  </li>
+  <li>
+    Load the menu XHTML fragment.
+  </li>
+  <li>
+    Create the XHTML page.
+  </li>
+  <li>
+    The stylesheet can use this parameter to generate absolute URLs.
+  </li>
+  <li>
+    Finally, serialize the page as XHTML.
+  </li>
+</ol>
+
+  </section>
+  
+</section>
+  
+<section>
+  <title>Developing Navigation Components</title>
+  
+  <p>
+    The following contracts define the development of navigation components:
+  </p>
+  <ul>
+    <li>A navigation component is an XSLT stylesheet that is located at<br/>
+<br/>
+    <dl>
+      <dt>
+<code>lenya/xslt/navigation/&lt;component&gt;.xsl</code>
+</dt>
+      <dd>for default components and<br/>
+<br/>
+</dd>
+      <dt>
+<code>lenya/pubs/&lt;publication-id&gt;/lenya/xslt/&lt;component&gt;.xsl</code>
+</dt>
+      <dd>for default components.<br/>
+<br/>
+</dd>
+    </dl>
+    </li>
+    <li>
+      The default components produce an XHTML fragment with the
+      top level element <![CDATA[<div class="<component>"/>]]>.
+    </li>
+  </ul>
+
+</section>
+
+  </body> 
+</document>

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

Added: lenya/sandbox/pubs/docu/content/authoring/280a4060-8731-11dc-ae46-9e7b5d14892d/en.1193910799512.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/280a4060-8731-11dc-ae46-9e7b5d14892d/en.1193910799512.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/280a4060-8731-11dc-ae46-9e7b5d14892d/en.1193910799512.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/280a4060-8731-11dc-ae46-9e7b5d14892d/en.1193910799512.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,85 @@
+<?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: xhtml-templating.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>XHTML templating</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<section>
+<title>The XHTML Templating Concept</title> 
+<p>There are various approaches to templating within a Lenya
+publication. The XHTML approach is effective under the following
+conditions:
+</p>
+<ul>
+  <li>Designers want to edit the layout with their conventional tools.</li> 
+<li>The page layout contains large parts of static HTML.</li>
+<li>Pages are typically composed of simple elements.</li>
+</ul>
+
+<p>
+If these conditions are met, it is possible to define the overall
+layout of a page in a XHTML document, using tools like Dreamweaver.
+Special placeholders need to be inserted to indicate where Lenya
+elements should later be substituted. This can be done by inserting
+&lt;div id="navigation" /&gt; as the placeholder for the navigation, for
+instance, or &lt;div id="cmsbody" /&gt; for the body part of a page.
+</p>
+<p>
+If these XHTML documents are finished, they can then be called
+from Lenya, and the placeholders be substituted with CMS content.
+Schematically, this process looks as follows:
+</p>
+<p>1)</p>
+
+<p>XML document (article)    -&gt;</p>
+<p>XML document (navigation) -&gt;  Aggregation to one XML document</p>
+<p>XHTML template            -&gt;</p> 
+
+<p>2)</p>
+
+<p>aggregated XML document   -&gt;  Processing with XSLT</p>
+<p>
+Step 2) identifies the various placeholders ( &lt;div id="navigation" /&gt;
+and &lt;div id="cmsbody" /&gt; in this example) and applies XSL transformations
+to substitute the placeholders with the transformed contents of
+(navigation, article) respectively.
+</p>
+<p>
+What are the advantages of this approach?</p>
+<ul>
+  <li>less XSLT is required, making it easier to delegate design work</li>
+<li>XSLT are easier to understand, as they only affect a small part
+  of a page</li>
+</ul>
+<p>What are the pitfalls of this approach?</p>
+<ul>
+  <li>it may not be appropriate to put the content (here: article) into
+  the XHTML format</li>
+<li>template reuse may be hampered</li>
+</ul>
+</section>
+
+</body>
+</document>

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

Added: lenya/sandbox/pubs/docu/content/authoring/2947a260-8731-11dc-ae46-9e7b5d14892d/en.1193910788565.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/2947a260-8731-11dc-ae46-9e7b5d14892d/en.1193910788565.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/2947a260-8731-11dc-ae46-9e7b5d14892d/en.1193910788565.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/2947a260-8731-11dc-ae46-9e7b5d14892d/en.1193910788565.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,86 @@
+<?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: static-resources.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>Serving Static Resources</title>
+     
+    <type>Overview document</type> 
+     
+</header> 
+<body> 
+
+<section>
+<title>Serving Static Resources</title> 
+<p>Lenya now serves static resources out of the box. Publications can either
+use these predefined mappings, or provide their own. The following MIME types
+are handled:
+</p>
+<ul>
+  <li>CSS</li> 
+<li>Javascript</li>
+<li>Images (GIF, JPEG and PNG)</li>
+<li>PDF</li>
+<li>Shockwave Flash (*.swf)</li>
+</ul>
+
+<p>
+To use the built-in matching, these resources need to be stored in the
+appropriate directories within a publication, and called with the proper
+URLs.
+</p>
+<table>
+<tr>
+<td colspan="1" rowspan="1">MIME Type</td>
+<td colspan="1" rowspan="1">Prefix</td>
+<td colspan="1" rowspan="1">Directory</td>
+</tr>
+<tr>
+<td colspan="1" rowspan="1">CSS</td>
+<td colspan="1" rowspan="1">css/</td>
+<td colspan="1" rowspan="1">resources/css/</td>
+</tr>
+<tr>
+<td colspan="1" rowspan="1">Javascript</td>
+<td colspan="1" rowspan="1">javascript/</td>
+<td colspan="1" rowspan="1">resources/javascript/</td>
+</tr>
+<tr>
+<td colspan="1" rowspan="1">Images</td>
+<td colspan="1" rowspan="1">images/</td>
+<td colspan="1" rowspan="1">resources/images/</td>
+</tr>
+<tr>
+<td colspan="1" rowspan="1">PDF</td>
+<td colspan="1" rowspan="1">pdf/</td>
+<td colspan="1" rowspan="1">resources/pdf/</td>
+</tr>
+<tr>
+<td colspan="1" rowspan="1">Flash</td>
+<td colspan="1" rowspan="1">flash/</td>
+<td colspan="1" rowspan="1">resources/flash/</td>
+</tr>
+</table>
+<p>An image would thus be called with &lt;img src="images/logo.gif" /&gt;
+You dont have to worry about absolute vs relative image paths as long
+as you use URLs that follow this pattern.</p>
+</section>
+
+</body>
+</document>

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

Added: lenya/sandbox/pubs/docu/content/authoring/2a82ba70-8731-11dc-ae46-9e7b5d14892d/en.1193910797793.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/2a82ba70-8731-11dc-ae46-9e7b5d14892d/en.1193910797793.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/2a82ba70-8731-11dc-ae46-9e7b5d14892d/en.1193910797793.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/2a82ba70-8731-11dc-ae46-9e7b5d14892d/en.1193910797793.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,319 @@
+<?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: lenya-menubar.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 Lenya Menubar</title>
+     
+     
+     
+</header> 
+<body>
+  
+<section>
+<title>Defining the Menubar</title>
+
+<section>
+<title>The XML Structure</title>
+<p>
+  A menubar declaration contains the definition of several menus.
+  Each menu consists of a set of blocks containing items.
+  The structure of a menu declaration looks as follows:
+</p>
+
+<source xml:space="preserve"><![CDATA[<menu xmlns="http://apache.org/cocoon/lenya/menubar/1.0">
+
+  <menus>
+    
+    <menu label="File" name="File">
+      <block>
+        <item href="...">New Document</item>
+        <item href="...">New Language Version</item>
+        ...
+      </block>
+      ...
+    </menu>
+    
+    ...
+
+  </menus>
+
+</menu>]]></source>
+</section>
+
+<section>
+<title>Showing Blocks and Items Only in Certain Tabs</title>
+
+<p>
+  When you use the same menu declaration for different tabs,
+  it might be wished that a menu item shouldn't appear in all
+  these tabs. For instance, the <em>Edit</em> menu item should
+  be displayed only in the <em>authoring</em> tab menu.
+</p>
+<p>
+  To disable a menu item or block, you add an attribute with
+  the name of the tab (<em>authoring</em>, <em>info</em>)
+  and the value <code>false</code>:
+</p>
+<source xml:space="preserve"><![CDATA[<item info="false">...</item>
+
+<block authoring="false">
+  ...
+</block>
+]]></source>
+
+</section>
+
+<section>
+<title>Specifying Usecases and Workflow Events</title>
+
+<p>
+  When a menu item calls a usecase or triggers a workflow transition,
+  and the corresponding action is not allowed, the <code>href</code>
+  attribute of the item is removed before the menu is rendered to
+  disable the item. For this purpose, the <code><![CDATA[<item>]]></code>
+  element supports the attributes
+</p>
+
+<ul>
+  <li>
+<code>wf:event</code>,</li>
+  <li>
+<code>uc:usecase</code>, and</li>
+  <li>
+<code>uc:step</code>.</li>
+</ul>
+  
+<p>
+  If the attributes are provided, they are translated into the
+  appropriate request parameters:
+</p>
+
+<ul>
+  <li>
+<code>wf:event -&gt; lenya.event</code>
+</li>
+  <li>
+<code>uc:usecase -&gt; lenya.usecase</code>
+</li>
+  <li>
+<code>uc:step -&gt; lenya.step</code>
+</li>
+</ul>
+  
+<p>
+  The attributes are used in the following way:
+</p>
+
+<source xml:space="preserve"><![CDATA[<menu
+    xmlns="http://apache.org/cocoon/lenya/menubar/1.0"
+    xmlns:uc="http://apache.org/cocoon/lenya/usecase/1.0"
+    xmlns:wf="http://apache.org/cocoon/lenya/workflow/1.0">
+
+  ...
+
+  <item wf:event="edit"
+        uc:usecase="edit-forms"
+        uc:step="open" href="?...">Edit with Forms</item>
+  
+  ...
+
+</menu>]]></source>
+
+<p>
+  The resulting request would be
+</p>
+<source xml:space="preserve">?lenya.event=edit&amp;lenya.usecase=edit-forms&amp;lenya.step=open&amp;...</source>
+<p>
+  If a user is not allowed to invoke the event <code>edit</code>
+  or to execute the usecase <code>edit-forms</code>, the menu
+  item will be disabled.
+</p>
+
+</section>
+
+</section>
+  
+<section>
+<title>Applying the Menubar - Meta Stylesheet Approach</title>
+
+<p>
+In this approach, the publication simply builds its XHTML
+page without any additional XML. The Lenya menubar is added using
+a meta stylesheet in the last transformation step.
+You find more information on meta stylesheets on the page
+<a href="ext:wiki/lenya/MetaStylesheets">MetaStylesheets</a>
+in the Cocoon wiki.
+</p>
+
+<section>
+<title>The Big Picture (literally)</title>
+
+<p>
+<img alt="Lenya page processing" src="lenya-document:67c65270-8731-11dc-ae46-9e7b5d14892d"/>
+</p>
+<p>
+In the left column you see the XML flow within the publication sitemaps,
+  the right column shows the flow within the core sitemaps.
+</p>
+
+<section>
+<title>Creating the Menu XHTML</title>
+<ul>
+  <li>The actual menu XML is fetched from the sitemap <code>menus.xmap</code>
+  within the publication directory.</li>
+  <li>The XML is processed using the UsecaseMenuTransformer and the
+  WorkflowMenuTransformer.</li>
+  <li>The stylesheet <code>lenya/xslt/menu/menu2xhtml.xsl</code> transforms
+  the menu XML into XHTML.</li>
+  <li>Finally, this XHTML is transformed into a meta stylesheet by
+  <code>lenya/xslt/menu/menu2xslt.xsl</code>.</li>
+</ul>
+</section>
+
+<section>
+<title>Requesting and Applying the Menubar</title>
+<ul>
+  <li>The XHTML page is generated without any additional XML.</li>
+  <li>Afterwards, the menubar meta stylesheet is requested using
+  a <code>cocoon://lenya-page/...</code> internal request.</li>
+  <li>This request is matched in <code>global-sitemap.xmap</code>.</li>
+  <li>The menubar meta stylesheet is applied to the XHTML page.
+  It inserts the menubar at the top of the HTML body, adds some
+  additional CSS file entries and modifies the HTML title.</li>
+</ul>
+</section>
+
+</section>
+
+<section>
+<title>Configuring the Publication</title>
+
+<section>
+<title>Requesting the lenya-page Meta Stylesheet</title>
+<p>The lenya-page meta stylesheet request looks as follows:</p>
+
+<source xml:space="preserve"><![CDATA[
+<map:generate src="cocoon:/page/..."/>
+<map:transform src="cocoon://lenya-page/{page-envelope:publication-id}/[menu-url]"/>
+<map:serialize type="html"/>
+]]></source>
+
+<ul>
+  <li>The <code>lenya-page</code> part is used to match the request in <code>global-sitemap.xmap</code>.</li>
+  <li>The <code>{page-envelope:publication-id}</code> part is used to evaluate which
+  publication the request came from.</li>
+  <li>The <code>[menu-url]</code> part is used to get the menu from <code>menus.xmap</code>.
+  Here you have to add all information you need to select the appropriate menubar.</li>
+</ul>
+</section>
+
+<section>
+<title>Creating the Menu XML</title>
+<p>Usually, this is done using an XSP page.</p>
+<p>The Lenya menubar namespace is</p>
+<source xml:space="preserve">http://apache.org/cocoon/lenya/menubar/1.0</source>
+</section>
+
+<section>
+<title>Supplying Menus in menus.xmap</title>
+<p>When the lenya-page meta stylesheet is generated in the core,
+the actual menu XML is fetched using a request to the sitemap
+<code>menus.xmap</code> in the publication directory.
+The <code>[menu-url]</code> part from the lenya-page request is
+matched in this sitemap.</p>
+
+<p>
+This simple <code>menus.xmap</code> pipeline uses different
+menus for authoring and live:
+</p>
+
+<source xml:space="preserve"><![CDATA[
+<map:pipeline>
+  
+  <map:match pattern="live/**">
+    <map:generate type="serverpages"
+        src="../../content/menus/live.xsp"/>
+    <map:serialize type="xml"/>
+  </map:match>
+  
+  <map:match pattern="*/**">
+    <map:generate type="serverpages"
+        src="config/menus/generic.xsp"/>
+    <map:serialize type="xml"/>
+  </map:match>
+  
+</map:pipeline>
+]]></source>
+
+<p>You can as well use the document type or the current URL to
+select a menu.</p>
+
+<p>Examples for lenya-page requests:</p>
+
+<p>Using the area:</p>
+<source xml:space="preserve">cocoon://lenya-page/{page-envelope:publication-id}/{page-envelope:area}</source>
+
+<p>Using the document type:</p>
+<source xml:space="preserve">cocoon://lenya-page/{page-envelope:publication-id}/{page-envelope:document-type}</source>
+
+<p>Using the document URL:</p>
+<source xml:space="preserve">cocoon://lenya-page/{page-envelope:publication-id}/{page-envelope:document-url}</source>
+
+</section>
+
+</section>
+
+<section>
+<title>Creating a Customized Menu</title>
+
+<p>
+  It is also possible to get the menu XML before it is transformed
+  to XHTML using a request to the core. For this purpose, the prefix
+  <code>menu-xml</code> is used instead of <code>lenya-page</code>.
+  This way, you can aggregate the menu XML together with other page parts
+  and include it somewhere inside the XML page.
+</p>
+
+<source xml:space="preserve"><![CDATA[<map:aggregate element="lenya" label="aggregation">
+  <map:part src="cocoon:/lenyabody/{1}/{2}.xml"/>
+  <map:part src="cocoon://menu-xml/{page-envelope:publication-id}/{1}.xml"/>
+</map:aggregate>]]></source>
+</section>
+
+</section>
+
+
+<section>
+<title>Applying the Menubar - Classic Approach</title>
+
+<note>This approach is deprecated.</note>
+
+<section>
+<title>XSLT</title>
+<p>
+By editing <code>src/webapp/lenya/xslt/menu/menu.xsl</code> one can change the look and feel of the Lenya menu bar.
+This XSLT template is being included by <code>src/webapp/lenya/xslt/menu/root.xsl</code>.
+</p> 
+</section>
+
+</section>
+
+</body>
+</document>

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

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

Added: lenya/sandbox/pubs/docu/content/authoring/2c0b5640-8731-11dc-ae46-9e7b5d14892d/en.1193910785046.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/2c0b5640-8731-11dc-ae46-9e7b5d14892d/en.1193910785046.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/2c0b5640-8731-11dc-ae46-9e7b5d14892d/en.1193910785046.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/2c0b5640-8731-11dc-ae46-9e7b5d14892d/en.1193910785046.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,93 @@
+<?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: pageenvelopemodule.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 PageEnvelopeModule</title>
+    
+    
+    
+  </header>
+  <body>
+
+<section>
+<title>Overview</title>
+<p>
+The <code>PageEnvelopeModule</code> is an <code>InputModule</code>
+that provides access to the <code>PageEnvelope</code> parameters. For
+documentation on input modules see section <a href="http://cocoon.apache.org/2.1/userdocs/concepts/modules.html">Modules</a>
+of the Cocoon documentation.
+</p>
+</section>
+  
+<section>
+<title>Module Parameters</title>
+<dl>
+  <dt>publication-id</dt>
+  <dd>The current publication ID.</dd>
+  <dt>context-prefix</dt>
+  <dd>The context prefix of the web application, e.g. <code>/lenya</code>.</dd>
+  <dt>area</dt>
+  <dd>The CMS area, <code>authoring</code> or <code>live</code>.</dd>
+  <dt>publication</dt>
+  <dd>The current publication</dd>
+  <dt>document-id</dt>
+  <dd>The document ID, i.e. the path of the document in the sitetree.</dd>
+  <dt>document-name</dt>
+  <dd>The document name, i.e. the very last part of the document ID.</dd>
+  <dt>document-url</dt>
+  <dd>The URL of the document within the area, e.g., <code>/news/index.html</code>
+</dd>
+  <dt>document-path</dt>
+  <dd>The file path where this document is physically located in the
+  file system.</dd>
+  <dt>document-language</dt>
+  <dd>The language of this document.</dd>
+  <dt>document-type</dt>
+  <dd>The document type.</dd>
+</dl>
+</section>
+
+<section>
+<title>Sitemap usage</title>
+<source xml:space="preserve">
+<![CDATA[<map:parameter name="document-id" value="{page-envelope:document-id}"/>]]>
+</source>
+</section>
+
+<section>
+<title>XSP usage</title>
+<source xml:space="preserve">
+<![CDATA[<xsp:page
+       language="java"
+       xmlns:xsp="http://apache.org/xsp"
+       xmlns:input="http://apache.org/cocoon/xsp/input/1.0">
+
+<usecase:url>
+  <input:get-attribute
+      module="page-envelope" as="string" name="document-url"/>
+</usecase:url>
+  
+</xsp:page>       
+]]>
+</source>
+</section>
+
+
+  </body>
+</document>

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

Added: lenya/sandbox/pubs/docu/content/authoring/2d3f4260-8731-11dc-ae46-9e7b5d14892d/en.1193910795509.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/2d3f4260-8731-11dc-ae46-9e7b5d14892d/en.1193910795509.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/2d3f4260-8731-11dc-ae46-9e7b5d14892d/en.1193910795509.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/2d3f4260-8731-11dc-ae46-9e7b5d14892d/en.1193910795509.bak Fri Nov  2 03:57:25 2007
@@ -0,0 +1,198 @@
+<?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: siteTree.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>Site Tree</title>
+    <version major="0" minor="1">Initial version</version>
+     
+    <notice/> 
+    <abstract>Proposal for a a general framework for management of
+    navigation for a publication.</abstract> 
+  </header> 
+  <body> 
+
+    <section>
+      <title>Motivation</title>
+
+      <p>Currently there is no standard way to manage the navigation
+in Lenya. Previous attempts have shown their own merits and
+drawbacks. A general and standard approach is needed.</p>
+
+    </section>
+
+    <section>
+      <title>Rationale</title>
+
+      <p>The basic problems we're trying to solve are as follows:</p>
+      <ol>
+	<li>Maintain the navigation in an easy format independent of
+	the actual storage of the documents.</li> 
+	<li>Enable moving of documents.</li>
+	<li>Enable querying of doctype independent of request URI.</li>
+      </ol>
+
+      <section>
+	<title>Navigation</title>
+	
+	<p>There are a couple of known implementations to choose from:</p>
+	<ul>
+	  <li>The existing Lenya tree.xml</li> 
+	  <li>The Forrest site.xml.</li>
+	  <li>The hashmap way: A sitetree.xml and purlspace.xml combination
+   where the purlspace.xml contains all existing documents and
+   sitetree.xml contains the navigation hierarchy.</li>
+	</ul>
+      </section>
+
+      <section>
+	<title>Moving Of Documents</title>
+	
+	<p>The Forrest site.xml solves this quite elegantly: Due to the use of
+XPath and some ambiguity the documents can be found almost
+independent of their actual location</p>
+
+	<p>With the existing Lenya or the hashmap solution changing of document
+location requires editing of the tree.xml or the purlspace.xml
+respectively.</p>
+      </section>
+
+      <section>
+	<title>Doctype Querying</title>
+	
+	<p>For question 3 there are a couple of known approaches:</p>
+
+	<section>
+	  <title>Hashmap</title>
+	  <p>This method uses an action which contains for each
+   request URI a mapping to attributes such as doctype, srcfile, xslt,
+   etc.</p>
+	</section>
+	<section>
+	  <title>Forrest SourceTypeAction</title>
+	  <p>Forrest contains an action which for a given request
+   opens the source file and determines its doctype based on the dtd
+   declaration.</p>
+	</section>
+	<section>
+	  <title>URIParametrizer</title>
+	  <p>The URIParametrizer is a black box (probably an action)
+   which internally issues cocoon requests to different sitemaps which
+   return different attributes (doctype, etc.) for a given request
+   URI.</p>
+	  <p>This amounts to a combination of the hashmap solution
+   with the basic cocoon concepts: The request URIs aren't matched
+   against a hashmap but are handled by a sitemap instead. The sitemap
+   contains normal pipelines and matchers which match on the
+   request. As a catch-all there is still the possibility of using a
+   hashmap for URIs that didn't match any pipelines.</p>
+	  <p>Finally a new (internal) request is generated using the
+   parameter values. This request is handled by a normal cocoon
+   sitemap as if the original request had contained these
+   parameters.</p>
+	  <figure alt="Diagram of URIParametrizer" src="URIParametrizer.png"/>
+	</section>
+      </section>
+    </section>
+    
+    <section>
+      <title>The Sitetree Schema</title>
+      <p>The proposed sitetree schema looks as follows:</p>
+<source xml:space="preserve"><![CDATA[
+<?xml version="1.0"?>
+
+<xs:schema
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    targetNamespace="http://apache.org/cocoon/lenya/sitetree/1.0"
+    xmlns="http://apache.org/cocoon/lenya/sitetree/1.0"
+    elementFormDefault="qualified">
+    
+  <xs:element name="site">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="node"
+            minOccurs="0" maxOccurs="unbounded"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  
+  <xs:element name="node">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="node"
+            minOccurs="0" maxOccurs="unbounded"/>
+      </xs:sequence>
+      <xs:attribute name="href" type="xs:string"/>
+      <xs:attribute name="label" type="xs:string"/>
+    </xs:complexType>
+  </xs:element>
+    
+</xs:schema>
+]]></source>
+
+      <p>
+        An example <code>sitetree.xml</code> could look like follows:
+      </p>
+      
+<source xml:space="preserve"><![CDATA[
+<site
+    xmlns="http://apache.org/cocoon/lenya/sitetree/1.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation=
+        "http://apache.org/cocoon/lenya/sitetree/1.0
+        ../../../../resources/entities/sitetree.xsd">
+    
+  <node href="index.html" label="Home"/>
+  
+  <node href="demo/" label="Demo">
+    <node href="unipublic.html" label="Unipublic"/>
+    <node href="news.html" label="Wyona News and Comments"/>
+    <node href="oscom.html" label="OSCOM"/>
+  </node>
+  
+  <node href="download/" label="Download">
+    <node href="source.html" label="Source Version"/>
+    <node href="binary.html" label="Binary Version"/>
+  </node>
+  
+  <node href="documentation/" label="Documentation"/>
+
+</site>
+]]></source>
+      
+    </section>
+
+    <section>
+      <title>Backwards Compatibility</title>
+      <p>There has not been a previous implementation, so this is a non-issue.</p>
+    </section>
+
+    <section>
+      <title>Roadmap</title>
+      <ul>
+	<li>Decide which solution to choose</li>
+      </ul>
+    </section>
+
+    <section>
+      <title>Reference Implementation</title>
+      <p>None</p>
+    </section>
+
+  </body> 
+</document>

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