= 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". The project ''kaukoluwiki'' is some kind of "desktop wiki" (desktop version of ''kaukolu'') which is used by Gnowsis. It uses the basic functionality provided by the "web wiki" (''kaukolu'') and adds extenstions to it. So Gnowsis Kaukoluwiki consits of the core done by the project ''kaukolu'' from opendfki and our own extensions provided by the project ''kaukoluwiki''. The JSP GUI of Gnowsis is a template which is located in the ''kaukoluwiki'' project.

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.
 * Features which are important for the "web wiki" and for the "Gnowsis wiki" are provided in ''kaukolu''.

== Compiling kaukolu and kaukoluwiki ==

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

== Be careful when you run the ant files after changes ==

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/.