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>
lmpx.com only provides a reader for public news (NNTP) servers. It is not
affiliated with the servers or forums shown here and is not responsible for
the content of articles, which is written by their respective authors.