Organising your development (cookbook)

- TARGET-AUDIENCE: *beginner* advanced expert
- COCOON-RELEASES: 2.0.3, 2.0.4
- DOCUMENT-STATUS: *draft* reviewed released

What you will get from this page

I will show you how you can setup a cleanly separated development environment with minimal modifications of the existing Cocoon infrastructure. You will end up with a hierarchy of folders all completely under your control with only one modification in the Cocoon standard distribution.

Your basic skills

Technical prerequisites

If you don't have access to Cocoon right now, you can just install it on your local computer. Please refer to BeginnerInstallation for further information.


Separating your work folder from Cocoon

If you want to take out the whole work folder from the $cocoon-root, this can be done by specifying a mountpoint similar to what we described in part I of BeginnerSimpleWebappOrganisation. you will add a new pipeline within the $cocoon_root/sitemap.xmap file. Here is what you will have to do:

Now you have cleanly separated your work from the cocoon distribution. Your "work" folder may be located anywhere in your file system. Your URL's to your work will look like this:


Setting up a generic mount point outside of Cocoon

If you happen to need more than one external work folder, you can set up a generic sitemap similar to Part I above. I assume, you want to put some cocoon applications into subfolders of /work, e.g. /work/coconuts and /work/cocobolts. Then you want to adress these applications separately with URL's like


Also this can be achieved with a slight modification of your pipeline. Go again to $cocoon_root/sitemap.xmap and modify your pipeline as follow:

  <map:match pattern="work/*/**">
    <map:mount check-reload="yes"

Note how this sitemap now resembles the very first code snippet for the cocoon internal "mount" points. We only had to specify an absolute path and we are done ...

Hiding /cocoon from the URL

You may want to get rid of the /cocoon within the URLs to your cocoon application. I.e. instead of typing the URL:


you want the URL:


to trigger cocoon to send an html index page back to the browser. This issue is worthwhile to create a separate page. Please look at BeginnerDefaultContext or CocoonEasyInstallation for further reading.

page metadata

- AUTHOR: Dabbous
- AUTHOR-CONTACT:[[BR]] - REVIEWED-BY: DerekH (minor editing)

BeginnerAdvancedWebappOrganisation (last edited 2009-09-20 23:40:44 by localhost)