Wt

h1. Install Wt's dependencies

h2. Cygwin

From "the cygwin homepage":http://www.cygwin.com/, download setup.exe and install a typical C++ development system. Install at least these items:

* gcc4. Building Wt on cygwin requires gcc > 4. At the time of writing of this document, gcc4 was a separate package in cygwin, whereas the normal gcc package was gcc v3. I installed only gcc-4, and @gcc --version@ reports gcc 4.3.4.

* cmake

* make

h2. Get and install boost

Go to "the boost homepage":http://www.boost.org/ and download the most recent boost version. Build boost following the instructions for the version you downloaded. For example, boost 1.43.0 is compiled and installed in @/cygdrive/j/boost-cygwin@ using the following commands:

<pre>

./bjam.exe --prefix=/cygdrive/j/boost-cygwin --layout=versioned install

</pre>

Note: Compiling (and installing) boost on cygwin is painfully slow.

On my system, boost failed to copy the compiled dll's to the correct location. I ran the following command to correct this:

<pre>

for i in `find . -name \*.dll`; do cp $i /cygdrive/j/boost-cygwin/lib; done

</pre>

Add the directory where you copied these dlls to your PATH environment variable.

h1. Installing Wt on Cygwin using gcc

h2. Download Wt

Download Wt from "the wt download page":http://www.webtoolkit.eu/wt/download. The first version of Wt that attempts to support cygwin is version 3.1.3.

h2. Configure Wt

Run cmake. Turns out that cmake's built-in method is unable to discover boost on cygwin, so you need to set BOOST_DIR, BOOST_VERSION and BOOST_COMPILER yourself. Look in the 'lib' directory of the location where you installed boost in the previous step to find out the correct values for BOOST_VERSION and BOOST_COMPILER (e.g. in the examples below, the libraries are called @libboost_wave-gcc43-mt-1_43.a@)

You must build Wt in a different directory than the source directory:

<pre>

mkdir build

cd build

cmake -DBOOST_DIR=/cygdrive/j/boost-cygwin -DBOOST_VERSION=1_43 -DBOOST_COMPILER=gcc43 /path/to/wt-x.y.z

</pre>

h2. Build Wt

Start @make@ in the directory where you ran cmake:

<pre>

make -j 4

</pre>

h1. Run Wt examples

Always run examples with the pwd set to their source directory, not from the directory where they are built. Doing so will ensure that Wt will find resource files required to run the example. On top of the example-specific resource files, Wt uses a general 'resources' directory, containing images, css, themes, ... that are required by internal Wt widgets. You must copy them to your example directory before executing the example.

<pre>

cd wt-x.y.z/examples/hello

cp -r ../../resources .

./hello --docroot=. --http-port=8080 --http-address=0.0.0.0

</pre>

Surf to http://localhost:8080/ and enjoy!

Some examples have extra dependencies, such as ExtJS (extkitchen, widgetgallery, ...) and tinyMCE (widgetgallery); the FAQ on this wiki explains how to install these.