Installing

These instructions are for tomcat running under *nix operating system. It shouldn't be very tricky to adapt them you your environment.

Step 1 - Download Pink Wino

Get the latest version from the Download page.

Step 2 - Unpack the gzipped tar file

# step 2
tar -xzf pinkwino.tgz

Step 3 - (Optional)

If you wish, you can rebuild the jar files.

mkdir install build
cd src
ant install
cd ..

At this point, the "install" directory contains a copy of the webapp directory, including the newly built pinkwino.jar file. The build directory contains the intermediate ".class" files, and can be deleted if you wish.

Also, if you prefer a ".war" file, rather than a webapp directory, you can make a war file from the install/webapp dir.

Step 4 - Prepare your wiki

We now need to create a directory to hold your wiki data, and to create a configuration file. We use a copy of the standard configuration file, and change only the parts of interest.

cp -r src/exampleData mywikidata
cp src/webapp/WEB-INF/classes/pinkwino.bsh mywiki.bsh

Now edit mywiki.bsh using your favourite text editor, making the following changes :

There are two paths which need to be changed. Wherever you see "/gidea/documents/pinkwino/content/", change it to the full path of the "mywikidata" directory created above.

For now, you can leave all other settings unaltered.

Step 5 - Setup tomcat

Edit tomcat's server.xml file, adding the following <Context> section (at the bottom of the file, just before the closing "</Host>" tag). There are two paths you need to customise.

The first is the path of the webapp directory. This is in the "src" directory created when you unzipped the download. (If you did the optional "ant install", you can use thee version in the "install" directory, rather than the "src" directory).

The second is the path of mywiki.bsh (created in step 4).

<Context path="/pinkwino" docBase="/ENTER THE FULL PATH/webapp"
  reloadable="true" allowLinking="true">

  <Parameter name="pinkwino.initscript"
    value="ENTER THE FULL PATH/mywiki.bsh"
    override="false"/>

</Context>

Step 6 - Try it

Start tomcat, and test in your browser. If you are using a vanilla version of tomcat, the url will be : http://localhost:8080/pinkwino