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 [36/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/f5694890-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f5694890-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f5694890-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f5694890-8730-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="1193910799013" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910770036"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781616868" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781604022"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.1193910779040.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.1193910779040.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.1193910779040.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.1193910779040.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,508 @@
+<?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: source_version.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 1.2 Install instructions</title>
+ </header>
+
+ <body>
+ <section id="introduction">
+ <title>Introduction</title>
+
+ <p>
+ This document explains how to install Lenya 1.2.x from source.
+ There are different ways to install and run Lenya:
+ <br/>
+ Choose between
+ </p>
+ <ol>
+ <li>running Lenya standalone using the built-in Jetty servlet container</li>
+ <li>using Tomcat and have the build process taking care of deploying Lenya in Tomcat</li>
+ </ol>
+
+ <p>
+ Please note that you can use other servlet
+ containers as well, but Jetty and Tomcat are the tested ones.
+ </p>
+
+ <p>
+ In all cases, you will need to meet the following prerequisites,
+ that describe the setup that is tested and recommended.
+ </p>
+
+ </section>
+ <section id="prerequisites">
+ <title>Prerequisites</title>
+ <ul>
+
+ <li>
+ <p>
+ <strong>Java 2 Platform, Standard Edition</strong>
+ <br/>
+ We recommend version 1.4.2 or newer, though 1.4.1 has been reported to work as well. Version 1.5 works with <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=32923">limitations</a> (see Bugzilla).
+ <br/>
+ Get it from <a href="http://java.sun.com/j2se/1.4.2/download.html">http://java.sun.com/j2se/1.4.2/download.html</a>
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Recommended: Create a directory</strong> to better organise the various source files
+ <br/>
+ In this document, we will assume the name <code>src/</code> for that directory.
+ This directory will contain the Lenya distribution as well as Cocoon.
+ </p>
+
+ <p>
+ After expanding the downloaded archives or after a <a href="subversion.html">svn checkout</a>,
+ the directory structure should look like this:
+ </p>
+
+ <source xml:space="preserve">
+ your_home/ (or c:\ on Windows, NOT My Documents)
+ `-- src/
+ |-- lenya-1.2.x/ $LENYA_HOME
+ `-- cocoon-2.1.7/ $COCOON_HOME
+ `-- build/
+ `-- webapp/ $COCOON_WEBAPP
+ </source>
+
+ <p>
+ The directories inside cocoon-2.1.7/ will be created when you build Cocoon.
+ The variables will later be used in the local.build.properties file that configures the Lenya build process.
+ </p>
+
+ </li>
+
+ <li>
+ <p>
+ <strong>Get Apache Lenya</strong>
+ <br/>
+ (see <a href="lenya-document:f3e7d8b0-8730-11dc-ae46-9e7b5d14892d">Download Lenya</a>)
+ <br/>
+ Extract the downloaded Lenya archive in the
+ <code>src/</code> directory described above. This will create <code>lenya-1.2.x/</code> inside <code>src/</code>.
+ If you use <a href="http://subversion.tigris.org/">Subversion</a>, <a href="subversion.html">checkout Lenya</a> inside the
+ <code>src/</code> directory.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Get Apache Cocoon</strong>
+ <br/>
+ version: 2.1.7
+ <br/>
+ Get it from <a href="site:cocoon/mirror">http://cocoon.apache.org/mirror.cgi</a>
+<br/>
+ Unpack Cocoon in <code>src/</code>.
+ </p>
+
+ <br/>
+
+ <p>
+ Note that Cocoon is needed to build the source
+ version of Lenya, but the resulting Lenya webapp is
+ completely self contained and therefore does not need
+ the Cocoon webapp to be installed. See the <a href="../how-to/faq.html">FAQ</a>
+ for details of configuration changes required when running
+ multiple Cocoon based applications.
+ </p>
+ </li>
+
+
+ <li>
+ <p>
+ <strong>Build Cocoon</strong>
+ </p>
+
+ <p>
+ Copy the Cocoon build properties supplied by Lenya
+ </p>
+
+ <ul>
+ <li>
+<code>local.build.properties</code>
+</li>
+ <li>
+<code>local.blocks.properties</code>
+</li>
+ </ul>
+
+ <p>
+ from <code>$LENYA_HOME/src/cocoon/</code> to
+ <code>$COCOON_HOME</code>.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Compile Cocoon</strong>
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $COCOON_HOME > build.bat
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $COCOON_HOME > ./build.sh
+ </source>
+ </li>
+
+ </ul>
+
+
+ </section>
+
+
+ <section>
+ <title>Standalone Install</title>
+
+ <ol>
+
+ <li>
+ <p>
+ <strong>Configure Lenya to point to Cocoon</strong>
+ </p>
+
+ <p>
+ If your Cocoon source tree is set up as described above, you
+ can skip this step. If your Cocoon source tree is not at
+ <code>../cocoon-2.1.7</code> relative to Lenya, you need
+ to edit your build properties. To do this, copy
+ <code>$LENYA_HOME/build.properties</code> to
+ <code>$LENYA_HOME/local.build.properties</code>.
+ </p>
+
+ <p>
+ Edit <code>local.build.properties</code>. For the described
+ configuration the following settings will work (<strong>MS
+ Windows:</strong> Don't use backslashes "<code>\</code>" for
+ directory separation.)
+ </p>
+
+ <ul>
+ <li>
+<code>cocoon.src.dir=$COCOON_HOME</code>
+</li>
+ </ul>
+ </li>
+
+ <li>
+ <p>
+ <strong>Build Lenya</strong>
+ </p>
+
+ <p>
+ Execute <code>build.bat</code> or <code>build.sh</code> in
+ your Lenya source directory, depending on your platform.
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $LENYA_HOME > build.bat
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $LENYA_HOME > ./build.sh
+ </source>
+ </li>
+
+ <li>
+ <p>
+ <strong>Start Lenya</strong>
+ </p>
+
+ <p>
+ Execute <code>lenya.bat</code> or <code>lenya.sh
+ servlet</code> in your Lenya source directory, depending on
+ your platform. Make sure that you have the environment
+ variable <code>JAVA_HOME</code> defined to point to the
+ location of the Java SDK you installed (see <a href="#prerequisites">Prerequisites</a>).
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $LENYA_HOME > lenya.bat
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $LENYA_HOME > ./lenya.sh servlet
+ </source>
+ </li>
+
+ <li>
+ <p>
+ <strong>Test the installation</strong>
+ </p>
+
+ <p>
+ <a href="http://localhost:8888">http://localhost:8888/</a>
+ </p>
+ </li>
+ </ol>
+ </section>
+
+ <section>
+ <title>Install with Tomcat</title>
+ <warning label="Warning: Tomcat and spaces">The installation path may not contain spaces, otherwise you may get a
+ <code>java.net.URISyntaxException</code> error.</warning>
+ <ol>
+
+ <li>
+ <p>
+ <strong>Get Apache Tomcat</strong> for JDK 1.4
+ <br/>
+Lenya is developed and tested with Tomcat 5.0.28; this version is assumed in the following instructions, and we highly recommend it. Tomcat 4.0.0+, 4.1.24+, 5.0.18+ and 5.5.0+ should work too. <br/>
+ Get it from <a href="http://jakarta.apache.org/site/binindex.cgi#tomcat-5.0">http://jakarta.apache.org/site/binindex.cgi#tomcat-5.0</a>
+ </p>
+
+ </li>
+
+ <li>
+ <p>
+ <strong>Install Apache Tomcat</strong>
+ </p>
+
+ <p>
+ See <a href="http://jakarta.apache.org/tomcat/tomcat-5.0-doc/setup.html">Tomcat 5.0 Setup</a>
+ </p>
+
+ <p>
+ <strong>MS Windows:</strong>
+
+ <br/>
+
+ Basically you only need to set the <code>JAVA_HOME</code>
+ environment variable and run the Tomcat
+ installer. Decide to run Tomcat as a Windows
+ NT/2000/XP-Service.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Configure Lenya</strong>
+ </p>
+
+ <p>
+ To install Lenya with Tomcat, you need to edit your build
+ properties. To do this, copy
+ <code>$LENYA_HOME/build.properties</code> to
+ <code>$LENYA_HOME/local.build.properties</code>.
+ </p>
+
+ <p>
+ Edit <code>local.build.properties</code>. For the described
+ configuration the following settings will work (<strong>MS
+ Windows:</strong> Don't use backslashes "<code>\</code>" for
+ directory separation.) It is important that
+ <code>tomcat.home.dir</code> is an absolute path. Replace
+ <code>$TOMCAT_HOME</code> by your Tomcat installation
+ directory. If your Cocoon source directory is not at
+ <code>../cocoon-2.1.7</code> relative to Lenya, then change
+ the <code>cocoon.webapp.dir</code>, <code>web.app.server</code> and
+ <code>cocoon.src.dir</code> properties.
+ </p>
+
+ <ul>
+ <li>
+<code>web.app.server=Tomcat</code>
+</li>
+ <li>
+<code>cocoon.src.dir=$COCOON_HOME</code>
+</li>
+ <li>
+<code>tomcat.home.dir=$TOMCAT_HOME</code>
+</li>
+ </ul>
+ </li>
+
+ <li>
+ <p>
+ <strong>Build Lenya</strong>
+ </p>
+
+ <p>
+ Execute <code>build</code> in your Lenya source directory.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Checked versions of endorsed libraries</strong>
+ </p>
+
+ <p>
+ Lenya and Tomcat will inter-operate correctly only if the proper
+ versions of the Xalan and Xerces libraries are used consistently
+ throughout the deployment. Unfortunately this can be difficult
+ to get to work correctly since both of these libraries are
+ shipped with Java 2 SDK, Tomcat, Cocoon and Lenya.
+ </p>
+
+ <p>
+ The following libraries must be placed in the endorsed library
+ directory for your deployment.
+ </p>
+
+ <ul>
+ <li>
+<code>jakarta-bcel-20040329.jar</code>
+</li>
+ <li>
+<code>jakarta-regexp-1.3.jar</code>
+</li>
+ <li>
+<code>xalan-2.6.0.jar</code>
+</li>
+ <li>
+<code>xercesImpl-2.6.2.jar</code>
+</li>
+ <li>
+<code>xml-apis.jar</code>
+</li>
+ </ul>
+
+ <p>
+ They are placed by the build process in the directory specified
+ by <code>tomcat.endorsed.dir</code> in
+ <code>build.properties</code>. You should validate that these
+ files are indeed in the proper location for your deployment.
+ You must then validate that no other instances of these
+ libraries exist in any of the following directories:
+ </p>
+
+ <ul>
+ <li>
+ The Java 2 SDK endorsed standards directories. This is
+ usually <code>${JAVA_HOME}/lib/endorsed/</code>.
+ </li>
+
+ <li>
+ Any other location in your Tomcat deployment. Specifically,
+ check <code>shared/lib/</code>, <code>common/lib/</code> and
+ <code>server/lib/</code>.
+ </li>
+
+ <li>
+ Any other location in your Lenya deployment. Specifically,
+ check <code>webapps/lenya/WEB-INF/lib/</code>.
+ </li>
+ </ul>
+
+ <p>
+ A common symptom of incorrect library version are blank pages
+ after starting Lenya. Try carefully checking the location and
+ version numbers of each of the libraries.
+ </p>
+
+ <p>
+ References:
+ </p>
+
+ <ul>
+ <li>
+ <a href="http://jakarta.apache.org/tomcat/tomcat-5.0-doc/class-loader-howto.html">
+ Tomcat Class Loader HOWTO (http://jakarta.apache.org/tomcat/tomcat-5.0-doc/class-loader-howto.html)
+ </a>
+ </li>
+
+ <li>
+ <a href="http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html">
+ Java 2 Endorsed Standards Override Mechanism
+ (http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html)
+ </a>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <p>
+ <strong>Clear Tomcat work directory</strong>
+ </p>
+
+ <p>
+ Tomcat's work cache may not be consistent with your newly installed
+ Lenya. This can lead to any number of errors and exceptions. To
+ prevent this, clear the work directory by executing
+ <code>build.bat</code> or <code>build.sh</code> in your Lenya source
+ directory, depending on your platform.
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $LENYA_HOME > build.bat clean
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source xml:space="preserve">
+ $LENYA_HOME > ./build.sh clean
+ </source>
+ </li>
+ <li>
+ <p>
+ <strong>Restart Tomcat</strong>
+ </p>
+
+ <p>
+ Restart Tomcat to load the Lenya webapp.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Test the installation</strong>
+ </p>
+
+ <p>
+ <a href="http://localhost:8080/lenya">http://localhost:8080/lenya/</a>
+ </p>
+ </li>
+ </ol>
+ </section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-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>Install Instructions</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/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910779040.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910779040.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910779040.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910779040.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>Install Instructions</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/f696f320-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f696f320-8730-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="1193910779040" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765234"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781626940" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781606055"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.1193910795398.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.1193910795398.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.1193910795398.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.1193910795398.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/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-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>Tutorial</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/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910795398.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910795398.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910795398.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910795398.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>Tutorial</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/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f69d82d0-8730-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="1193910795398" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910767531"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781629956" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781609619"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.1193910791462.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.1193910791462.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.1193910791462.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.1193910791462.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,26 @@
+<?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>Lenya Tutorial articles</title>
+ </header>
+ <body>
+ <p>These tutorial articles were originally written by <a href="http://redarrow.textdrive.com/">Jon Linczak</a> and have been slightly updated.</p>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-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>Introduction</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/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910791462.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910791462.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910791462.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910791462.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>Introduction</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/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f7dd55d0-8730-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="1193910791462" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910764766"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781617797" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605228"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.1193910788233.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.1193910788233.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.1193910788233.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.1193910788233.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,120 @@
+<?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>Part 1: Understanding Lenya</title>
+ </header>
+ <body>
+ <p>In this first installment in a series of articles on Lenya, weâd like to talk about
+ what Lenya is and what approach it takes in content management, including its
+ advantages and disadvantages.</p>
+
+ <section id="history">
+ <title>History</title>
+
+ <p>Lenya was started by Michael Wechner in early 1999 as a way to document a journal on
+ pattern formation. From there, he co-started a company called
+ <a href="ext:wyona">Wyona</a> which continued to work on the project
+ until the spring of 2003, where the project was donated to the Apache Software
+ Foundation.</p>
+ </section>
+ <section id="approach">
+<title>Approach to Content Management</title>
+
+ <p>Lenyaâs approach to content management is just that: content management. While
+ <a href="http://www.textpattern.com/">some</a> CMSâs allow users to
+ change the styling of pages in the graphical interface of the application, Lenya
+ does not. Some consider this to be a big negative for Lenya, and for a large
+ institution with multiple designers and CSS developers, it can be. Weâve been
+ finding, however, as just one user that maintains the look and feel of Hiramâs
+ website, this isnât that bad. Instead of working in a webpage to update our CSS, we
+ just upload it to the server.</p>
+
+ <p>Of course, this means that the structural markup for the overall page layout is not
+ managed in Lenya either, well, at least not through the graphical user
+ interface. Instead, your page layout is done in XSL files, and when the page is
+ accessed through your web browser, the content and the XSL template merge and get
+ transformed into a valid HTML or XHTML document.</p>
+ </section>
+ <section id="goodstuff">
+<title>The good stuff</title>
+
+ <p>What grabbed our attention with Lenya was how it went about presenting your content
+ for editing. When you log in to your website through Lenya, you can click on the
+ navigation in the pages as if you were browsing your website right there. Find
+ something wrong in the text of one page as you browse? Just go to Edit -> WYSIWYG
+ Editor and youâre taken to a page where you can change the content. Save your
+ changes, then publish the updated page. Itâs incredibly easy.</p>
+
+ <p>Whatâs also nice is that the foundation of Lenya is built on XML which, of course, is
+ great news for web standards gurus who will only work with XHTML. By default,
+ Lenya uses HTML 4.0, but a quick change in one file will switch all your pages to
+ XHTML Strict. And since it relies on XML, thereâs no backend database that
+ manages this: itâs all flat XML files stored on the server. Donât get this
+ confused, however, with having the ability to connect to a database as you would
+ with any
+ <a href="http://www.php.net/">PHP</a>-type language, because Lenya can
+ definitely do this as well.</p>
+
+ <p>And as any good CMS would, information about the pages, like metadata, amongst
+ other things, can be edited for each page and is kept separate from the content on
+ the page itself. Lenya utilizes the
+ <a href="http://www.dublincore.org/">Dublin Core</a> for its metadata
+ tags in pages.</p>
+ </section>
+
+ <section id="downers">
+<title>Some downers</title>
+
+ <p>OK, so there are some downers. The terminology takes a bit of getting used to. For
+ example, âassetsâ are documents, images, or anything you want to link to in the
+ page that isnât text. Some things just donât happen by default in Lenya: they
+ require some extra programming. For example, say you add a new item in your siteâs
+ navigation, but it doesnât have a page on your website, it just links to an outside
+ site. Thereâs no nice way of doing this in the graphical interface. A login to the
+ server to edit the publicationâs sitemap will provide this functionality.</p>
+
+ <p>Also, Lenya runs on top of
+ <a href="http://cocoon.apache.org/">Apache Cocoon</a>, which is not the
+ downer, but the time required to learn it makes a lot of people give up quickly.
+
+ <a href="http://cocoon.apache.org/2.1/userdocs/concepts/index.html#Basic+Mechanisms.">
+ Pipelines</a> are the big key to understanding how a page is created in
+ Lenya, and trust me, that will take some getting used to when you want to do
+ something that doesnât fit the general site provided for you as an example. With
+ that, itâs much harder to find a company that will host Lenya for you â chances are
+ youâll need to have a server of your own.</p>
+
+ <p>One last thing for picky web developers: getting a website to have clean URLs is a
+ bit tricky. Even we have yet to get this working exactly the way we would like it to.
+ And with Lenya and clean URLs comes a much more detailed look into configurations
+ with the Apache web server than you are probably used to, which does take some
+ time.</p>
+ </section>
+ <section id="next">
+<title>Whatâs next?</title>
+
+ <p>So, you read the advantages and disadvantages and you want to take the plunge into
+ Lenya? Good, because in my next article weâll be explaining the methods we took to
+ get Lenya up and running on our RedHat Enterprise Linux server. Donât worry, you
+ wonât need this specific operating system to make Lenya work. Lenya can run on
+ pretty much any UNIX/Linux server and (even) Microsoft Windows.</p>
+ </section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-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>1. Understanding Lenya</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/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910788233.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910788233.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910788233.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910788233.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>1. Understanding Lenya</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/f912a180-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/f912a180-8730-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="1193910788233" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910771947"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781629496" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781609428"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.1193910783525.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.1193910783525.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.1193910783525.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.1193910783525.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,263 @@
+<?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>Part 2: Installing Lenya</title>
+ </header>
+ <body>
+<p>So here you are, ready to install the mysterious Lenya. If you haven't already, we encourage
+ you to take a quick gander at
+ <a href="understanding_lenya.html">Part I: Understanding Lenya</a>
+ to make sure you know what you are getting into before attempting this install. Also, some
+ knowledge in the basics of using a UNIX/Linux operating system are assumed. So without
+ further delay, let's kick it!</p>
+
+<section id="Requirements">
+<title>Requirements</title>
+
+<p>OK, we do have to mention one thing: while you can install Lenya on Windows, I'm going to be
+ taking you through a Linux installation. For Windows help, I'll have to direct you to the
+ <a href="lenya-document:653c2520-8731-11dc-ae46-9e7b5d14892d">user mailing
+ lists</a>.</p>
+
+<p>We also recommend a broadband connection, especially for downloading Cocoon (approx. 43
+ MB) and the Java SDK (approx. 35 MB), but if you want to sit around and wait while they
+ download on a phone line, be our guest!</p>
+
+<ol>
+ <li>Linux/UNIX (I'm using <a href="http://www.redhat.com/software/rhel/as/">RedHat Enterprise AS</a>, but any Linux will do)</li>
+ <li>
+<a href="http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=j2sdk-1.4.2_07-oth-JPR&SiteId=JSC&TransactionId=noreg">Java 1.4.2 SDK</a> (we downloaded the RedHat RPM)</li>
+
+ <li>
+<a href="http://cocoon.apache.org/mirror.cgi">Cocoon 2.1.7</a> (the TAR/GZ source version)</li>
+ <li>
+<a href="ext:lenya.dist">Lenya 1.2.4</a> (the tar.gz source version is what we are using, under the SOURCES directory)</li>
+ <li>(optional) <a href="http://jakarta.apache.org/site/binindex.cgi#tomcat-5.0">Tomcat 5.0.28</a> (the binary tar.gz version)</li>
+</ol>
+
+<p>Why is Tomcat optional? Well, because Lenya already comes with a servlet container called
+ Jetty. Both Jetty and Tomcat are the servlet containers tested with Lenya, and since we're
+ using Tomcat for Hiram's site, that's what I'll be taking you through. For brief
+ instructions on using Jetty, read
+ <a href="lenya-document:f696f320-8730-11dc-ae46-9e7b5d14892d">the
+ tutorial on Lenya's site</a>.</p>
+
+<p>It's also assumed that the first steps before switching to our new user in step 5 are done with
+ a user that has the capabilities of installing Java and the like. We used the root user to do
+ the installs and moves, then switched to the our new user for the rest.</p>
+</section>
+<section id="tensteps">
+<title>10 Steps to Lenya bliss</title>
+
+<section id="download">
+<title>Step 1: Download!</title>
+<p>Yeah, seems simple enough, doesn't it? Get 2-5 from above downloaded and on the server
+ you'll be using.</p>
+</section>
+<section id="installsdk">
+<title>Step 2: Install Java SDK</title>
+ <p>If you downloaded the RPM, you'll need to execute the file first. It spits out the
+ Licensing Agreement, for which you must agree to, and then your RPM file is ready. To
+ install on RedHat, type in the following:</p>
+
+ <source xml:space="preserve">rpm -ivh j2sdk-1_4_2_07-linux-i586.rpm</source>
+
+ <p>or whatever your RPM file happens to be named. This should install your Java files in
+ /usr/java/ by default. You'll also need to setup some environment variables for Java
+ in order for Tomcat to start up correctly later on. Again, these instructions are for
+ RedHat, so consult documentation for your OS if need be.</p>
+
+ <source xml:space="preserve">cd /etc/profile.d/</source>
+
+ <p>Create a new file called java.sh and fill it with the following for now:</p>
+
+ <source xml:space="preserve"> export JAVA_HOME=/usr/java/java export PATH=$PATH:$JAVA_HOME/bin export
+ CLASSPATH=$JAVA_HOME/lib:$JAVA_HOME/jre/lib/ext
+ </source>
+
+ <p>Save it and exit from the file. While we are here, let's add the rest of the environment
+ variables for the other applications. So, for Tomcat, create a new file called
+ tomcat.sh and add the following inside:</p>
+
+ <source xml:space="preserve"> export CATALINA_HOME=/usr/local/tomcat export
+ PATH=$PATH:$CATALINA_HOME/bin
+ </source>
+
+ <p>Save and exit. Then, create a new file called webapps.sh and add the following
+ inside:</p>
+
+ <source xml:space="preserve"> export LENYA_HOME=/home/webapp/web_software/lenya-1.2.4 export
+ COCOON_HOME=/home/webapp/web_software/cocoon-2.1.7 export
+ COCOON_WEBAPP=/home/webapp/web_software/cocoon-2.1.7/build/webapp
+ </source>
+
+ <p>Save and exit.</p>
+</section>
+<section id="setup_a_new_user">
+<title>Step 3: Setup a new user</title>
+<p>You'll want to create a new user that has access to all of the Cocoon, Tomcat, and Lenya files.
+ I'll call the user "webapp". In most Linux distributions, you can use the graphical tools
+ to add a new user, or if you are a die-hard command-line junkie, use the following command in
+ RedHat to add our new user:</p>
+
+<source xml:space="preserve">useradd -c "Web Applications" -m webapp</source>
+
+<p>This basically sets up a new user with the name of "Web Applications", a username of "webapp"
+ and creates a home directory (the -m switch) with the standard initialization files.</p>
+
+<p>You may want to setup a password for this user. To do that, simply do this:</p>
+
+<source xml:space="preserve">passwd webapp</source>
+
+<p>It will prompt you for the new password twice. Assuming you typed it in the same way both
+ times, you're all set! This is only basic, so if you want to add password expiration
+ options, etc., go right ahead!</p>
+</section>
+<section id="move_downloads_to_right_places">
+<title>Step 4: Move downloads to right places</title>
+
+<p>In most UNIX/Linux systems, webapp's home directory should be /home/webapp/. Inside
+ webapp's home directory, we'll create a new directory to store our source files. Let's
+ call it "web_software":</p>
+
+<source xml:space="preserve">
+mkdir /home/webapp/web_software
+chown -R webapp:webapp /home/webapp/web_software
+</source>
+
+<p>Go ahead and move both Lenya's and Cocoon's zipped up files to that directory (you'll have to
+ change to the directory that your downloaded files are stored first):</p>
+
+<source xml:space="preserve">
+mv apache-lenya-1.2.4-src.tar.gz /home/webapp/web_software/
+mv cocoon-2.1.7-src.tar.gz /home/webapp/web_software/
+</source>
+
+<p>Tomcat needs to go in /usr/local/ (at least that's the typical place for it):</p>
+
+<source xml:space="preserve">mv jakarta-tomcat-5.0.28.tar.gz /usr/local/</source>
+</section>
+<section id="change_permissions_of_files">
+<title>Step 5: Change permissions of files</title>
+<p>Now that you created that webapp user, you'll want to assign permissions to the Lenya,
+ Cocoon, and Tomcat files to webapp:</p>
+
+<source xml:space="preserve">
+chown webapp:webapp /usr/local/jakarta-tomcat-5.0.28.tar.gz
+chown -R webapp:webapp /home/webapp/web_software/
+
+</source>
+
+<p>And then switch to that user:</p>
+
+<source xml:space="preserve">su - webapp</source>
+</section>
+<section id="unzip_lenya">
+<title>Step 6: Unzip Lenya</title>
+<p>Pretty easy stuff:</p>
+
+<source xml:space="preserve">
+cd web_software
+tar xzvf apache-lenya-1.2.4-src.tar.gz
+
+mv apache-lenya-1.2.4-src lenya-1.2.4
+</source>
+</section>
+<section id="unzip_and_build_cocoon">
+<title>Step 7: Unzip and build Cocoon</title>
+<p>Same deal here:</p>
+
+<source xml:space="preserve">
+tar xzvf cocoon-2.1.7-src.tar.gz
+mv cocoon-2.1.7-src cocoon-2.1.7
+</source>
+
+<p>Now, you'll need to copy some config files from Lenya into Cocoon's directory:</p>
+
+<source xml:space="preserve">
+cp lenya-1.2.4/local.build.properties cocoon-2.1.7/
+cp lenya-1.2.4/local.blocks.properties cocoon-2.1.7/
+</source>
+
+<p>Then the all-important part, compiling Cocoon. It's this simple:</p>
+
+<source xml:space="preserve">
+cd cocoon-2.1.7
+./build.sh -Dinclude.webapp.libs=yes webapp
+</source>
+</section>
+<section id="install_tomcat">
+<title>Step 8: Install Tomcat</title>
+
+<p>Since we downloaded the binary version of Tomcat, there's not much to do except to unzip the files. So here we go again:</p>
+
+<source xml:space="preserve">
+cd /usr/local/
+tar xzvf jakarta-tomcat-5.0.28.tar.gz
+</source>
+
+<p>Since that name is rather long, let's create a link to it:</p>
+
+<source xml:space="preserve">ln -s jakarta-tomcat-5.0.28 tomcat</source>
+</section>
+<section id="configure_and_install_lenya">
+<title>Step 9: Configure and install
+ Lenya</title>
+
+ <p>OK, we need to let Lenya know where Tomcat is before we install it.</p>
+
+ <source xml:space="preserve"> cd /home/webapp/web_software/lenya-1.2.4/ cp build.properties
+ local.build.properties
+ </source>
+
+ <p>Inside this file, you'll need to change a couple of things. Below are the lines you'll
+ need to change in local.build.properties, so scope them out in the file, make the
+ changes, and save them:</p>
+
+ <source xml:space="preserve"> cocoon.src.dir=../cocoon-2.1.7 tomcat.home.dir=/usr/local/tomcat
+ enable.uploads=true
+ </source>
+
+ <p>Once done, we'll need to compile:</p>
+
+ <source xml:space="preserve">./build.sh install</source>
+</section>
+<section id="start_up_tomcat">
+<title>Step 10: Start up Tomcat</title>
+<p>To start Tomcat, simply type in the following:</p>
+
+<source xml:space="preserve">/usr/local/tomcat/bin/startup.sh</source>
+ </section>
+<section id="getting_your_first_access_to_lenya">
+<title>Getting your first access to Lenya</title>
+<p>Now that Tomcat is up, you should be able to access Lenya pretty easily. Just go to the
+ following URL: http://your.server.url:8080/lenya/. You should see a couple of
+ publications listed on the left with general information about Lenya. From there, you can
+ log into the Default Publication with the username "lenya" and the password "levi".</p>
+</section>
+</section>
+<section id="next_article">
+<title>Next Article</title>
+<p>Now that you have the basic installation done, play around and have some fun. In the next
+ article, we'll take a look at how pages are created, published, and customized by changing
+ some of the files in the Default Publication as well as creating our own pipeline.</p>
+</section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-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>2. Installing Lenya</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/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910783525.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910783525.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910783525.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910783525.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>2. Installing Lenya</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/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/fa46b4b0-8730-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="1193910783525" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910768407"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781617854" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781605374"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.1193910790681.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.1193910790681.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.1193910790681.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.1193910790681.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,251 @@
+<?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>Part 3: Anatomy of the pipeline</title>
+ </header>
+ <body>
+ <p>With Lenya installed, you're itching to figure out how to get around this thing so
+ you can start creating a website. But, you want to put it all together the way
+ you're used to. Well, bring out the frozen dinners, because this is not your
+ momma's cooking. Instead of opening up a file, adding our HTML, and throwing in
+ some CSS, we'll be working with pipelines, XML, XSLT to get the job done.</p>
+
+ <section id="what_are_pipelines">
+<title>What are pipelines?</title>
+
+ <p>Pipelines aren't a Lenya thing - it's a Cocoon thing. If you want to master Lenya,
+ you'll have to get your hands around Cocoon, and that's not an easy thing. Let me
+ remind you that the articles we write here are not because I'm an expert in Lenya or
+ Cocoon. Far from it. But, we have learned some things along the way that we see being
+ asked over and over, so we think it's important to keep the open-source spirit
+ alive and document what I've learned.</p>
+
+ <p>OK, so back to pipelines. Pipelines are basically part of a set of items that can be
+ found in a sitemap of your publication, which include the components, views,
+ resources, etc. We'll save all those for another time. Pipelines are a way to
+ match a request coming to your publication and act on them in some way. So, for
+ example, if you are accessing a particular page within your publication using
+ your web browser, a pipeline can find a match for that request and possibly send
+ back a page for you to view.</p>
+
+ </section>
+<section id="minimum_requirements">
+<title>Minimum Requirements</title>
+
+ <p>For a pipeline to work, you'll need to match an incoming request, generate
+ something to be used, and then send it back in a format that is recognizable and can
+ be dealt with easily. Here's an example pipeline:</p>
+
+ <source xml:space="preserve">
+ 1. <map:pipeline>
+ 2. <map:match pattern="example">
+ 3. <map:generate type="file" src="example.xml"/>
+ 4. <map:serialize type="xml"/>
+ 5. </map:match>
+ 6. </map:pipeline>
+ </source>
+
+ <p>Let's walk through this line by line. Line 1 starts the definition of the pipeline.
+ Everything starts with "map:" because all of this XML is part of the map namespace
+ defined by Cocoon. Line 2 tries to match an incoming request to see if it looks like
+ "example". If it does, we keep going. If not, this pipeline gets skipped over.
+ Line 3 is the generator. In this case, we'll be generating "stuff" from a file, and
+ that file is example.xml. So, what do we do with this stuff inside the file? Well,
+ we need to send it back to the user making the request for "example" in something
+ they (or it) can understand. In line 4, we're doing just that by using a serializer
+ to take all that stuff in example.xml and sending back to the user as XML.</p>
+
+ </section>
+<section id="how_about_something_more_usable">
+<title>How about something more usable?</title>
+
+ <p>OK, admittedly, that was a boring example. The file was already XML, so the only
+ thing the serializer did was probably add in our declaration at the top of the page
+ and send it back to the user. Let's add in some spice and relate it to web pages:</p>
+
+ <source xml:space="preserve">
+ 1. <map:pipeline>
+ 2. <map:match pattern="test.html">
+ 3. <map:generate type="file" src="test.xml"/>
+ 4. <map:transform type="xslt" src="test2html.xsl"/>
+ 5. <map:serialize type="html"/>
+ 6. </map:match>
+ 7. </map:pipeline>
+ </source>
+
+ <p>OK, so here, we're trying to match the request for test.html. Now, keep in mind, it
+ could very well be that test.html doesn't exist (and in this case it doesn't).
+ That's OK - we're just matching requests for something, and in return, we can send
+ back whatever we like. Think of it as a virtual link to another file we're creating
+ on the fly.</p>
+
+ <p>So, if we do match test.html, we'll grab the contents of the file test.xml, but
+ before we send it back, we'll transform that XML into something else using the
+ transformer (line 4). Using XSLT, we can convert that batch of XML into an HTML
+ page! That's done using the file test2html.xsl. When that's all said and done,
+ off we go to serialize it back to the user, but this time as HTML instead of XML.</p>
+
+ <p>We won't have time to show you how the XSL transformation works, but we can throw you
+ over to
+ <a href="http://www.w3schools.com/xsl/xsl_languages.asp">
+ W3Schools</a> and they'll give you a nice intro.</p>
+
+ </section>
+<section id="the_lenya_pipeline">
+<title>The Lenya pipeline</title>
+
+ <p>So now that we know the basics, how does Lenya use the pipeline in creating it's
+ pages? Well, it's not too much different. While it looks more complicated, the
+ basics are still there.</p>
+
+ <p>Below is the pipeline that is used in the publication-sitemap.xmap file in
+ Lenya's default publication:</p>
+
+ <source xml:space="preserve">
+ 1. <map:pipeline>
+ 2. <!--/lenyabody-{rendertype}/{publication-id}/{area}/{doctype}/{url}-->
+ 3. <map:match pattern="lenyabody-*/*/*/*/**">
+ 4. <map:aggregate element="cmsbody">
+ 5. <map:part src="cocoon://navigation/{2}/{3}/breadcrumb/{5}.xml"/>
+ 6. <map:part src="cocoon://navigation/{2}/{3}/tabs/{5}.xml"/>
+ 7. <map:part src="cocoon://navigation/{2}/{3}/menu/{5}.xml"/>
+ 8. <map:part src="cocoon://navigation/{2}/{3}/search/{5}.xml"/>
+ 9. <map:part src="cocoon:/lenya-document-{1}/{3}/{4}/{page-envelope:document-path}"/>>
+ 10.</map:aggregate>
+ 11.<map:transform src="xslt/page2xhtml-{4}.xsl">
+ 12.<map:parameter name="root" value="{page-envelope:context-prefix}/{2}/{3}"/>
+ 13.<map:parameter name="url" value="{5}"/>
+ 14.<map:parameter name="document-id" value="{page-envelope:document-id}"/>
+ 15.<map:parameter name="document-type" value="{page-envelope:document-type}"/>
+ 16.</map:transform>
+ 17.<map:select type="parameter">
+ 18.<map:parameter name="parameter-selector-test" value="{1}"/>
+ 19.<map:when test="view">
+ 20.<map:transform type="link-rewrite"/>
+ 21.</map:when>
+ 22.</map:select>
+ 23.<map:serialize type="xml"/>
+ 24.</map:match>
+ 25.</map:pipeline>
+ </source>
+
+ <p>OK, yikes, we know what you're thinking. But seriously, it's not that bad. We still
+ open with a pipeline tag, we match something, we have this aggregation part which
+ I'll explain in a minute, we transform the results, and after another part I'll
+ explain, we serialize the results back the user. Let's start with the
+ matcher.</p>
+
+ </section>
+<section id="the_matcher">
+<title>The Matcher</title>
+
+ <p>So, um, what exactly are we matching? Without going into too much and getting you
+ swamped with terminology, we're basically trying to match a whole bunch of
+ things at once. The comment right above the matcher tries to tell you what each of
+ the asterisks are. There's the rendertype (whether you're viewing the page, or
+ editing it), the publication ID (which in this case is "default" for the Default
+ Publication), the area (it could be Authoring, or Live, or Admin, etc.), the
+ document type, and the actual URL of the document.</p>
+
+ <p>The document type is pretty interesting. In XML, one document could be for
+ describing a shape, while another could be describing a set of books. It doesn't
+ have to be that way, though. For example, the "homepage" and "xhtml" doctypes
+ provided for you in Lenya are exactly the same, except there's another pipeline
+ that says the top index.html page of the publication will be assigned the doctype
+ of "homepage". It's handy because since most homepages have a different design
+ that the secondary or tertiary pages, you can use a different XSLT file to
+ transform it however you want without having to setup a new pipeline for it. Just
+ think of the possibilities with different doctypes...</p>
+
+ </section>
+<section id="the_aggregator">
+<title>The Aggregator</title>
+
+ <p>So, after we've matched all of those options (the asterisks mean anything and
+ everything), we get to this aggregate tag. Basically, it's a generator like we
+ saw in the previous examples, it's just aggregating the results of the
+ generation from all these sources together as one.</p>
+
+ <p>So, Lenya separates out the menu (or navigation of the site), the tabs (all the
+ high-level items in the navigation), the breadcrumb trails on the pages, the
+ search box, and the actual content of the page into separate files. See all those
+ {2}'s, {3}'s, and {5}'s? Each one of those points to the value for that numbered
+ asterisk in the matcher. So, whatever happened to have been in the second
+ asterisk in the matcher, we use that in place of {2}. Simple, no?</p>
+
+ </section>
+<section id="the_transformer">
+<title>The Transformer</title>
+
+ <p>The transformer is pretty straight-forward. We transform the results of all the
+ aggregated content using the file page2xhtml-{4}.xsl. Except, the {4} is
+ replaced with whatever was in the place of the fourth asterisk, or in this case,
+ the doctype. So, if our doctype was "homepage", we would transform our page using
+ the XSL file page2xhtml-homepage.xsl. If our doctype were "xhtml" (which is
+ what most of the pages are in Lenya), then you would transform it with
+ page2xhtml-xhtml.xsl. See how you can differentiate the design with different
+ transformations and doctypes?</p>
+
+ <p>The parameters inside of the transform tag are basically setting up variables to
+ be passed to the XSL file. In this case, we're passing along the root location of
+ the publication (perhaps it's just a / in http://www.someplace.com/, for
+ example), the URL of the publication (like "some/where.html"), as well as the
+ document ID (the latter half of the URL without the .html extension), and the
+ doctype.</p>
+
+ </section>
+<section id="the_selector">
+<title>The Selector</title>
+
+ <p>We haven't seen this one yet, but think of the selector as an if/else statement. You
+ have to tell the selector what you are testing against, then test it against some
+ value, and do something. In this case, we're testing the rendertype (that's the
+ first asterisk, or {1}). If the rendertype is "view", as in we're viewing the page
+ and not editing it, then go through one more transformation, called
+ link-rewrite.</p>
+
+ <p>The link-rewrite transformer basically checks where you are, then goes through
+ the contents of the page and rewrites all links in relation to what area you are in.
+ For example, if we are in the Authoring environment in Lenya, then our links could be
+ rewritten to look like "/lenya/default/authoring/some/where.html". If we are
+ in the Live area, they would be rewritten to look like
+ "/lenya/default/live/some/where.html". That way, you just keep track of the
+ organization of the site using the Site tab within Lenya, and Lenya will rewrite
+ your links according to what area you are in when viewing the page so that it all
+ just works!</p>
+
+ </section>
+<section id="the_serializer">
+<title>The Serializer</title>
+
+ <p>In the end, we serialize everything we've done into XML. So, why XML? Because it's
+ later on in the series of pipelines that the results are serialized again into
+ HTML (or XHTML, if you so choose).</p>
+
+ </section>
+<section id="fin">
+<title>Fin</title>
+
+ <p>So hopefully that gets you cracking on understanding how Lenya is setup to handle
+ pages. There's no doubt we've exposed you to quite a bit that deserves more
+ explanation, and it will certainly come.</p>
+ </section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-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>3. Anatomy of the Pipeline</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/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910790681.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910790681.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910790681.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910790681.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>3. Anatomy of the Pipeline</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/fb726370-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/fb726370-8730-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="1193910790681" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910764065"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633814" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781612541"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.1193910792745.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.1193910792745.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.1193910792745.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.1193910792745.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,145 @@
+<?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>Part 4: Editing in Lenya</title>
+ </header>
+ <body>
+ <p>There are several editors that you can use in Lenya, but because we only have used 2 of
+ them, these are the ones we will briefly go over here.</p>
+
+ <section id="Kupu">
+<title>Kupu</title>
+
+ <p>
+<a href="ext:kupu">Kupu</a> is a WYSIWYG editor that was developed through <a href="ext:oscom">OSCOM</a> and has been integrated
+ into Lenya. The editor is quite simple to use, and has an aggressive timeline for
+ future improvements. You can see a screenshot of Kupu in action below:</p>
+
+ <p>
+<img alt="kupu" src="lenya-document:68002720-8731-11dc-ae46-9e7b5d14892d"/>
+</p>
+
+ <p>When you
+ <a href="installing_lenya.html">install Lenya</a>, you'll
+ notice that when you try to edit a page in your publication using it, you'll get a
+ message stating to build it before you can use it. You'll need to go to Kupu's main
+ directory and type make to build it properly:</p>
+
+ <source xml:space="preserve">
+ cd /usr/local/tomcat/webapps/lenya/lenya/resources/kupu
+ make
+ </source>
+
+ <p>You may get an error stating that the build could not be completed successfully
+ because it could not find xsltproc. If this is the case, you'll need to download
+ the xsltproc package and install it before continuing. Since we are using RedHat
+ Linux, we'll give you the steps for installing the RPM. Adapt the instructions for
+ your own OS.</p>
+
+ <p>First off, check to see if you have the proper RPMs:</p>
+
+ <source xml:space="preserve"> rpm -qa | grep libxml2 rpm -qa | grep libxslt</source>
+
+ <p>If nothing is returned for either one of them (or both), then there's two ways to
+ download the proper RPMs. One is by using RPMFind. Go to these URLs:</p>
+
+ <ul>
+ <li>
+ <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxml2">
+ http://rpmfind.net/linux/rpm2html/search.php?query=libxml2</a>
+ </li>
+ <li>
+ <a href="http://rpmfind.net/linux/rpm2html/search.php?query=libxslt">
+ http://rpmfind.net/linux/rpm2html/search.php?query=libxslt</a>
+ </li>
+
+ </ul>
+
+ <p>Look for your OS and download the appropriate RPM. Once downloaded to your server,
+ install the packages:</p>
+
+ <source xml:space="preserve">
+ rpm -ivh libxml2-2.5.10-7.i386.rpm
+ rpm -ivh libxslt-1.0.33-5.i386.rpm
+ </source>
+
+ <p>The version numbers are probably different from the latest. Just be sure you get
+ the latest versions of each.</p>
+
+ <p>The second way is if you use RedHat's up2date program (you must be registered with
+ RedHat). To use this, just run the following command:</p>
+
+ <source xml:space="preserve">
+ up2date --showall | grep libxml2
+ up2date --showall | grep libxslt
+ </source>
+
+ <p>Once the package names are found, you can download them from the up2date server
+ like so:</p>
+
+ <source xml:space="preserve">
+ up2date --get libxml2-2.5.10-7.i386
+ up2date --get libxslt-1.0.33-5.i386
+ </source>
+
+ <p>The RPMs will be stored in /var/spool/up2date/. Go there, then install them as
+ mentioned above (recapped below as well):</p>
+
+ <source xml:space="preserve">
+ rpm -ivh libxml2-2.5.10-7.i386.rpm
+ rpm -ivh libxslt-1.0.33-5.i386.rpm
+ </source>
+
+ <p>Those that are savvy with up2date can find a more efficient way to install these
+ RPMs, but this will do for now. Once the RPMs are installed, go back to Kupu's
+ directory and run make as mentioned above. Now you're ready to edit using
+ Kupu!</p>
+
+ </section>
+<section id="bxe">
+<title>BXE</title>
+
+ <p>Bitflux Editor (<a href="ext:bxe">BXE</a>) is another WYSIWYG editor that was developed separately from Lenya and
+ integrated into the project. BXE's approach is slightly different from
+ Kupu's in that from the visual standpoint, it appears as if you are editing the
+ content right on the layout of the page. Kupu, from the screenshot above, gives
+ you a whole new page that focuses just on the content. We'll let you work with either
+ one and decide which is your favorite. Hiram College chose to use Kupu, not
+ because BXE was worse, but because Kupu was more flexible and easier to
+ understand for the faculty and staff that were using it. Below is a screenshot of
+ BXE at work:</p>
+
+ <p>
+<img alt="bxe" src="lenya-document:67f355e0-8731-11dc-ae46-9e7b5d14892d"/>
+</p>
+
+ <p>In version 1.2.4, BXE is already installed and ready to go, so there's no need
+ for any added configuration.</p>
+
+ </section>
+<section id="next_articles">
+<title>Next articles</title>
+
+ <p>Well, we wanted to keep this one short, as we are working on cooking up some more heftier
+ articles, including customizing your navigation and an intro to doctypes and
+ usecases.</p>
+ </section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-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>4. Editing in Lenya</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/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910792745.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910792745.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910792745.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.meta.1193910792745.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>4. Editing in Lenya</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/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/fca6ebd0-8730-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="1193910792745" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765928"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781627221" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781606466"/>
</XPSRevisionControl>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org