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 [2/37] - in /lenya/sandbox/pubs/docu/content/authoring:
0033e320-8731-11dc-ae46-9e7b5d14892d/ 003a4bc0-8731-11dc-ae46-9e7b5d14892d/
018a9980-8731-11dc-ae46-9e7b5d14892d/ 02f9e0f0-8731-11dc-ae46-9e7b5d14892d/
043dd2a0-8731-11dc-ae46-...
Added: lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.1193910780977.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.1193910780977.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.1193910780977.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.1193910780977.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,158 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!-- $Id: 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 6b: mod_proxy and Lenya</title>
+ </header>
+ <body>
+ <p>One thing to note about the previous article: the last statement is indeed correct
+ if you don't make any changes to the publication.xconf file in the "config"
+ directory of your default publication. However, if you update it according to
+ the
+ <a href="http://wiki.apache.org/lenya/HowToModProxy">
+ HowToModProxy</a> document, after login, you'll be taken back to a non-SSL
+ connection for the rest of your editing.</p>
+
+ <p>OK, now that the Authoring environment has been setup, we need to finish the Live
+ server setup.</p>
+
+ <section id="live_environment">
+<title>Live environment</title>
+
+ <p>The live environment, at least for this setup, is remarkably similar. Since
+ we're using the same Apache instance but a different IP address, just setup
+ another NameVirtualHost directive with the new IP address. We'll assume
+ that for every publication in Lenya, that will be a directory under our
+ domain name. So, say we have the following publications in our pubs
+ directory:</p>
+
+ <source xml:space="preserve">
+ default -> Default Publication
+ weblog -> Lenya Weblog</source>
+
+ <p>Then we want to access them this way:</p>
+
+ <source xml:space="preserve">
+ http://www.client.com/default/
+ http://www.client.com/weblog/</source>
+
+ <p>In the end, our setup for the live server should look like this:</p>
+
+ <source xml:space="preserve">
+ NameVirtualHost 192.168.1.200:80
+
+ <VirtualHost 192.168.1.200:80>
+ ServerName www.client.com
+ ServerAlias www
+ ProxyRequests Off
+ RewriteEngine On
+ RewriteLog logs/www.client.com.rewrite.log
+ RewriteLogLevel 0
+ RewriteRule ^/([^/\.]+)$ $1/ [R]
+ RewriteRule ^/([^/\.]+)/$ $1/index.html [R]
+ RewriteRule ^/([^/\.]+)/live/(.*)$ $1/$2 [R,L]
+
+ # Rewrite for Lenya-wide resources (e.g. 404 page)
+ RewriteRule ^/lenya/(.*) http://www.client.com:8080/lenya/$1 [P]
+ RewriteRule ^/([^/\.]+)/(.*) http://www.client.com:8080/$1/live/$2 [P]
+ ProxyPassReverse / http://www.client.com:8080/
+ </VirtualHost>
+
+ <VirtualHost 192.168.1.200:443>
+ ServerName www.client.com
+ ServerAlias www
+ ProxyRequests Off
+ RewriteEngine On
+ RewriteLog logs/ssl.www.client.com.rewrite.log
+ RewriteLogLevel 0
+ RewriteRule ^/([^/\.]+)$ $1/ [R]
+ RewriteRule ^/([^/\.]+)/$ $1/index.html [R]
+ RewriteRule ^/([^/\.]+)/live/(.*)$ $1/$2 [R,L]
+
+ # Rewrite for Lenya-wide resources (e.g. 404 page)
+ RewriteRule ^/lenya/(.*) http://www.client.com:8080/lenya/$1 [P]
+ RewriteRule ^/([^/\.]+)/(.*) http://%{SERVER_NAME}:8080/$1/live/$2 [P]
+ ProxyPassReverse / http://www.client.com:8080/
+ </VirtualHost>
+ </source>
+
+ <p>So, what's going on here? Well, to use the non-SSL virtualhost as an example,
+ we're simply matching for any directory and mapping it to it's live
+ counterpart. We add the rewrite for the 404 page (remember, this
+ installation is under the ROOT context, so some of the "lenya" directories
+ are missing) and then reverse proxy it to port 8080 as usual. Now, if you go to
+ http://www.client.com/default/, you get taken to the live site for the
+ default publication.</p>
+
+ <p>There are some things that aren't good about this. For one, it doesn't take
+ into account the root directory (i.e., http://www.client.com/). It will
+ be served by Apache in the DocumentRoot instead of through Lenya. That may be
+ what you're looking for, but my guess is that your publications won't
+ directly match to their URLs. No problems - just be more specific. If you
+ wanted to map the http://www.client.com/ URL to the default publication,
+ then just use this instead:</p>
+
+ <source xml:space="preserve">
+ RewriteRule ^/$ index.html [R]
+ RewriteRule ^/default/live/(.*)$ $1 [R,L]
+ RewriteRule ^/(.*) http://www.client.com:8080/default/live/$1 [P]
+ </source>
+
+ <p>Then reverse proxy as always. In configurations we've used, we just list each
+ publication we have that maps to a URL, so we know for certain that we are matching
+ everything we want to.</p>
+
+ </section>
+<section id="modifying_the_publication_proxy_configuration">
+ <title>Modifying the publication proxy configuration</title>
+
+ <p>There's one last thing that you'll want to do, and that's modifying the default
+ proxy settings in the publication's files itself so that you can switch between
+ SSL and non-SSL encrypted pages with ease. The start of the
+ <a href="http://wiki.apache.org/lenya/HowToModProxy">
+ HowToModProxy</a> document, as mentioned before, shows how to do this
+ really well. Using the
+ example above where the publications relate to their web address:</p>
+
+ <source xml:space="preserve">
+ <proxy url="https://www.client.com/default" ssl="true" area="live"/>
+ <proxy url="http://www.client.com/default" ssl="false" area="live"/>
+ <proxy url="https://lenya.client.com/default" ssl="true" area="authoring"/>
+ <proxy url="http://lenya.client.com/default" ssl="false" area="authoring"/>
+ </source>
+
+ <p>WARNING! we haven't tried the above configuration because we don't have the
+ necessary resources to test it properly. Hopefully someone will test it and get
+ back to us on the results. According to the documentation on Lenya's website, it
+ should be correct.</p>
+
+ </section>
+ <section id="this_concludes_the_test_of_the_emergency_broadcast_system">
+ <title>This concludes the test of the emergency broadcast system</title>
+
+ <p>Well, that's it. There's obviously more that you can play with when it comes to
+ mod_proxy and general URLs, but we hope this is a springboard for more ideas and a
+ place to gather more resources on the subject. If you're ever stuck on mod_proxy
+ in general, you can visit
+ <a href="http://httpd.apache.org/docs-2.0/mod/mod_proxy.html">
+ Apache's documentation</a> on the subject, and as always, a post to the
+ Lenya user <a href="lenya-document:653c2520-8731-11dc-ae46-9e7b5d14892d">mailing list</a> will most likely yield some answers.</p>
+ </section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov 2 03:57:25 2007
@@ -1,11 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>6b. Mod Proxy and 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/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780977.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780977.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780977.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910780977.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>6b. Mod Proxy and 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/0033e320-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/0033e320-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov 2 03:57:25 2007
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910780977" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766365"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781633474" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781611862"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.1193910783593.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.1193910783593.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.1193910783593.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.1193910783593.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/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov 2 03:57:25 2007
@@ -1,11 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>How-To</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/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783593.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783593.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783593.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910783593.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>How-To</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/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/003a4bc0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov 2 03:57:25 2007
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910783593" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910768437"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781621363" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781610030"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.1193910794394.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.1193910794394.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.1193910794394.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.1193910794394.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,607 @@
+<?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>Frequently Asked Questions</title>
+ </header>
+ <body>
+ <ol>
+ <li>
+ <a href="#head-5db5277b98942661b1969971b6efc9174422a105">Errors</a>
+ <ol>
+ <li>
+<a href="#head-0373b4b0a56b6bc690e427f6fb5f2735d7069b27">I get an error
+ or an exception, where can I look at, what should I do?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-abfa1b062bbdbc047382217da6831202617d497d">General Lenya
+ capabilities</a>
+ <ol>
+ <li>
+<a href="#head-87f6d9cc7f4ad578df61301614a51bb0e897d1fb">Can a local
+ Lenya instance generate a site that is deployed on a remote hosting
+ service?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-462496b77b10044784689a329b76fd6a0e29a3d9">Installation, Setup,
+ Virtual hosts etc.</a>
+ <ol>
+ <li>
+<a href="#head-ca2f8178bd31ced88f4843c3af3055da6f48ea58">I have already
+ deployed cocoon in my servlet engine. Can I install Lenya in
+ parallel?</a>
+</li>
+ <li>
+<a href="#head-779e3973a215ee2b8959fed75524e04b3de26ad8">Can lenya be
+ integrated into a virtual hosting environment?</a>
+</li>
+ <li>
+<a href="#head-10c56d9e26be7fc0448fc93223ba0c98ee735325">Do I need to
+ create a Lenya install for each virtual server?</a>
+</li>
+ <li>
+<a href="#head-251a91fa7416b9f0ef45df8a0e94d08eca719769">Is there a way
+ to create multiple sites accessible via various methods of access control
+ (based on who owns them)?</a>
+</li>
+ <li>
+<a href="#head-be840ede2e55659bcd0df23be98ca6027fcd9b21">How do I
+ enable email notifications?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-427120a2ec8ce5593f2867a0d499dc7038e3d2fd">Running Lenya</a>
+ <ol>
+ <li>
+<a href="#head-b72382ba8f6f242dbf7a7a0fee47eab6cc630b3a">Lenya CMS ui
+ tabs are not displayed, whats wrong?</a>
+</li>
+ <li>
+<a href="#head-8600110d3f153b59ee0fd5487a71a88a7122b615">I can't run
+ the lenya.sh script in a linux shell.</a>
+</li>
+ <li>
+<a href="#head-7bebb8181baceb522ec7176d0c715e5f4a4a3cd8">Why do I get
+ an "illegal cookie" warning with all the lenya reference sites using
+ Opera?</a>
+</li>
+ <li>
+<a href="#head-3cdc782ad18f5328dd583a712e506756bbe14bf7">I get a
+ error:</a>
+</li>
+ <li>
+<a href="#head-ce80d1aef0ad610871c0d1c1ec2ce21c6f18d43d">How can I
+ create new users?</a>
+</li>
+ <li>
+<a href="#head-5776aeb902ec6b66c8f0c773045e4a49fdd72e57">When using
+ Lenya, a blank page occurs.</a>
+</li>
+ <li>
+<a href="#head-9c9338aa4978e7189a98777c0b0cc041a2f88983">I get a
+ "Connection timed out" errors such as
+ "org.apache.cocoon.ProcessingException: Unable to get transformer handler
+ for cocoon://scheduler/default/xxx"</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-073bd0a8a39ff624f3505381f4c7c7bb24bf53db">Document Types
+ (short: Doctypes)</a>
+ <ol>
+ <li>
+<a href="#head-aa106303b52e0aa5703d1e505844420580923d54">Where can I
+ find lenya-documentation about the exact meaning of:</a>
+</li>
+ <li>
+<a href="#head-3f16c460f9acf75d805b9754dd7fc0f2812a1e9a">How to create
+ a new document type?</a>
+</li>
+ <li>
+<a href="#head-8143b677e57e642774dc8db8cdcbc06a63ac9478">How to to use
+ my own Relax NG schema for editing documents with Bitflux in
+ Lenya?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-eed52c4e444a9486524fa902254fec7aaf28618b">File-upload</a>
+ <ol>
+ <li>
+<a href="#head-e945c9c01a86f883cac8203ed9b24917645c3c41">How can I
+ Upload XML Files?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-6e971f9ed538ab42f352a77825305fcd38eb3447">Compliance to
+ standards</a>
+ <ol>
+ <li>
+<a href="#head-6ef6323947fdd859e7c0994c91f95db530043edc">How to port
+ the default pub to XHTML?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-d4b0d0502b0debd341654fdfa20528ece35ca597">Revision Control</a>
+
+ <ol>
+ <li>
+ <a href="#head-d7ae6004b33695f696e45b752994e1b8a0f79382">How do I break a
+ lock on a document?</a>
+ <ol>
+ <li>
+<a href="#head-4e29c86a0e361916412b4708eb7e60cb22b54ebd">Background:</a>
+</li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-1942e5ee89668002b8540e44807a663ff96d4626">Edit documents</a>
+ <ol>
+ <li>
+<a href="#head-e2a3d5bd16858aac474b1c76f18229829feeb763">How can I
+ delete a document?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-18756b23c0c47e9c1df6d0c2e7eb8f1253cd802b">Asset management</a>
+
+ <ol>
+ <li>
+<a href="#head-4644e44019d408c3109df15e500307f00cbd656e">Asset upload
+ does not work. How do I enable asset uploads?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-d4c2fa687aa75c4c5e32f64aa6258850056b52e7">Fallback</a>
+ <ol>
+ <li>
+<a href="#head-4bba854b1228b7cb9a59ffd1a7d678bf5ee86513">How can I
+ provide a different authoring login page for my publication?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-1fd5cb004f70073184d31e97586ffa693be48d1c">Internationalization
+ (i18n)</a>
+ <ol>
+ <li>
+<a href="#head-19baa282c3fa086fa00d3f5eca95f90da748e27d">How do I
+ switch the default language for an existing publication?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#head-398df26ef29a65f74145baac60b42b84d8c57f7f">Editors</a>
+ <ol>
+ <li>
+<a href="#head-0a116c111e424548d1691b1ec04d7e15dcfb9ac9">BXE doesn't
+ let me insert a <h1> heading?</a>
+</li>
+ </ol>
+ </li>
+ <li>
+ <a href="#customization">Customization</a>
+ <ol>
+ <li>
+<a href="#customlogicsheets">How to Add Custom Logicsheets?</a>
+</li>
+ </ol>
+ </li>
+ </ol>
+<section>
+<title id="head-5db5277b98942661b1969971b6efc9174422a105">Errors</title>
+ </section>
+<section>
+<title id="head-0373b4b0a56b6bc690e427f6fb5f2735d7069b27">I get an error or an
+ exception, where can I look at, what should I do?</title>
+ <ol>
+ <li>
+ <p>Read this FAQ carefully</p>
+ </li>
+ <li>
+ <p>
+<a href="http://wiki.apache.org/lenya/FindPage">Search the wiki</a>
+</p>
+ </li>
+ <li>
+ <p>Search the mailing lists: <a href="ext:lenya.archive.user">
+ User</a> or <a href="ext:lenya.archive.devel">
+ Dev</a>
+</p>
+ </li>
+ <li>
+ <p>If all that fails, ask the user mailing list and provide following
+ informations:</p>
+ <ul>
+ <li>
+ <p>as possible all error output with somewhat descriptive package
+ names</p>
+ </li>
+ <li>
+ <p>what web container are you running on what system</p>
+ </li>
+ <li>
+ <p>what lenya/cocoon versions are you using</p>
+ </li>
+ <li>
+ <p>what do the error logs of your container say (eg:
+ "tomcat/logs/catalina.out" for Tomcat)</p>
+ </li>
+ <li>
+ <p>what do the error logs of lenya say, these can be found in
+ lenya/WEB-INF/logs, look here for the output of error.log</p>
+ </li>
+ </ul>
+ </li>
+ </ol>
+
+ </section>
+<section>
+<title id="head-abfa1b062bbdbc047382217da6831202617d497d">General Lenya
+ capabilities</title>
+ </section>
+<section>
+<title id="head-87f6d9cc7f4ad578df61301614a51bb0e897d1fb">Can a local Lenya instance
+ generate a site that is deployed on a remote hosting service?</title>
+ <p>Yes. Using the <a href="lenya-document:4a366ba0-8731-11dc-ae46-9e7b5d14892d">
+ StaticHTMLExporter task</a>, Lenya can generate static html, css, and other
+ supported files. Lenya maintains the directory structure of the generated site,
+ which can then be uploaded to another site.</p>
+ <p>To enable the StaticHTMLExporter task, configure the tasks.xconf file located
+ in /$PUBLICATION_DIRECTORY/$YOUR_PROJECT_NAME/config/tasks/.</p>
+ <p>Enable the StaticHTMLExporter as a sub-task of the
+ <em><task id="publish"></em> task,</p>
+<source xml:space="preserve">
+<task id="publish">
+ ....
+<task id="export" class="org.apache.lenya.cms.publishing.StaticHTMLExporter">
+ <parameter name="export-path" value="work/export/pending"/>
+ <parameter name="substitute-regexp" value="/lenya/$YOUR_PROJECT_NAME/live/"/>
+ <parameter name="substitute-replacement" value="/"/>
+ <parameter name="my-server-port" value="$THE_SERVER_PORT_RUNNING_LENYA"/>
+</task>
+</task>
+</source>
+ <p>When publishing files, the static files will be stored in the "export-path"
+ directory.</p>
+ <p>As of Lenya 1.2, this task is included in the publish task, but commented out
+ by default.</p>
+ <p>And alternative way is to use the <a href="http://cocoon.apache.org/2.1/userdocs/offline/cli.html"> Cocoon
+ CLI</a> as there may be some issues with the StaticHTMLExporter, or to call WGet
+ directly outside of lenya.</p>
+
+ </section>
+<section>
+<title id="head-462496b77b10044784689a329b76fd6a0e29a3d9">Installation, Setup,
+ Virtual hosts etc.</title>
+ </section>
+<section>
+<title id="head-ca2f8178bd31ced88f4843c3af3055da6f48ea58">I have already deployed
+ cocoon in my servlet engine. Can I install Lenya in parallel?</title>
+ <p>Yes you can.</p>
+
+ </section>
+<section>
+<title id="head-779e3973a215ee2b8959fed75524e04b3de26ad8">Can lenya be integrated
+ into a virtual hosting environment?</title>
+ <p>Yes, the probably most simple setup would be to use a standard Apache
+ webserver with mod_proxy and then connect the various "URL prefixes" to the
+ various other servers. See the <a href="lenya-document:ff0240f0-8730-11dc-ae46-9e7b5d14892d">Mod Proxy tutorial</a> for reference.</p>
+
+ </section>
+<section>
+<title id="head-10c56d9e26be7fc0448fc93223ba0c98ee735325">Do I need to create a
+ Lenya install for each virtual server?</title>
+ <p>No, you can run all publications within one servlet container context, which
+ are being called by the virtual servers within Apache for instance.<br/>
+ </p>
+
+ </section>
+<section>
+<title id="head-251a91fa7416b9f0ef45df8a0e94d08eca719769">Is there a way to create
+ multiple sites accessible via various methods of access control (based on who
+ owns them)?</title>
+ <p>Yes, with the Lenya access control framework this is no problem.</p>
+
+ </section>
+<section>
+<title id="head-be840ede2e55659bcd0df23be98ca6027fcd9b21">How do I enable email
+ notifications?</title>
+ <p>Set enabled="true" in lenya/config/notification/notification.xconf</p>
+ <p>Set the property in pubname/config/tasks/targets.xml to your smtp server
+ <property name="mail.mailhost" value="localhost"/></p>
+
+ </section>
+<section>
+<title id="head-427120a2ec8ce5593f2867a0d499dc7038e3d2fd">Running Lenya</title>
+ </section>
+<section>
+<title id="head-b72382ba8f6f242dbf7a7a0fee47eab6cc630b3a">Lenya CMS ui tabs are not
+ displayed, whats wrong?</title>
+ <p>As of Lenya 1.2, this is no longer a problem. It used to be a problem with
+ Xalan.</p>
+
+ </section>
+<section>
+<title id="head-8600110d3f153b59ee0fd5487a71a88a7122b615">I can't run the lenya.sh
+ script in a linux shell.</title>
+ <p>The lenya.sh script has DOS line breaks. Fix it like that.</p>
+ <ul>
+ <li>
+ <p>dos2unix lenya.sh</p>
+ </li>
+ <li>
+ <p>chmod +x lenya.sh</p>
+ </li>
+ <li>
+ <p>Then start it with your prefered param...</p>
+ </li>
+ </ul>
+ <p>...and lenya will work like a charm </p>
+
+ </section>
+<section>
+<title id="head-7bebb8181baceb522ec7176d0c715e5f4a4a3cd8">Why do I get an "illegal
+ cookie" warning with all the lenya reference sites using Opera?</title>
+ <p>cocoon issues a cookie containing <em>/lenya</em>. If the path to the Lenya
+ publication does conflict with the cookie-path, Opera will (rightfully)
+ complain.</p>
+
+ </section>
+<section>
+<title id="head-4d1f66d4005aa31c18293b90c01f921d7d6378d4">I get a
+ <code>java.net.URISyntaxException</code> error:</title>
+<source xml:space="preserve">
+java.net.URISyntaxException: Illegal character in path at index 21:
+file:/D:/build/Tomcat 4.1/webapps/lenya/lenya/pubs/blog/config/ac/passwd/
+</source>
+ <p>The installation path may not contain spaces: <a href="lenya-document:f696f320-8730-11dc-ae46-9e7b5d14892d"> Lenya
+ Installation Instructions</a>
+</p>
+
+ </section>
+<section>
+<title id="head-ce80d1aef0ad610871c0d1c1ec2ce21c6f18d43d">How can I create new
+ users?</title>
+ <p>Log in initially as "alice" with password "levi". Then go to the admin tab and
+ you'll see a link for users. You can then add new users and delete existing
+ ones.</p>
+
+ </section>
+<section>
+<title id="head-5776aeb902ec6b66c8f0c773045e4a49fdd72e57">When using Lenya, a blank
+ page occurs.</title>
+ <p>This could be caused by an exception which is not caught by Lenya. Look into
+ the log files of your servlet container (Tomcat) or the command line if logging
+ is not enabled.</p>
+
+ </section>
+<section>
+<title id="head-9c9338aa4978e7189a98777c0b0cc041a2f88983">I get a "Connection timed
+ out" errors such as "org.apache.cocoon.ProcessingException: Unable to get
+ transformer handler for cocoon://scheduler/default/xxx"</title>
+ <p>Make sure your machine can get a connection to itself under all its hostnames.
+ Test by pinging all hostnames. Edit your hosts file if necessary.</p>
+
+ </section>
+<section>
+<title id="head-073bd0a8a39ff624f3505381f4c7c7bb24bf53db">Document Types (short:
+ Doctypes)</title>
+ </section>
+<section>
+<title id="head-aa106303b52e0aa5703d1e505844420580923d54">Where can I find
+ lenya-documentation about the exact meaning of:</title>
+ <ul>
+ <li>
+ <p>page-envelope</p>
+ </li>
+ <li>
+ <p>document-id</p>
+ </li>
+ <li>
+ <p>document-type</p>
+ </li>
+ <li>
+ <p>context-precis</p>
+ </li>
+ <li>
+ <p>etc.</p>
+ </li>
+ </ul>
+ <p>see <a href="lenya-document:2c0b5640-8731-11dc-ae46-9e7b5d14892d">Page envelope module</a>
+</p>
+ </section>
+<section>
+<title id="head-3f16c460f9acf75d805b9754dd7fc0f2812a1e9a">How to create a new
+ document type?</title>
+ <p>See <a href="lenya-document:06bf9b80-8731-11dc-ae46-9e7b5d14892d">Adding Custom Resource Type</a>.</p>
+ </section>
+<section>
+<title id="head-8143b677e57e642774dc8db8cdcbc06a63ac9478">How to to use my own Relax
+ NG schema for editing documents with Bitflux in Lenya?</title>
+ <ul>
+ <li>
+ <p>You have to create a new document type.</p>
+ </li>
+ <li>
+ <p>You have to add the appropriate menu item.</p>
+ </li>
+ </ul>
+
+ </section>
+<section>
+<title id="head-eed52c4e444a9486524fa902254fec7aaf28618b">File-upload</title>
+ </section>
+<section>
+<title id="head-e945c9c01a86f883cac8203ed9b24917645c3c41">How can I Upload XML
+ Files?</title>
+ <p>Does Lenya have something along the lines of a form that will allow people to
+ upload XML files, have them validated, etc, then publish on a live site?</p>
+ <p>There is the one form editor (a big text area to edit XML in). Another
+ possibility is to use WebDAV to import XML files.</p>
+
+ </section>
+<section>
+<title id="head-6e971f9ed538ab42f352a77825305fcd38eb3447">Compliance to
+ standards</title>
+ </section>
+<section>
+<title id="head-6ef6323947fdd859e7c0994c91f95db530043edc">How to port the default
+ pub to XHTML?</title>
+ <p>The Default publication is validated as HTML Transitional, how to port it to
+ XHTML?</p>
+ <p>The final serialization done in pipeline is to HTML (publication-sitemap.xmap
+ line 154 ATM). You can change it to XHTML there.</p>
+
+ </section>
+<section>
+<title id="head-d4b0d0502b0debd341654fdfa20528ece35ca597">Revision Control</title>
+ </section>
+<section>
+<title id="head-d7ae6004b33695f696e45b752994e1b8a0f79382">How do I break a lock on a
+ document?</title>
+ <p>Also known as: How can manage this error: "Could not check out the file Reason
+ : The resource has already been checked out by another user"</p>
+ <p>unfortunately, currently there is no GUI way to break a lock (but have a look
+ on the Background). you have to go into
+ content/rcml/content/authoring/yourpage/index_en.xml.rcml and look at the entries
+ in there</p>
+<source xml:space="preserve">
+<!CheckOut>
+<Identity>lenya</Identity>
+<Time>1083252253647</Time>
+</!CheckOut>
+</source>
+ <p>if the most recent (the ones on top) are CheckOut and no corresponding CheckIn
+ you have a lock. you can break the lock by removing the CheckOut line.</p>
+ </section>
+<section>
+<title id="head-4e29c86a0e361916412b4708eb7e60cb22b54ebd">Background:</title>
+ <p>If you edit a document, it gets checked out. This means you telling lenya that
+ you want the exclusive right to change the document. Lenya will lock this
+ document for other users (so it cannot be edit by someone else). After you
+ finished editing the document, save it and exit the editor. By doing so the
+ document gets checked in again. This means you are telling lenya that you want to
+ drop the exclusiv right to change the document. If for some reason it does not
+ get checked in (browser crash?) the document remains locked. Log in initially as
+ "alice" with password "levi". Try to open the document (e.g. with the forms
+ editor) and hit CANCEL. Then it should be checked-in again.</p>
+
+ </section>
+<section>
+<title id="head-1942e5ee89668002b8540e44807a663ff96d4626">Edit documents</title>
+ </section>
+<section>
+<title id="head-e2a3d5bd16858aac474b1c76f18229829feeb763">How can I delete a
+ document?</title>
+ <p>To remove a document you have two options:<br/>
+ </p>
+ <ol>
+ <li>
+ <p>you can either archive it (and restore it later): In the site tab go to
+ Edit->Archive.</p>
+ </li>
+ <li>
+ <p>or you can delete it: In the site tab go to Edit->Delete</p>
+ </li>
+ </ol>
+
+ </section>
+<section>
+<title id="head-18756b23c0c47e9c1df6d0c2e7eb8f1253cd802b">Asset management</title>
+ </section>
+<section>
+<title id="head-4644e44019d408c3109df15e500307f00cbd656e">Asset upload does not
+ work. How do I enable asset uploads?</title>
+ <p>Edit the file lenya/WEB-INF/web.xml, look for "enable-uploads" and change the
+ param-value to "true". This is also a build option you can set in
+ local.build.properties.</p>
+
+ </section>
+<section>
+<title id="head-d4c2fa687aa75c4c5e32f64aa6258850056b52e7">Fallback</title>
+ </section>
+<section>
+<title id="head-4bba854b1228b7cb9a59ffd1a7d678bf5ee86513">How can I provide a
+ different authoring login page for my publication?</title>
+ <p>You've to use Fallbacks. In sitemap.xmap put the login xsl under fallback.</p>
+<source xml:space="preserve">
+ <map:match type="step" pattern="showscreen">
+ <map:generate type="serverpages" src="lenya/content/ac/login.xsp"/>
+ <map:transform src="lenya/{fallback:xslt/ac/login.xsl}">
+ <map:parameter name="publication_name" value="{page-envelope:publication-id}"/>
+ </map:transform>
+ <map:call resource="style-cms-page"/>
+ </map:match>
+</source>
+ <p>And now write your alternative login.xsl in the publication filesystem, under
+ config/ac (webapps/lenya/lenya/pubs/[pubName]/config/ac)</p>
+ </section>
+<section>
+<title id="head-1fd5cb004f70073184d31e97586ffa693be48d1c">Internationalization
+ (i18n)</title>
+ </section>
+<section>
+<title id="head-19baa282c3fa086fa00d3f5eca95f90da748e27d">How do I switch the
+ default language for an existing publication?</title>
+ <p>Go to <em>lenya/pubs/<youpubname>/config/publication.xconf</em> and move
+ the <em>default="true"</em> attribute to your default language.</p>
+ </section>
+<section>
+<title id="head-398df26ef29a65f74145baac60b42b84d8c57f7f">Editors</title>
+ </section>
+<section>
+<title id="head-0a116c111e424548d1691b1ec04d7e15dcfb9ac9">BXE doesn't let me insert
+ a <h1> heading?</title>
+ <p>This is a setting in <em>lenya/lenya/resources/misc/bxeng/contextmenu.xml</em>
+ - all tags appearing there cannot be inserted by the BXE popup menu.</p>
+ </section>
+ <section>
+ <title id="customization">Customization</title>
+ </section>
+ <section>
+ <title id="customlogicsheets">How to Add Custom Logicsheets?</title>
+ <p>Custom logicsheets can be put in <code><yourpub>/java/src</code>.</p>
+ <p>You have to add a patch file for <code>cocoon.xconf</code>, for instance <code><yourpub>/config/logicsheets.xconf</code>:</p>
+<source xml:space="preserve"><![CDATA[<xconf xpath="/cocoon/markup-languages/xsp-language/target-language[@name = 'java']"
+ unless="/cocoon/markup-languages/xsp-language/target-language[@name = 'java']/builtin-logicsheet[parameter[@name = 'prefix' and @value = 'mylogicsheet']]">
+
+ <builtin-logicsheet>
+ <parameter name="prefix" value="mylogicsheet"/>
+ <parameter name="uri" value="http://foo/bar/mylogicsheet"/>
+ <parameter name="href" value="resource://org/myproject/mylogicsheet.xsl"/>
+ </builtin-logicsheet>
+
+ ... (more logicsheets)
+
+</xconf>]]></source>
+ </section>
+ </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov 2 03:57:25 2007
@@ -1,11 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>FAQ</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/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794394.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794394.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794394.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794394.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>FAQ</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/018a9980-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/018a9980-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov 2 03:57:25 2007
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910794394" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766585"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781631902" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781610964"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.1193910788338.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.1193910788338.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.1193910788338.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.1193910788338.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,105 @@
+<?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>New Publication How-To</title>
+ </header>
+ <body>
+ <p>This how to briefly describes how to setup a new <em>empty</em> publication. Since there is no click and klack function to create new publications
+ (i.e. with a wizard) the instructions given here will focus on editing xml, xslt and xmap files
+ Although this situation will change for 2.0 (it already has a 'New Publication' wizard), at the moment threse are the steps that you should follow. </p>
+
+<p>
+<strong>Note:</strong> At the moment, you need the source distribution of Lenya to create new publications.
+ <strong>Note:</strong> All <em>http://localhost</em> URLs on this page are assuming that you use the Jetty servlet engine. </p>
+<p>Attached is a diagram of a <a href="typical-lenya-setup.pdf">typical Lenya setup</a>. </p>
+<p>First of all make a copy of the default publication and rename it (the new publication is named NEW-PUB). </p>
+
+<p>Directory structure:
+</p>
+<source xml:space="preserve">
+/home/foo/
+ lenya-1.2.x/ <- $LENYA_HOME
+ publications/ <- $PUBLICATIONS_HOME
+ NEW-PUB <- $NEW_PUB_HOME
+</source>
+<p>Linux </p>
+<source xml:space="preserve">
+cd $LENYA_HOME/src/webapp/lenya/pubs
+cp -r default $PUBLICATIONS_HOME/NEW-PUB
+</source>
+<p>Windows </p>
+<source xml:space="preserve">
+cd %LENYA_HOME%\src\webapp\lenya\pubs\
+copy -r default %PUBLICATIONS_HOME%\NEW-PUB
+
+</source>
+<p>Then follow these steps: </p>
+<ol>
+<li>
+<p>Move to <em>$NEW_PUB_HOME</em> folder and edit the <em>publication.xml</em> file in this directory to describe your new publication. Specifically, edit the <em>/lenya:publication/lenya:name</em> tag to reflect the name of your publication. </p>
+</li>
+<li>
+<p>Move to <em>$NEW_PUB_HOME/config/ac/</em> and edit <em>ac.xconf</em> changing every occurence of default to NEW-PUB; </p>
+
+</li>
+<li>
+<p>Move to <em>$NEW_PUB_HOME/config/tasks/</em> and edit <em>targets.xml</em> changing <em><property name="export.expression" value="/lenya/default/live/"/></em> to <em><property name="export.expression" value="/lenya/NEW-PUB/live/"/></em>. </p>
+
+</li>
+<li>
+<p>Deploy your publication (see <a href="lenya-document:043dd2a0-8731-11dc-ae46-9e7b5d14892d">Deploy Publication How-To</a>) </p>
+</li>
+<li>
+<p>The should then show up on the page at <em>http://localhost:8888</em>; </p>
+</li>
+<li>
+<p>Add new users using <em>http://localhost:8888/NEW-PUB/admin/users.html</em> (for security reasons it's better to remove default users or at least change passwords) If you get a Java Script error,
+check if the files under NEW-PUB have the correct permissions to be modified by your servlet engine; </p>
+
+</li>
+<li>
+<p>Delete pages of default publication leaving only the Home page available. Probably you would like to delete german pages (german is labelled with "de" string) and add your language: </p>
+<ol>
+<li>
+<p>in Authoring mode <em>http:/localhost:8888/NEW-PUB/info-authoring/index.html?lenya.usecase=info-overview&lenya.step=showscreen</em>, click on "de" tab and start removing the german pages </p>
+</li>
+<li>
+<p>edit the <em>$NEW_PUB_HOME/config/publication.xconf</em> file removing the element <em><language>de</language></em>
+ (be sure you have removed all german pages before) and eventually add you language. Pay attention, you can add your language even if there's no available translation for the Lenya CMS
+ interface (i.e. you can add "ru" for russian even if available Lenya is translated only in english or german). The servlet container has to be restarted to apply the changes to the language configuration. </p>
+
+</li>
+</ol>
+</li>
+</ol>
+<p>Optional: </p>
+<ol>
+<li>
+<p>Move to <em>$NEW_PUB_HOME/config/doctypes/samples/</em> and edit <em>xhtml.xml</em> changing the page that is shown when you create a new document. </p>
+</li>
+<li>
+<p>Start changing the look & feel of default publication to the one you want to your new publication. See: <a href="lenya-document:058805e0-8731-11dc-ae46-9e7b5d14892d">Look & Feel How-To</a> </p>
+
+</li>
+<li>
+<p>Deploy your publication when you made changes to the source. </p>
+</li>
+</ol> </body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov 2 03:57:25 2007
@@ -1,11 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>New Publication</value>
</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
<element key="extension">
<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
</element>
<element key="resourceType">
<value>forrestDocument20</value>
Added: lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910788338.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910788338.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910788338.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910788338.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>New Publication</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>
Modified: lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/02f9e0f0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov 2 03:57:25 2007
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910788338" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910761512"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781624525" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781604159"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.1193910794547.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.1193910794547.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.1193910794547.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.1193910794547.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!-- $Id: 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>Deploy Publication How-To</title>
+ </header>
+ <body>
+<p>How to deploy a publication in Apache Lenya: </p>
+
+<section>
+<title id="head-4e8484518e11290b9ee62111d0dbd603f11932df">Note:</title>
+
+<p>It is <strong>not</strong> sufficient to copy the publication directories to the <em>lenya/pubs</em> directory of your Lenya installation. This way, the core configuration files are not patched, the libraries are not deployed, and other important deployment steps are not applied.</p>
+<p>You must use the <strong>source version</strong> of lenya. The binary distributions are missing some files required for the necessary build process of your new publication.</p>
+
+</section>
+<section>
+<title id="head-25336e7dc2bcad9b79daba07afd7af57b3236a6c">Deploying a Publication</title>
+
+<ol>
+<li>
+<p>Download the publication to a directory of your choice. For instance: </p>
+<ul>
+
+<li>
+<source xml:space="preserve">
+/src
+ /lenya-1.2.x <- $LENYA_HOME
+ /projects/lenya/pubs <- $PUBS_HOME
+ /my-pub <- $MY_PUB_HOME
+ </source>
+</li>
+</ul>
+</li>
+<li>
+<p>Declare the publications in <em>$LENYA_HOME/local.build.properties</em> using <em>pubs.root.dirs</em> </p>
+
+<ul>
+<li>
+<p> For deploying a single publication, add the publication home directory:
+ <em>pubs.root.dirs=src/webapp/lenya/pubs:../../projects/lenya/pubs/my-pub</em> </p>
+</li>
+<li>
+<p> For deploying a directory containing publications, add the directory:
+ <em>pubs.root.dirs=src/webapp/lenya/pubs:../../projects/lenya/pubs</em> </p>
+</li>
+
+</ul>
+</li>
+<li>
+<p>Deploy the publication: </p>
+<ul>
+<li>
+<p> Jetty: <em>$LENYA_HOME>Â build</em> </p>
+</li>
+<li>
+<p> Tomcat: </p>
+<ol>
+<li>
+<p>
+<em>$LENYA_HOME> build install-pub</em> </p>
+
+</li>
+<li>
+<p>in case if this fails try it in a different way: <em>$LENYA_HOME> ./build.sh install-pub -Dpub.prefix=""</em> </p>
+</li>
+</ol>
+</li>
+</ul>
+</li>
+<li>
+<p>Restart the servlet engine </p>
+</li>
+<li>
+<p>Go to your Lenya homepage and enjoy the new publication </p>
+
+</li>
+</ol>
+</section>
+</body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov 2 03:57:25 2007
@@ -1,11 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Deploy Publication</value>
</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
<element key="extension">
<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
</element>
<element key="resourceType">
<value>forrestDocument20</value>
Added: lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794547.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794547.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794547.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910794547.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>Deploy Publication</value>
+</element>
+</element-set>
+<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
+<element key="extension">
+<value>xml</value>
+</element>
+<element key="mimeType">
+<value>application/xml</value>
+</element>
+<element key="resourceType">
+<value>forrestDocument20</value>
+</element>
+<element key="contentType">
+<value>xml</value>
+</element>
+</element-set>
+</metadata>
Modified: lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/043dd2a0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov 2 03:57:25 2007
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910794547" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910766752"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781620778" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781608916"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.1193910791925.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.1193910791925.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.1193910791925.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.1193910791925.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,98 @@
+<?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>Look and Feel How-To</title>
+ </header>
+ <body>
+<p>To change your copy of the Default publication into your publication and have some first successes, you probably want to work on two things: </p>
+<ol>
+<li>
+<p>Change the color scheme and fonts to your own taste. </p>
+
+</li>
+<li>
+<p>Replace the page header with your own one. </p>
+</li>
+</ol>
+<p>More advanced topics that are not (yet) covered here might be: </p>
+<ul>
+<li>
+<p> Put the menu somewhere else </p>
+</li>
+<li>
+<p> Use a different menu style </p>
+</li>
+<li>
+<p> Define different and more complex page templates </p>
+
+</li>
+</ul>
+<p>As a first step you will feel much better once you managed 1. and 2. as you will be able to show your new publication to someone and it will not look like just a sample. </p>
+
+<section>
+<title id="head-48d03a781f848cc1709f936dc346a0b04fefcb6b">Changing fonts and colors</title>
+
+<p>Fonts and colors are defined by a Cascading Style Sheet (CSS). For now, don't try to understand the nested sitemaps to find it. Go straight to $LENYA_DIR/your_pub_name/resources/shared/css/page.css. </p>
+<p>Though it says "resources/shared" this is not shared among different publications. In case you mess with it you can always go ahead and copy $LENYA_DIR/default/resources/shared/css/page.css and you are back to the original one. </p>
+<p>Make any changes, reload in your browser and you will see them. That's it for here. </p>
+<p>Note: I assume you are familiar with CSS and how to use them to create dynamically looking menus in pure HTML. If not, Google will be your best friend. This is nothing specific to Lenya.
+ For an introduction to CSS try the <a href="http://www.nypl.org/styleguide/css/"> NYPL online Style Guide</a>, for other good tutorials <a href="http://www.alistapart.com/"> a list apart</a> and for invaluable hints and quirks <a href="http://css-discuss.incutio.com/?page=FrontPage"> css-discuss</a>. </p>
+</section>
+<section>
+<title id="head-b454d82a4ed2d09ec2a591f3f24d7bf0d07e52f0">Replacing the page header</title>
+
+<p>Have a look at the file $LENYA_DIR/your_pub_name/xslt/page2xhtml.xsl and look for this piece in it: </p>
+
+<source xml:space="preserve">
+ <table width="100%" cellpadding="0" cellspacing="0" border="0">
+ <tr>
+ <td id="publication-title">Welcome to the Default Publication!</td>
+
+ <td id="project-logo"><img src="{$root}/images/project-logo.png"/></td>
+ </tr>
+ </table>
+</source>
+<p>This is the page header. Put in what you want. It's that simple! </p>
+</section>
+<section>
+<title id="head-3c25d4848127ea4921c40dfeee910b6a0216b60a">Altering navigational components (Tabs, Breadcrumbs and Menus)</title>
+
+<p>As long as it is sufficient to change the fonts and colors or navigational elements such as Breadcrumbs, Tabs oder Menus you can get away with changes to the CSS. In case you decide you want to go without some of them (for example you might not even want any breadcrumbs on your site) you can change that by modifying the XSLT as described above. </p>
+<p>But in case you want to change the <strong>behaviour</strong> of the navigational elements it's getting a bit more complex. Changing the behaviour would mean for example you would want the whole menu tree to be shown at all times, not just the top level menu items with only the subitems of the currently selected item. </p>
+<p>The navigational elements are built from the file sitetree.xml (look for it in the directory structure) using XSLTs that are usually global to Lenya and therefore not part of you publication. But the global XSLTs can be overridden with local ones quite easily. </p>
+<p>All it takes is to create the files </p>
+
+<source xml:space="preserve">
+$LENYA_DIR/lenya/pubs/__your_pub_name__/lenya/xslt/navigation/breadcrumbs.xsl
+$LENYA_DIR/lenya/pubs/__your_pub_name__/lenya/xslt/navigation/tabs.xsl
+$LENYA_DIR/lenya/pubs/__your_pub_name__/lenya/xslt/navigation/menu.xsl
+</source>
+<p>which will be used in favor of the core files </p>
+
+<source xml:space="preserve">
+$LENYA_DIR/lenya/lenya/xslt/navigation/breadcrumbs.xsl
+$LENYA_DIR/lenya/lenya/xslt/navigation/tabs.xsl
+$LENYA_DIR/lenya/lenya/xslt/navigation/menu.xsl
+</source>
+<p>Usually, you will not want to use a completely different version of the stylesheet. So it is recommended to include the core file using <em><xsl:import/></em>. </p>
+<p>This is possible because of a built-in fallback mechanism that will make Lenya use the global XSLTs in case there are no local versions inside the publication.
+ See the <a href="lenya-document:26cabb80-8731-11dc-ae46-9e7b5d14892d">Navigation Framework</a> for details on this. </p> </section>
+</body>
+</document>
Modified: lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta (original)
+++ lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta Fri Nov 2 03:57:25 2007
@@ -1,11 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<metadata xmlns="http://apache.org/lenya/metadata/1.0">
-<element-set namespace="http://apache.org/lenya/metadata/document/1.0">
-<element key="mimeType">
-<value>application/xml</value>
+<element-set namespace="http://purl.org/dc/elements/1.1/">
+<element key="title">
+<value>Look and Feel</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/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791925.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791925.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791925.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.meta.1193910791925.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>Look and Feel</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/058805e0-8731-11dc-ae46-9e7b5d14892d/en.rcml
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.rcml?rev=591298&r1=591297&r2=591298&view=diff
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.rcml (original)
+++ lenya/sandbox/pubs/docu/content/authoring/058805e0-8731-11dc-ae46-9e7b5d14892d/en.rcml Fri Nov 2 03:57:25 2007
@@ -1,5 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<XPSRevisionControl xmlns="">
+<CheckIn backup="true" identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910791925" version="2"/>
+<CheckOut identity="lenya" session="1f12dc80-8860-11dc-ba66-cfbbb816bd0d" time="1193910765032"/>
<CheckIn backup="true" identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781627433" version="1"/>
<CheckOut identity="lenya" session="60798970-8730-11dc-ae46-9e7b5d14892d" time="1193781606888"/>
</XPSRevisionControl>
Added: lenya/sandbox/pubs/docu/content/authoring/06bf9b80-8731-11dc-ae46-9e7b5d14892d/en.1193910799888.bak
URL: http://svn.apache.org/viewvc/lenya/sandbox/pubs/docu/content/authoring/06bf9b80-8731-11dc-ae46-9e7b5d14892d/en.1193910799888.bak?rev=591298&view=auto
==============================================================================
--- lenya/sandbox/pubs/docu/content/authoring/06bf9b80-8731-11dc-ae46-9e7b5d14892d/en.1193910799888.bak (added)
+++ lenya/sandbox/pubs/docu/content/authoring/06bf9b80-8731-11dc-ae46-9e7b5d14892d/en.1193910799888.bak Fri Nov 2 03:57:25 2007
@@ -0,0 +1,384 @@
+<?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>Custom Resource Type How-To</title>
+ </header>
+ <body>
+<p>This tutorial explains how to add a custom resource type to the Default publication in order to mix free page editing (as in XHTML) and constrained editing
+(as you get with a custom resource type). </p>
+
+<section>
+<title id="head-de4048d1d2761efba50bdc305d7f2afdf7a546e2">Decide if you really need a new resource type</title>
+
+<p>Introducing a new resource type where you don't need one is a time consuming and often unnecessary excercise. Therefore you should ask yourself first if you really need a new
+resource type for what you are trying to achieve or if you should be looking for other means of solving your problem. </p>
+<p>As a rule of thumb, you should use a new resource type if you are going to render documents which are fundamentally different from XHTML.
+ A resource type is all about Lenya turning an arbitraty XML document into XHTML which then will be put into the content page of your publication's page. </p>
+<p>It might make sense for example to introduce resource types for well known XML schemas such as: </p>
+<ul>
+<li> RSS</li>
+<li>
+<a href="http://docbook.sourceforge.net/">DocBook</a>
+</li>
+<li>
+<p> NewsML, SportsML, <a href="http://nitf.org/">NITF</a> or <a href="http://www.iptc.org">IPTC</a> </p>
+</li>
+<li>
+<a href="http://xmlns.com/foaf/0.1/">FOAF</a>
+</li>
+</ul>
+<p>It may also make sense to introduce resource types for custom XML schemas such as </p>
+<ul>
+<li>
+<p> the XML format you use for a catalog item in your company </p>
+</li>
+</ul>
+<p>In contrast, it is not a good idea to introduce a custom resource type if you want to render documents that are basically XHTML but just contain some non-XHTML tags such as </p>
+<ul>
+<li>
+<p> <xi:include ...> </p>
+</li>
+<li>
+<p> <ft:...> (Cocoon Form tags) </p>
+</li>
+</ul>
+<p>In this case you should rather add some extra transformers to the pipeline that renders these tags into XHTML. </p>
+
+<p>Also resource types are not XHTML templates. </p>
+
+</section>
+<section>
+<title id="head-2ee188822e061359b50250dfaaf79edb933981bc">Choose a name</title>
+
+<p>Choose a name for the resource type ID: <em>myresourcetype</em> </p>
+
+</section>
+<section>
+<title id="head-d05f4f01dd36c53247e296e75bc2f09a5d801429">Define the resource type ID</title>
+
+<p>Define the resource type ID in <em>mypub/config/doctypes/doctypes.xconf</em> Note that resource types were historically called doctypes, thus the names of the config files. </p>
+
+<source xml:space="preserve">
+<doctypes>
+ <!-- Here is the document ID -->
+ <doc type="myresourcetype">
+ <!-- if the document is allowed to have children, define what resource types they can be -->
+ <children>
+ <!-- this resource type is allowed to have xhtml and/or myresourcetype documents as children -->
+
+ <doc type="xhtml"/>
+ <doc type="myresourcetype"/>
+ </children>
+ <!-- This is the class that creates a new instance of this resource type -->
+ <creator src="org.apache.lenya.cms.authoring.DefaultBranchCreator">
+ <!-- this is the sample file that is used when creating a new instance of this resource type. Can be found in config/doctypes/samples -->
+
+ <sample-name>myresourcetype.xml</sample-name>
+ </creator>
+ <!-- These tasks here refer to ant tasks that should be called for this resource type. For instance, you can have a special publish task. -->
+ <!-- tasks are defined in mypub/config/tasks/tasks.xconf -->
+ <tasks>
+
+ <task id="publish"/>
+ </tasks>
+ <!-- Specify the workflow definition for this resource type. You can define a seperate workflow for each resource type, for instance with one or two levels of approval. -->
+ <!-- workflow process is defined in mypub/config/workflow/workflow.xml (see below) -->
+ <workflow src="workflow.xml"/>
+ </doc>
+
+</doctypes></source>
+
+</section>
+<section>
+<title id="head-cea12489d4b764632fd61dd792a9e5f90626e11e">Create the schema</title>
+
+<p>Create relax NG schema: <em>mypub/config/doctypes/schemas/myresourcetype.rng</em> </p>
+<p>Note: This is optional, but important if you want to use the form editors. If you get your XML files that you try to render as a custom resource type from
+somewhere else you can omit this step. You can also omit it if you want to create a sample document manually first to see all the rest working and come back to this point later. </p>
+<source xml:space="preserve">
+<?xml version="1.0" encoding="UTF-8"?>
+<!--+
+ | myresourcetype resource type
+ +-->
+
+<grammar ns="http://www.w3.org/1999/xhtml"
+ xmlns="http://relaxng.org/ns/structure/1.0"
+ xmlns:lenya="http://apache.org/cocoon/lenya/page-envelope/1.0"
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:dcterms="http://purl.org/dc/terms/"
+ xmlns:xhtml="http://www.w3.org/1999/xhtml"
+ >
+
+<!-- include the general lenya schema -->
+<!-- you should include the lenya schema if you want to use meta data or assets -->
+<include href="lenya.rng"/>
+
+<!-- include original XHTML transitional schema -->
+<include href="xhtml/xhtml-basic.rng">
+
+ <define name="html">
+
+ <element name="html">
+ <ref name="html.attlist"/>
+ <ref name="lenya.meta"/> <!-- this is the Lenya meta data wrapper -->
+ <ref name="head"/>
+ <ref name="body"/>
+
+ </element>
+ </define>
+
+ <define name="html.attlist">
+ <ref name="XHTML.version.attrib"/>
+ <ref name="I18n.attrib"/>
+ <ref name="dummy.attlist"/> <!-- this is deprecated -->
+
+ </define>
+
+</include>
+
+
+<!-- additional block elements -->
+<define name="Block.class" combine="choice">
+ <choice>
+ <ref name="lenya.asset"/>
+
+ </choice>
+</define>
+
+
+</grammar></source>
+<p>Note that you can generate Relax NG schemas from sample files by using <a href="http://www.thaiopensource.com/relaxng/trang.html">
+ Trang</a> or <a href="http://wwws.sun.com/software/xml/developers/relaxngconverter/"> Sun RELAX NG Converter</a> </p>
+
+</section>
+<section>
+<title id="head-ff4bce85b820a235e0f917955b004b766b9a6d41">Resource type matcher</title>
+
+<p>Add a sourcetype matcher in <em>mypub/parameter-doctype.xmap</em>
+</p>
+<source xml:space="preserve">
+<!-- This file is map:mounted from mypub/publication-sitemap.xmap -->
+
+<map:action name="sourcetype" src="org.apache.cocoon.acting.sourcetype.SourceTypeAction">
+ <sourcetype name="myresourcetype">
+
+ <document-element local-name="myroottag"/>
+ <!-- this matches the root tag -->
+ </sourcetype>
+</map:action>
+
+</source>
+<p>The parameter-doctype.xmap allows Lenya to determine the resource type of any URI. the mapping provided in here allows to mix and match resource types freely.
+ It makes use of the <a href="http://forrest.apache.org/docs/cap.html"> Source Type action</a>. There are several ways to identify a resource type,
+ such as by its root tag, the namespace of its root element or its schema. Please note that the name of the resource type you specify here is used throughout
+ Lenya as a naming convention, for instance for the resourcetype2xhtml.xsl. </p>
+
+<p>The root-tag is just the doctype within your publication (i.e., 'homepage', if you have a homepage.rng doctype definition). For more background, see:
+<a href="http://forrest.apache.org/docs/cap.html"> http://forrest.apache.org/docs/cap.html</a> </p>
+<p>For great examples of complex custom types, please also go to <a href="http://www.wyona.org"> http://www.wyona.org</a> and do a Subversion
+update to download the example publication (University of Zurich and others). </p>
+<p>Many problems with resource types not rendering correctly result from this matcher not recognizing the resource type and therefore using the default.
+So pay special attention to this. Check the overview page in the site area where it will tell you what resource type the document has. </p>
+
+</section>
+<section>
+<title id="head-efab8428b801182274861ad033341c99f13bb014">Sample File</title>
+
+<p>Add a sample file: <em>mypub/config/doctypes/samples/myresourcetype.xml</em> </p>
+<p>The sample file will be used as a template. If you create a new document with this resource type a copy of the sample file will be placed as a starting point.
+Therefore it makes sense to set some good defaults here. </p>
+<source xml:space="preserve">
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml"
+ xmlns:xhtml="http://www.w3.org/1999/xhtml"
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:dcterms="http://purl.org/dc/terms/"
+ xmlns:lenya="http://apache.org/cocoon/lenya/page-envelope/1.0"
+ xhtml:dummy="FIXME:keepNamespace" dc:dummy="FIXME:keepNamespace"
+ lenya:dummy="FIXME:keepNamespace" dcterms:dummy="FIXME:keepNamespace">
+ <lenya:meta>
+ <dc:title>dctitle</dc:title>
+
+ <dc:creator>dccreator</dc:creator>
+ <dc:subject>dcsubject</dc:subject>
+ <dc:description>An empty page for a new resource type</dc:description>
+ <dc:publisher/>
+
+ <dc:contributor/>
+ <dc:date>2004-4-6</dc:date>
+ <dc:type/>
+ <dc:format/>
+ <dc:identifier/>
+
+ <dc:source/>
+ <dc:language>en</dc:language>
+ <dc:relation/>
+ <dc:coverage/>
+ <dc:rights>dcrights</dc:rights>
+
+ </lenya:meta>
+ <head>
+ <title>Sample new resource type</title>
+ </head>
+ <body>
+
+ <h1>New resource type sample</h1>
+ <p>This sample page is the basis for pages based on this resource type</p>
+ </body>
+</html></source>
+
+</section>
+<section>
+<title id="head-e41c27c12a329ba8438e3a4b228ac2f4e0e3ccd5">Presentation</title>
+
+<ul>
+<li>
+<p> Create presentation XSLT and CSS. If the XSLT and CSS are specific to the publication, you may want to store them in <em>mypub/xslt/myresourcetype2xhtml.xsl</em>
+ and <em>mypub/resources/shared/css/myresourcetype.css</em>, respectively. Take care of the naming conventions for the XSLT files. </p>
+</li>
+<li class="gap">
+<p> Copy <em>mypub/xslt/page2xhtml-xhtml.xsl</em> to <em>mypub/xslt/page2xhtml-myresourcetype.xsl</em>. This will style your new document type
+ like your old documents. If you wish to change how the new documents look, create your own stylesheet at <em>mypub/xslt/page2xhtml-myresourcetype.xsl</em> </p>
+
+</li>
+<li class="gap">
+<p> If you wish to edit your new documents using BXE (Kupu works only with XHTML), you should place a CSS file for styling your documents in
+ <em>mypub/resources/misc/myresourcetype-bxeng.css</em> </p>
+</li>
+<li class="gap">
+<p> Add presentation pipelines in <em>mypub/sitemap.xmap</em> if you need special pipelines for your resource type </p>
+</li>
+</ul>
+<p>Make sure you understand that for your new resource type you don't need a replacement for page2xhtml.xsl but for xhtml2xhtml. The reason is this: </p>
+
+<p>Transforming a document to a page in the browser is always a two-step process, </p>
+<ol>
+<li>
+<p>Using {resourcetype}2xhtml.xsl the document (which might be any arbritary XML such as the link list, Docbook, a RSS feed, etc.) is turned into an XHTML presentation. </p>
+</li>
+<li>
+<p>This XHTML is then processed to contain nagivation, menus and the like using page2xhtml. </p>
+</li>
+<li>
+<p>The stylesheet {resourcetype}2xhtml.xsl must return a document of the form
+<em><div id="body" xmlns="http://www.w3.org/1999/xhtml"> ... </div></em>. </p>
+
+</li>
+</ol>
+<p>If you have 5 resource types in your publication, for example: </p>
+<ul>
+<li>rss</li>
+<li>
+<p> linklist </p>
+</li>
+<li>
+<p> gallery </p>
+</li>
+
+<li>
+<p> docbook </p>
+</li>
+<li>
+<p> xhtml </p>
+</li>
+</ul>
+<p>the concept would be </p>
+
+<source xml:space="preserve">
+document -> rss2xhtml.xsl --+
+document -> linklist2xhtml.xsl --+
+document -> gallery2xhtml.xsl --+---> page2xhtml.xsl -> Browser
+document -> docbook2xhtml.xsl --+
+document -> xhtml2xhtml.xsl --+
+
+</source>
+
+</section>
+<section>
+<title id="head-cb2652bbd893f7f0e164215f740a06953ffb30a1">Menus</title>
+
+<p>Configure the menus (either 1. or 2.) </p>
+
+</section>
+<section>
+<title id="head-a546c21eb7f721406e7b0fb338f2241933bb5397">Using an existing menu</title>
+
+<p>Use an existing menu and add necessary menu items </p>
+<ul>
+<li>
+<p> Edit <em>mypub/config/menus/generic.xsp</em> and add an entry for the new resource type </p>
+
+</li>
+<li>
+<p> </p>
+<source xml:space="preserve">
+...
+ <menus>
+ <menu i18n:attr="name" name="File" label="File">
+ <block>
+ <xsp:logic>
+ {
+ if (Publication.ARCHIVE_AREA.equals(area) || Publication.TRASH_AREA.equals(area)) {
+ <item><i18n:text>New Document</i18n:text></item>
+
+ }
+ else {
+ <item uc:usecase="create" uc:step="showscreen" href="?doctype=xhtml"><i18n:text>New Document</i18n:text></item>
+ <item uc:usecase="create" uc:step="showscreen" href="?doctype=myresourcetype">New "Doc type" Document</item>
+ }
+ }
+ </xsp:logic>
+
+ </block>
+...</source>
+</li>
+</ul>
+
+</section>
+<section>
+<title id="head-46fd0096d6ae1a5ed8d88f18cc135cf069164b2f">using a custom menu</title>
+
+<p>or Create a custom menu for this resource type </p>
+<ul>
+<li>
+<p> edit <em>mypub/menus.xmap</em> </p>
+
+</li>
+<li>
+<p> create a menu file <em>mypub/config/menus/myresourcetype.xsp</em> </p>
+</li>
+</ul>
+
+</section>
+<section>
+<title id="head-05d787d62a93318a4edadf14e42a300b4e41f3f3">Workflow</title>
+
+<p>(optional) define a specific workflow </p>
+<ul>
+<li>
+<p> add the workflow schema to <em>mypub/config/workflow/</em> </p>
+
+</li>
+<li>
+<p> assign the workflow schema to the resource type in <em>mypub/config/doctypes/doctypes.xconf</em> </p>
+</li>
+</ul>
+</section> </body>
+</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org