Added by Jeremy Quinn, last edited by Steven Grijzenhout on Nov 27, 2007  (view change) show comment

Labels:

maven maven Delete
plugin plugin Delete
hippococoonplugin hippococoonplugin Delete
installation installation Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

How to install the Hippo Cocoon Maven plugin, so you can build your own Hippo Site projects, made from the Hippo Site Skeleton.

Hippo Cocoon Maven plugin

The Hippo Cocoon plugin is a Maven plugin to assist you to build and deploy your Maven-based Hippo Site projects. It uses pre-built distributions of Cocoon to simplify development.

Get Maven

This plugin is designed for Maven 1.0.n, if you do not already have it, the latest version, currently 1.0.2, can be downloaded from http://maven.apache.org/maven-1.x/start/download.html. Decompress the archive to a suitable location. Add this location as MAVEN_HOME to your environment variables and for convenience, add it to the $PATH variable.

In your user directory, create a build.properties file and add the following line

maven.repo.remote=http://repository.hippocms.org/maven/,http://repo1.maven.org/maven/

The Maven Hippo Cocoon plugin is currently incompatible with both Maven 1.1(-beta) and Maven 2.

Java 5 users need to place xalan-2.6.0.jar in the $MAVEN_HOME/lib/endorsed directory.

Plugin Installation

maven plugin:download -Dversion=2.01.01 -DartifactId=hippo-cocoon-plugin -DgroupId=hippo-cocoon

The current version is 2.01.01 (updated 2007-08-21). You can check in the Hippo public repository: http://repository.hippocms.org/maven/hippo-cocoon/plugins/ for updates.

The above command will download the plugin from the Hippo repository and store it in your local repository. This only needs doing once.

Windows users should also install Patch.

Sometimes maven refuses to download and install the new plugin. You'll need to delete the plugin on your computer in three places:

Linux and MacOSX

  1. ~/dev/maven/plugins (or wherever you installed maven)
  2. ~/.maven/cache (change username)
  3. ~/.maven/repository/hippo-cocoon/plugins

Windows

  1. C:\apache\maven\plugins (or where you installed maven)
  2. C:\Documents and Settings\username\.maven\cache
  3. C:\Documents and Settings\username\.maven\repository\hippo-cocoon\plugins

Installed Blocks

The pre-built distributions of Cocoon have a certain set of blocks built in.
You can see the list by looking at the project.xml file in the SVN repository for the plugin. http://svn.hippocms.org/repos/hippo/hippo-cocoon/trunk/server/project.xml.

If your project needs more blocks, add the new dependencies for these blocks to the project.xml of the Site Skeleton (see below).