• This site is for cocoon user who are trying to get started with cocoon developing.
  

I decided to develope my cocoon applications with eclipse and Apache Tomcat. I will explain how to setup the eclipse IDE and Tomcat on a windows workstation.

First steps

Download JavaSDK 1.4. Install it!
Download Tomcat 4.1.x. Install it!
Download eclipse Release Build: 2.1.1. I unziped the file to D:\opensource\bin\eclipse! So for me the following is correct, but your setting can be different.{{{ECLIPSE_HOME=D:\opensource\bin\eclipse I will refer to that path as $ECLIPSE_HOME}}}

Tune eclipse

Download the following plugins

• Tomcat plugin of Sysdeo

• sunBow-plugin Another interesting thing is this collection of plugins, called sunbow from S&N. It offers a lightweight XML editor and a cute editor (and debugger) for cocoon sitemaps.--MarkusVaterlaus, updated by LarsHuttar

• Eclipse has no native support for editing xml files. One way to add xml support is to install the XMLBuddy plugin. --MehmetBirgi
  

• In the xml plugin series for eclipse, take a look at oxygen (trial version 4 30 days). It can be used as an eclipse plugin or standalone, to edit/check/valid/tansform your xml documents. Tree editor in the standalone version.--Eric Burghard

Note1a: When editing xml files in Eclipse, or after installing the XMLBuddy plugin, you may get a java.lang.NoClassDefFoundError: org/w3c/dom/ranges/DocumentRange error and even not be able to start Eclipse (check the .log file in your workspace's .metadata directory for the error message). I'm not sure if this is the proper way, but I have solved this problem by downloading [dom2.jar|http://www.w3.org/DOM/2000/12/dom2.jar] from the W3C DOM page, and copying it to the %JAVA_HOME%/jre/lib/endorsed directory (I am using Java 1.4.2). --MehmetBirgi

Note2a:If the error marks (that show you where the problem is in your file)don't show in Eclipse when you validate your edited file try to mount the catalog.

• go to "Window -> Preferen*ces"
  

• then choose "oXygen/XML Catalog" & press the add button

• you can find the catalog in the following folder:
  "..\cocoon-lenya\src\webapp\lenya\pubs\docs-new\resources\schema"--SandraGubler
  

Unzip the plugins into $ECLIPSE_HOME\plugins. e.g. $ECLIPSE_HOME\plugins\com.sysdeo.eclipse.tomcat_2.1.0

Change eclipse preferences

Start your eclipse. Then you have to customize the installed plugins:

1. Menu 'Windows -> Preferences'

2. node 'Tomcat'
3. choose 'Version 4.x'
4. browse to TOMCAT_HOME (CATALINA_HOME is the same)
5. press 'Apply'
6. press 'OK'

7. Menu 'Windows -> Customize Preferences'

8. node 'Other'
9. select 'Tomcat'
10. press 'OK'

Resources

LoadInEclipse
How to debug COCOON with ECLIPSE and TOMCAT?
Eclipse und Tomcat