= Gnowsis Kaukoluwiki Eclipse Developing =

== Setup Gnowsis development environment ==

First of all checkout all projects comprised of Gnowsis (SVN):
 * https://gnowsis.opendfki.de/repos/gnowsis/trunc/

Checkout Aperture, which is also necessary for Gnowsis (CVS):
 * Host: aperture.cvs.sourceforge.net
 * repository path: /cvsroot/aperture
 * connection type: pserver
 * user: anonymous
 * default port

Now you can start Gnowsis for the first time. Execute ''Run...''. You can choose the appropiate configuration to launch Gnowsis.

== Setup Kaukoluwiki development environment ==

First, read the kaukoluwiki website (ignore the installation instructions. Instead, use the installation details below):
 * http://kaukoluwiki.opendfki.de 

Then, checkout the wiki from SVN:
 * https://kaukoluwiki.opendfki.de/repos/trunk/kaukolu/

You have two projects in your workspace
 * Kaukoluwiki
 * Kaukolu

The project ''Kaukolu'' is a "web-wiki" which consists of the basic functionality of Kaukoluwiki. The project ''Kaukoluwiki'' is some kind of "desktop wiki" which is used by Gnowsis. So Gnowsis Kaukoluwiki consits of the core done by the project ''Kaukolu'' from opendfki and our own extensions provided by the project ''Kaukoluwiki''.

Important notes regarding the two projects:
 * The JSP pages provided by the project ''Kaukolu'' are delivered precompiled in a jar file.
 * The JSP pages provided by the project ''Kaukoluwiki'' (Gnowsis) are located in a template folder: Kaukoluwiki/service/kaukoluwiki/templates/gnowsis/ 
 * While Gnowsis is running you can alter these JSP pages in the template folder. On a reload an altered JSP page will be recompiled.

== Compiling Kaukolu and Kaukoluwiki ==

To compile:
 * run the build.xml in ''Kaukolu'' - target '''gnowsis-prepare'''
 * run the build.xml in ''Kaukoluwiki'' - target '''dist-fromkaukolu'''

The second build target is quite tricky. It moves the SVN files to a save place and will delete all changes you did inside the /service/ folder of ''Kaukoluwiki'', so see you have copied your changes (in JSP files or web.xml) to the corresponding files in /src/.