wiki:KaukoluwikiDeveloping

Version 6 (modified by sebastian_weber, 17 years ago) (diff)

--

Gnowsis Kaukoluwiki Eclipse Developing

Setup Gnowsis development environment

First of all checkout all projects comprised of Gnowsis (SVN):

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):

Then, checkout the wiki from SVN:

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