This guide explains how to get the Roller source code, build it with Maven, test it with Maven and run it via Maven, Jetty and Derby (recommended for development test purposes only).
Get the Roller source code
There are two ways to get the source code, from the project's Subversion repository or from a source release. Here's how to get the code from Subversion:
svn co https://svn.apache.org/repos/asf/roller/trunk roller_trunk
TBD: how to get and extract a source release
Build Roller Weblogger
Here's how to build Roller Weblogger (also runs the unit tests).
cd roller_trunk mvn install
Run Roller Weblogger for development testing
Here's how to run the Jetty servlet engine, Derby and Roller for development testing of Roller:
cd roller_trunk/weblogger-web mvn jetty:run-war
Then use your web browser to browse to http://localhost:8080/roller to test Roller. You will find the log files in roller_trunk/weblogger-web/target/work. You can adjust logging levels via the Roller properties override file at roller_trunk/weblogger-web/src/test/resources/roller-custom.properties.
Build a Roller Weblogger release package
Here's how to build a full Roller Weblogger release including both binary and source releases.
cd roller_trunk/web-assembly mvn install
You'll find the release files in roller_trunk/web-assembly/target.
Other resources
Here's an excellent blog post from Harald Wellmann that explains how to setup Eclipse and m2eclipse plugin to build, test and run Roller: http://hwellmann.blogspot.com/2010/02/setting-up-eclipse-for-roller.html