Where to Get Titania
The SourceForge project site is at http://sourceforge.net/project/pbwdm/. That site has links to how you can download the latest copy of the project from CVS. There are also a few downloadable tarballs, but given the pace of development so far they are quite out of date.
Requirements
In order to use titania you will need to have both libxml2 and libxslt installed on your system. They can be downloaded from xmlsoft, but they are also most likely available in your package manager of choice, and if you're using a modern operating system may already be installed.
You will also need Perl installed on your system. If you are using a POSIX system, chances are you have this already. However, if you are uneasy about adding new modules to your system's installation you may want to have a separate perl installed in a location like /usr/local/bin. (More on why maybe you should be uneasy to be added.)
Finally you'll need the Perl modules XML::LibXML and XML::LibXSLT, these can be retrieved and installed via CPAN. These modules have XS components to interface with the C libraries. If you experience any problems installing them feel free to contact the pbwdm developers or the Perl-XML mailing list (where most of the discussion of those two modules takes place).
Installation
Titania has not yet reached a point of suitable stability (in my opinion) for installation, and as such there are no installation instructions. It can however still be run.
Usage
The commandline UI is grossly underdeveloped, but to generate a site statically run titania (which is located in the src/ directory of the project) passing the <pbwdm:site> file you wish to use as the only argument. As of v0.3, a sample file as used to generate this website should be located at website/sf-site.xml within the project. N.B. In order to use the sample file, you will need to correct the <path> of the main subsite to the appropriate location on your system.
Since I've changed over the DTD calls for the example website to referring to the online versions performance has been dramatically reduced. This is considered a major bug and I'm working on it. If you get an error about not being able to locate a file when you've passed a legitimate argument to titania, chances are it's because you're offline and it's trying to resolve the (online) external DTDs.
Since there's no installation process yet, for titania to locate the necessary modules from the project it must be run from the same directory as it's located in. If you get an error about not being able to find something in @INC, make sure you're running from src/ (i.e. you should be typing ./titania ../website/sf-site.xml). If the error persists then you need to install XML::LibXML or XML::LibXSLT.