Google Git
Sign in
apache / lenya / a5d955479e9b18e95769f2e099895787404c4036 / . / docs / 1_2_x / how-to / faq.html
blob: 9edcf2576b4a6471545041b7680e490ba7c79304 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
<meta name="Forrest-version" content="0.9-dev">
<meta name="Forrest-skin-name" content="pelt">
<title>Frequently Asked Questions</title>
<link type="text/css" href="../../../skin/basic.css" rel="stylesheet">
<link media="screen" type="text/css" href="../../../skin/screen.css" rel="stylesheet">
<link media="print" type="text/css" href="../../../skin/print.css" rel="stylesheet">
<link type="text/css" href="../../../skin/profile.css" rel="stylesheet">
<script src="../../../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../../../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../../../skin/fontsize.js" language="javascript" type="text/javascript"></script>
<link rel="shortcut icon" href="../../../favicon.ico">
</head>
<body onload="init()">
<script type="text/javascript">ndeSetTextSize();</script>
<div id="top">
<!--+
|breadtrail
+-->
<div class="breadtrail">
<a href="http://www.apache.org/">apache</a> &gt; <a href="http://lenya.apache.org/">lenya</a><script src="../../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
</div>
<!--+
|header
+-->
<div class="header">
<!--+
|start group logo
+-->
<div class="grouplogo">
<a href=""><img class="logoImage" alt="Lenya" src="../../../images/apache-lenya-light.png" title=""></a>
</div>
<!--+
|end group logo
+-->
<!--+
|start Project Logo
+-->
<div class="projectlogo">
<a href=""></a>
</div>
<!--+
|end Project Logo
+-->
<!--+
|start Search
+-->
<div class="searchbox">
<form action="http://www.google.com/search" method="get" class="roundtopsmall">
<input value="lenya.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with ');" size="25" name="q" id="query" type="text" value="Search the site with ">&nbsp;
<input name="Search" value="Search" type="submit">
</form>
</div>
<!--+
|end search
+-->
<!--+
|start Tabs
+-->
<ul id="tabs">
<li>
<a class="unselected" href="../../../index.html">Project</a>
</li>
<li>
<a class="unselected" href="../../../docs/index.html">Developer</a>
</li>
<li>
<a class="unselected" href="../../../community/index.html">Community</a>
</li>
<li>
<a class="unselected" href="../../../docs/2_0_x/index.html">Version 2.0</a>
</li>
<li class="current">
<a class="selected" href="../../../docs/1_2_x/index.html">Version 1.2</a>
</li>
</ul>
<!--+
|end Tabs
+-->
</div>
</div>
<div id="main">
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
<div id="level2tabs"></div>
<!--+
|end Endtabs
+-->
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<!--+
|breadtrail
+-->
<div class="breadtrail">
&nbsp;
</div>
<!--+
|start Menu, mainarea
+-->
<!--+
|start Menu
+-->
<div id="menu">
<div onclick="SwitchMenu('menu_selected_1.1', '../../../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../../../skin/images/chapter_open.gif');">Version 1.2</div>
<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="../../../docs/1_2_x/index.html">Index</a>
</div>
<div onclick="SwitchMenu('menu_1.1.2', '../../../skin/')" id="menu_1.1.2Title" class="menutitle">Installation</div>
<div id="menu_1.1.2" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/installation/index.html">Download</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/installation/subversion.html">Subversion Access</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/installation/source_version.html">Install Instructions</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.3', '../../../skin/')" id="menu_1.1.3Title" class="menutitle">Tutorial</div>
<div id="menu_1.1.3" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/index.html">Introduction</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/understanding_lenya.html">1. Understanding Lenya</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/installing_lenya.html">2. Installing Lenya</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/anatomy_of_the_pipeline.html">3. Anatomy of the Pipeline</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/editing_in_lenya.html">4. Editing in Lenya</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/custom_navigation.html">5. Custom Navigation in Lenya</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/mod_proxy_and_lenya.html">6a. Mod Proxy and Lenya</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/tutorial/mod_proxy_and_lenya_continued.html">6b. Mod Proxy and Lenya</a>
</div>
</div>
<div onclick="SwitchMenu('menu_selected_1.1.4', '../../../skin/')" id="menu_selected_1.1.4Title" class="menutitle" style="background-image: url('../../../skin/images/chapter_open.gif');">How-To</div>
<div id="menu_selected_1.1.4" class="selectedmenuitemgroup" style="display: block;">
<div class="menupage">
<div class="menupagetitle">FAQ</div>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/new_publication.html">New Publication</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/deploy_publication.html">Deploy Publication</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/look_and_feel.html">Look and Feel</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/custom_resourcetype.html">Custom Resource Type</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/new_mime_type.html">Adding Mime Types</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/site_navigation.html">Site Navigation</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/ldap_authentication.html">LDAP Authentication</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/cms_menus.html">CMS Menus</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/cms_screens.html">CMS Screens</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/search.html">Search Publications</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/external_data.html">External Data</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/how-to/unittests.html">Unit Tests</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5', '../../../skin/')" id="menu_1.1.5Title" class="menutitle">Components</div>
<div id="menu_1.1.5" class="menuitemgroup">
<div onclick="SwitchMenu('menu_1.1.5.1', '../../../skin/')" id="menu_1.1.5.1Title" class="menutitle">Access&nbsp;Control</div>
<div id="menu_1.1.5.1" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/terms.html">Basic Terms</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/accesscontrollers.html">Access&nbsp;Controllers</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/accesscontrollerresolvers.html">Access Controller Resolvers</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/authenticators.html">Authenticators</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/authorizers.html">Authorizers</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/policymanagers.html">Policies and Policy&nbsp;Managers</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/accreditablemanagers.html">Accreditable&nbsp;Managers</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/accesscontrol/ssl.html">SSL Encryption</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.2', '../../../skin/')" id="menu_1.1.5.2Title" class="menutitle">Authoring</div>
<div id="menu_1.1.5.2" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/authoring/adding-document-creator.html">Adding a new document creator</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/authoring/image-upload.html">Image Upload</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/authoring/openoffice.html">OpenOffice</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.3', '../../../skin/')" id="menu_1.1.5.3Title" class="menutitle">Deployment</div>
<div id="menu_1.1.5.3" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/deployment/proxying.html">Proxying</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.4', '../../../skin/')" id="menu_1.1.5.4Title" class="menutitle">Editors</div>
<div id="menu_1.1.5.4" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/editors/htmlform.html">HTML Form Editor</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/editors/1form.html">HTML One Form Editor</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/editors/bxe.html">Bitflux Editor</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/editors/kupu.html">Kupu</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/editors/xopus.html">Xopus</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.5', '../../../skin/')" id="menu_1.1.5.5Title" class="menutitle">Layout</div>
<div id="menu_1.1.5.5" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/layout/navigation.html">Navigation</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/layout/xhtml-templating.html">XHTML templating</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/layout/static-resources.html">Serving static resources</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/layout/lenya-menubar.html">Lenya Menubar</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.6', '../../../skin/')" id="menu_1.1.5.6Title" class="menutitle">Publication</div>
<div id="menu_1.1.5.6" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/publication/pageenvelopemodule.html">PageEnvelopeModule</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/publication/siteTree.html">Site tree</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.7', '../../../skin/')" id="menu_1.1.5.7Title" class="menutitle">Resource&nbsp;Types</div>
<div id="menu_1.1.5.7" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/resource-types/resource-types.html">Resource&nbsp;Types</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.8', '../../../skin/')" id="menu_1.1.5.8Title" class="menutitle">Revision Control</div>
<div id="menu_1.1.5.8" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/revisioncontrol/revisioncontroller.html">Revision Controller</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/revisioncontrol/rcml.html">RCML</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/revisioncontrol/checkin.html">Check In</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/revisioncontrol/checkout.html">Check Out</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/revisioncontrol/version.html">Revisions</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/revisioncontrol/rollback.html">Rollback</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.9', '../../../skin/')" id="menu_1.1.5.9Title" class="menutitle">Repository</div>
<div id="menu_1.1.5.9" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/repository/index.html">WebDAV Servers</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.10', '../../../skin/')" id="menu_1.1.5.10Title" class="menutitle">Search</div>
<div id="menu_1.1.5.10" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/search/lucene.html">Searching with Lucene</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.11', '../../../skin/')" id="menu_1.1.5.11Title" class="menutitle">URI Handling</div>
<div id="menu_1.1.5.11" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/uri-handling/URIParametrizer.html">URI Parametrizer</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/uri-handling/standardURI.html">URI Scheme</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/uri-handling/usecases.html">Usecases</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.12', '../../../skin/')" id="menu_1.1.5.12Title" class="menutitle">Asset Management</div>
<div id="menu_1.1.5.12" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/asset-management/management.html">Asset Management</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.13', '../../../skin/')" id="menu_1.1.5.13Title" class="menutitle">Link Management</div>
<div id="menu_1.1.5.13" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/link-management/link-management.html">Link Management</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.14', '../../../skin/')" id="menu_1.1.5.14Title" class="menutitle">Meta Data</div>
<div id="menu_1.1.5.14" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/metadata/metadata.html">Meta Data Handling</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.15', '../../../skin/')" id="menu_1.1.5.15Title" class="menutitle">Multilingual Documents</div>
<div id="menu_1.1.5.15" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/multilingual/multilingual.html">Multilingual Document Handling</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.16', '../../../skin/')" id="menu_1.1.5.16Title" class="menutitle">Tasks</div>
<div id="menu_1.1.5.16" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/concept.html">The Task Concept</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/defining.html">Defining Tasks</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/taskaction.html">The TaskAction</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/scheduling.html">Scheduling a Task</a>
</div>
<div onclick="SwitchMenu('menu_1.1.5.16.5', '../../../skin/')" id="menu_1.1.5.16.5Title" class="menutitle">Included tasks</div>
<div id="menu_1.1.5.16.5" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/anttask.html">AntTask</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/publisher.html">DefaultFilePublisher</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/exporter.html">StaticHTMLExporter</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/mailtask.html">MailTask</a>
</div>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/tasks/development.html">Developing Tasks</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.17', '../../../skin/')" id="menu_1.1.5.17Title" class="menutitle">Workflow</div>
<div id="menu_1.1.5.17" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/workflow/terms.html">Terms</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/workflow/state-machine.html">The State Machine</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/workflow/configuration.html">Configuration</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/workflow/implementation.html">Implementation</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.5.18', '../../../skin/')" id="menu_1.1.5.18Title" class="menutitle">Site Management</div>
<div id="menu_1.1.5.18" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/archive.html">Archive</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/copy.html">Copy</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/deactivate.html">Deactivate</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/delete.html">Delete</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/deletetrash.html">Delete the trash</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/move.html">Move</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/moveupdown.html">Move Up/Down</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/rename.html">Rename</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/components/sitemanagement/restore.html">Restore</a>
</div>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.6', '../../../skin/')" id="menu_1.1.6Title" class="menutitle">Miscellaneous</div>
<div id="menu_1.1.6" class="menuitemgroup">
<div class="menuitem">
<a href="../../../docs/1_2_x/misc/namespaces.html">Namespaces</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/misc/reserved_names.html">Reserved Names</a>
</div>
<div class="menuitem">
<a href="../../../docs/1_2_x/misc/xinclude-processor.html">XInclude Processor</a>
</div>
</div>
<div class="menuitem">
<a href="../../../apidocs/1.2/index.html">1.2 API (Javadoc)</a>
</div>
</div>
<div id="credit"></div>
<div id="roundbottom">
<img style="display: none" class="corner" height="15" width="15" alt="" src="../../../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
<!--+
|alternative credits
+-->
<div id="credit2">
<a href="http://wiki.apache.org/lenya/MeetingFreiburg2008"><img border="0" title="Meeting Freiburg 2008" alt="Meeting Freiburg 2008 - logo" src="../../../images/apache-lenya-meeting-freiburg-2008.png" style="width: 160px;height: 40px;"></a>
</div>
</div>
<!--+
|end Menu
+-->
<!--+
|start content
+-->
<div id="content">
<div title="Portable Document Format" class="pdflink">
<a class="dida" href="faq.pdf"><img alt="PDF -icon" src="../../../skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
</div>
<h1>Frequently Asked Questions</h1>
<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
<a href="#Errors">Errors</a>
</li>
<li>
<a href="#I+get+an+error+or+an%0A++++++++exception%2C+where+can+I+look+at%2C+what+should+I+do%3F">I get an error or an
exception, where can I look at, what should I do?</a>
</li>
<li>
<a href="#General+Lenya%0A++++++++capabilities">General Lenya
capabilities</a>
</li>
<li>
<a href="#Can+a+local+Lenya+instance%0A++++++++generate+a+site+that+is+deployed+on+a+remote+hosting+service%3F">Can a local Lenya instance
generate a site that is deployed on a remote hosting service?</a>
</li>
<li>
<a href="#Installation%2C+Setup%2C%0A++++++++Virtual+hosts+etc.">Installation, Setup,
Virtual hosts etc.</a>
</li>
<li>
<a href="#I+have+already+deployed%0A++++++++cocoon+in+my+servlet+engine.+Can+I+install+Lenya+in+parallel%3F">I have already deployed
cocoon in my servlet engine. Can I install Lenya in parallel?</a>
</li>
<li>
<a href="#Can+lenya+be+integrated%0A++++++++into+a+virtual+hosting+environment%3F">Can lenya be integrated
into a virtual hosting environment?</a>
</li>
<li>
<a href="#Do+I+need+to+create+a%0A++++++++Lenya+install+for+each+virtual+server%3F">Do I need to create a
Lenya install for each virtual server?</a>
</li>
<li>
<a href="#Is+there+a+way+to+create%0A++++++++multiple+sites+accessible+via+various+methods+of+access+control+%28based+on+who%0A++++++++owns+them%29%3F">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="#How+do+I+enable+email%0A++++++++notifications%3F">How do I enable email
notifications?</a>
</li>
<li>
<a href="#Running+Lenya">Running Lenya</a>
</li>
<li>
<a href="#Lenya+CMS+ui+tabs+are+not%0A++++++++displayed%2C+whats+wrong%3F">Lenya CMS ui tabs are not
displayed, whats wrong?</a>
</li>
<li>
<a href="#I+can%27t+run+the+lenya.sh%0A++++++++script+in+a+linux+shell.">I can't run the lenya.sh
script in a linux shell.</a>
</li>
<li>
<a href="#Why+do+I+get+an+%22illegal%0A++++++++cookie%22+warning+with+all+the+lenya+reference+sites+using+Opera%3F">Why do I get an "illegal
cookie" warning with all the lenya reference sites using Opera?</a>
</li>
<li>
<a href="#I+get+a">I get a
java.net.URISyntaxException error:</a>
</li>
<li>
<a href="#How+can+I+create+new%0A++++++++users%3F">How can I create new
users?</a>
</li>
<li>
<a href="#When+using+Lenya%2C+a+blank%0A++++++++page+occurs.">When using Lenya, a blank
page occurs.</a>
</li>
<li>
<a href="#I+get+a+%22Connection+timed%0A++++++++out%22+errors+such+as+%22org.apache.cocoon.ProcessingException%3A+Unable+to+get%0A++++++++transformer+handler+for+cocoon%3A%2F%2Fscheduler%2Fdefault%2Fxxx%22">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>
<li>
<a href="#Document+Types+%28short%3A%0A++++++++Doctypes%29">Document Types (short:
Doctypes)</a>
</li>
<li>
<a href="#Where+can+I+find%0A++++++++lenya-documentation+about+the+exact+meaning+of%3A">Where can I find
lenya-documentation about the exact meaning of:</a>
</li>
<li>
<a href="#How+to+create+a+new%0A++++++++document+type%3F">How to create a new
document type?</a>
</li>
<li>
<a href="#How+to+to+use+my+own+Relax%0A++++++++NG+schema+for+editing+documents+with+Bitflux+in+Lenya%3F">How to to use my own Relax
NG schema for editing documents with Bitflux in Lenya?</a>
</li>
<li>
<a href="#File-upload">File-upload</a>
</li>
<li>
<a href="#How+can+I+Upload+XML%0A++++++++Files%3F">How can I Upload XML
Files?</a>
</li>
<li>
<a href="#Compliance+to%0A++++++++standards">Compliance to
standards</a>
</li>
<li>
<a href="#How+to+port+the+default%0A++++++++pub+to+XHTML%3F">How to port the default
pub to XHTML?</a>
</li>
<li>
<a href="#Revision+Control">Revision Control</a>
</li>
<li>
<a href="#How+do+I+break+a+lock+on+a%0A++++++++document%3F">How do I break a lock on a
document?</a>
</li>
<li>
<a href="#Background%3A">Background:</a>
</li>
<li>
<a href="#Edit+documents">Edit documents</a>
</li>
<li>
<a href="#How+can+I+delete+a%0A++++++++document%3F">How can I delete a
document?</a>
</li>
<li>
<a href="#Asset+management">Asset management</a>
</li>
<li>
<a href="#Asset+upload+does+not%0A++++++++work.+How+do+I+enable+asset+uploads%3F">Asset upload does not
work. How do I enable asset uploads?</a>
</li>
<li>
<a href="#Fallback">Fallback</a>
</li>
<li>
<a href="#How+can+I+provide+a%0A++++++++different+authoring+login+page+for+my+publication%3F">How can I provide a
different authoring login page for my publication?</a>
</li>
<li>
<a href="#Internationalization%0A++++++++%28i18n%29">Internationalization
(i18n)</a>
</li>
<li>
<a href="#How+do+I+switch+the%0A++++++++default+language+for+an+existing+publication%3F">How do I switch the
default language for an existing publication?</a>
</li>
<li>
<a href="#Editors">Editors</a>
</li>
<li>
<a href="#BXE+doesn%27t+let+me+insert%0A++++++++a+%3Ch1%3E+heading%3F">BXE doesn't let me insert
a &lt;h1&gt; heading?</a>
</li>
<li>
<a href="#Customization">Customization</a>
</li>
<li>
<a href="#How+to+Add+Custom+Logicsheets%3F">How to Add Custom Logicsheets?</a>
</li>
</ul>
</div>
</div>
<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 &lt;h1&gt; 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>
<a name="N10129"></a><a name="Errors"></a>
<h2 class="h3">Errors</h2>
<div class="section"></div>
<a name="N1012F"></a><a name="I+get+an+error+or+an%0A++++++++exception%2C+where+can+I+look+at%2C+what+should+I+do%3F"></a>
<h2 class="h3">I get an error or an
exception, where can I look at, what should I do?</h2>
<div class="section">
<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="http://mail-archives.apache.org/mod_mbox/lenya-user/">
User</a> or <a href="http://mail-archives.apache.org/mod_mbox/lenya-dev/">
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>
</div>
<a name="N1017A"></a><a name="General+Lenya%0A++++++++capabilities"></a>
<h2 class="h3">General Lenya
capabilities</h2>
<div class="section"></div>
<a name="N10180"></a><a name="Can+a+local+Lenya+instance%0A++++++++generate+a+site+that+is+deployed+on+a+remote+hosting+service%3F"></a>
<h2 class="h3">Can a local Lenya instance
generate a site that is deployed on a remote hosting service?</h2>
<div class="section">
<p>Yes. Using the <a href="../../../docs/1_2_x/components/tasks/exporter.html">
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>&lt;task&nbsp;id="publish"&gt;</em> task,</p>
<pre class="code">
&lt;task id="publish"&gt;
....
&lt;task id="export" class="org.apache.lenya.cms.publishing.StaticHTMLExporter"&gt;
&lt;parameter name="export-path" value="work/export/pending"/&gt;
&lt;parameter name="substitute-regexp" value="/lenya/$YOUR_PROJECT_NAME/live/"/&gt;
&lt;parameter name="substitute-replacement" value="/"/&gt;
&lt;parameter name="my-server-port" value="$THE_SERVER_PORT_RUNNING_LENYA"/&gt;
&lt;/task&gt;
&lt;/task&gt;
</pre>
<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>
</div>
<a name="N101A7"></a><a name="Installation%2C+Setup%2C%0A++++++++Virtual+hosts+etc."></a>
<h2 class="h3">Installation, Setup,
Virtual hosts etc.</h2>
<div class="section"></div>
<a name="N101AD"></a><a name="I+have+already+deployed%0A++++++++cocoon+in+my+servlet+engine.+Can+I+install+Lenya+in+parallel%3F"></a>
<h2 class="h3">I have already deployed
cocoon in my servlet engine. Can I install Lenya in parallel?</h2>
<div class="section">
<p>Yes you can.</p>
</div>
<a name="N101B6"></a><a name="Can+lenya+be+integrated%0A++++++++into+a+virtual+hosting+environment%3F"></a>
<h2 class="h3">Can lenya be integrated
into a virtual hosting environment?</h2>
<div class="section">
<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="../../../docs/1_2_x/tutorial/mod_proxy_and_lenya.html">Mod Proxy tutorial</a> for reference.</p>
</div>
<a name="N101C3"></a><a name="Do+I+need+to+create+a%0A++++++++Lenya+install+for+each+virtual+server%3F"></a>
<h2 class="h3">Do I need to create a
Lenya install for each virtual server?</h2>
<div class="section">
<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>
</div>
<a name="N101CE"></a><a name="Is+there+a+way+to+create%0A++++++++multiple+sites+accessible+via+various+methods+of+access+control+%28based+on+who%0A++++++++owns+them%29%3F"></a>
<h2 class="h3">Is there a way to create
multiple sites accessible via various methods of access control (based on who
owns them)?</h2>
<div class="section">
<p>Yes, with the Lenya access control framework this is no problem.</p>
</div>
<a name="N101D7"></a><a name="How+do+I+enable+email%0A++++++++notifications%3F"></a>
<h2 class="h3">How do I enable email
notifications?</h2>
<div class="section">
<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
&lt;property name="mail.mailhost" value="localhost"/&gt;</p>
</div>
<a name="N101E3"></a><a name="Running+Lenya"></a>
<h2 class="h3">Running Lenya</h2>
<div class="section"></div>
<a name="N101E9"></a><a name="Lenya+CMS+ui+tabs+are+not%0A++++++++displayed%2C+whats+wrong%3F"></a>
<h2 class="h3">Lenya CMS ui tabs are not
displayed, whats wrong?</h2>
<div class="section">
<p>As of Lenya 1.2, this is no longer a problem. It used to be a problem with
Xalan.</p>
</div>
<a name="N101F2"></a><a name="I+can%27t+run+the+lenya.sh%0A++++++++script+in+a+linux+shell."></a>
<h2 class="h3">I can't run the lenya.sh
script in a linux shell.</h2>
<div class="section">
<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>
</div>
<a name="N10213"></a><a name="Why+do+I+get+an+%22illegal%0A++++++++cookie%22+warning+with+all+the+lenya+reference+sites+using+Opera%3F"></a>
<h2 class="h3">Why do I get an "illegal
cookie" warning with all the lenya reference sites using Opera?</h2>
<div class="section">
<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>
</div>
<a name="N1021F"></a><a name="I+get+a"></a>
<h2 class="h3">I get a
java.net.URISyntaxException error:</h2>
<div class="section">
<pre class="code">
java.net.URISyntaxException: Illegal character in path at index 21:
file:/D:/build/Tomcat 4.1/webapps/lenya/lenya/pubs/blog/config/ac/passwd/
</pre>
<p>The installation path may not contain spaces: <a href="../../../docs/1_2_x/installation/source_version.html"> Lenya
Installation Instructions</a>
</p>
</div>
<a name="N10232"></a><a name="How+can+I+create+new%0A++++++++users%3F"></a>
<h2 class="h3">How can I create new
users?</h2>
<div class="section">
<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>
</div>
<a name="N1023B"></a><a name="When+using+Lenya%2C+a+blank%0A++++++++page+occurs."></a>
<h2 class="h3">When using Lenya, a blank
page occurs.</h2>
<div class="section">
<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>
</div>
<a name="N10244"></a><a name="I+get+a+%22Connection+timed%0A++++++++out%22+errors+such+as+%22org.apache.cocoon.ProcessingException%3A+Unable+to+get%0A++++++++transformer+handler+for+cocoon%3A%2F%2Fscheduler%2Fdefault%2Fxxx%22"></a>
<h2 class="h3">I get a "Connection timed
out" errors such as "org.apache.cocoon.ProcessingException: Unable to get
transformer handler for cocoon://scheduler/default/xxx"</h2>
<div class="section">
<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>
</div>
<a name="N1024D"></a><a name="Document+Types+%28short%3A%0A++++++++Doctypes%29"></a>
<h2 class="h3">Document Types (short:
Doctypes)</h2>
<div class="section"></div>
<a name="N10253"></a><a name="Where+can+I+find%0A++++++++lenya-documentation+about+the+exact+meaning+of%3A"></a>
<h2 class="h3">Where can I find
lenya-documentation about the exact meaning of:</h2>
<div class="section">
<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="../../../docs/1_2_x/components/publication/pageenvelopemodule.html">Page envelope module</a>
</p>
</div>
<a name="N10280"></a><a name="How+to+create+a+new%0A++++++++document+type%3F"></a>
<h2 class="h3">How to create a new
document type?</h2>
<div class="section">
<p>See <a href="../../../docs/1_2_x/how-to/custom_resourcetype.html">Adding Custom Resource Type</a>.</p>
</div>
<a name="N1028D"></a><a name="How+to+to+use+my+own+Relax%0A++++++++NG+schema+for+editing+documents+with+Bitflux+in+Lenya%3F"></a>
<h2 class="h3">How to to use my own Relax
NG schema for editing documents with Bitflux in Lenya?</h2>
<div class="section">
<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>
</div>
<a name="N102A2"></a><a name="File-upload"></a>
<h2 class="h3">File-upload</h2>
<div class="section"></div>
<a name="N102A8"></a><a name="How+can+I+Upload+XML%0A++++++++Files%3F"></a>
<h2 class="h3">How can I Upload XML
Files?</h2>
<div class="section">
<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>
</div>
<a name="N102B4"></a><a name="Compliance+to%0A++++++++standards"></a>
<h2 class="h3">Compliance to
standards</h2>
<div class="section"></div>
<a name="N102BA"></a><a name="How+to+port+the+default%0A++++++++pub+to+XHTML%3F"></a>
<h2 class="h3">How to port the default
pub to XHTML?</h2>
<div class="section">
<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>
</div>
<a name="N102C6"></a><a name="Revision+Control"></a>
<h2 class="h3">Revision Control</h2>
<div class="section"></div>
<a name="N102CC"></a><a name="How+do+I+break+a+lock+on+a%0A++++++++document%3F"></a>
<h2 class="h3">How do I break a lock on a
document?</h2>
<div class="section">
<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>
<pre class="code">
&lt;!CheckOut&gt;
&lt;Identity&gt;lenya&lt;/Identity&gt;
&lt;Time&gt;1083252253647&lt;/Time&gt;
&lt;/!CheckOut&gt;
</pre>
<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>
</div>
<a name="N102DF"></a><a name="Background%3A"></a>
<h2 class="h3">Background:</h2>
<div class="section">
<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>
</div>
<a name="N102E8"></a><a name="Edit+documents"></a>
<h2 class="h3">Edit documents</h2>
<div class="section"></div>
<a name="N102EE"></a><a name="How+can+I+delete+a%0A++++++++document%3F"></a>
<h2 class="h3">How can I delete a
document?</h2>
<div class="section">
<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-&gt;Archive.</p>
</li>
<li>
<p>or you can delete it: In the site tab go to Edit-&gt;Delete</p>
</li>
</ol>
</div>
<a name="N10308"></a><a name="Asset+management"></a>
<h2 class="h3">Asset management</h2>
<div class="section"></div>
<a name="N1030E"></a><a name="Asset+upload+does+not%0A++++++++work.+How+do+I+enable+asset+uploads%3F"></a>
<h2 class="h3">Asset upload does not
work. How do I enable asset uploads?</h2>
<div class="section">
<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>
</div>
<a name="N10317"></a><a name="Fallback"></a>
<h2 class="h3">Fallback</h2>
<div class="section"></div>
<a name="N1031D"></a><a name="How+can+I+provide+a%0A++++++++different+authoring+login+page+for+my+publication%3F"></a>
<h2 class="h3">How can I provide a
different authoring login page for my publication?</h2>
<div class="section">
<p>You've to use Fallbacks. In sitemap.xmap put the login xsl under fallback.</p>
<pre class="code">
&lt;map:match type="step" pattern="showscreen"&gt;
&lt;map:generate type="serverpages" src="lenya/content/ac/login.xsp"/&gt;
&lt;map:transform src="lenya/{fallback:xslt/ac/login.xsl}"&gt;
&lt;map:parameter name="publication_name" value="{page-envelope:publication-id}"/&gt;
&lt;/map:transform&gt;
&lt;map:call resource="style-cms-page"/&gt;
&lt;/map:match&gt;
</pre>
<p>And now write your alternative login.xsl in the publication filesystem, under
config/ac (webapps/lenya/lenya/pubs/[pubName]/config/ac)</p>
</div>
<a name="N1032D"></a><a name="Internationalization%0A++++++++%28i18n%29"></a>
<h2 class="h3">Internationalization
(i18n)</h2>
<div class="section"></div>
<a name="N10333"></a><a name="How+do+I+switch+the%0A++++++++default+language+for+an+existing+publication%3F"></a>
<h2 class="h3">How do I switch the
default language for an existing publication?</h2>
<div class="section">
<p>Go to <em>lenya/pubs/&lt;youpubname&gt;/config/publication.xconf</em> and move
the <em>default="true"</em> attribute to your default language.</p>
</div>
<a name="N10342"></a><a name="Editors"></a>
<h2 class="h3">Editors</h2>
<div class="section"></div>
<a name="N10348"></a><a name="BXE+doesn%27t+let+me+insert%0A++++++++a+%3Ch1%3E+heading%3F"></a>
<h2 class="h3">BXE doesn't let me insert
a &lt;h1&gt; heading?</h2>
<div class="section">
<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>
</div>
<a name="N10355"></a><a name="Customization"></a>
<h2 class="h3">Customization</h2>
<div class="section"></div>
<a name="N1035D"></a><a name="How+to+Add+Custom+Logicsheets%3F"></a>
<h2 class="h3">How to Add Custom Logicsheets?</h2>
<div class="section">
<p>Custom logicsheets can be put in <span class="codefrag">&lt;yourpub&gt;/java/src</span>.</p>
<p>You have to add a patch file for <span class="codefrag">cocoon.xconf</span>, for instance <span class="codefrag">&lt;yourpub&gt;/config/logicsheets.xconf</span>:</p>
<pre class="code">&lt;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']]"&gt;
&lt;builtin-logicsheet&gt;
&lt;parameter name="prefix" value="mylogicsheet"/&gt;
&lt;parameter name="uri" value="http://foo/bar/mylogicsheet"/&gt;
&lt;parameter name="href" value="resource://org/myproject/mylogicsheet.xsl"/&gt;
&lt;/builtin-logicsheet&gt;
... (more logicsheets)
&lt;/xconf&gt;</pre>
</div>
</div>
<!--+
|end content
+-->
<div class="clearboth">&nbsp;</div>
</div>
<div id="footer">
<!--+
|start bottomstrip
+-->
<div class="lastmodified">
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<div class="copyright">
Copyright &copy;
2002-2007 <a href="http://www.apache.org/licenses/LICENSE-2.0">The Apache Software Foundation.</a>
</div>
<div id="feedback">
Send feedback about the website to:
<a id="feedbackto" href="mailto:dev@lenya.apache.org?subject=Feedback%C2%A0for%C2%A0docs/1_2_x/how-to/faq.html">dev@lenya.apache.org</a>
</div>
<!--+
|end bottomstrip
+-->
</div>
</body>
</html>