Version 24, last updated by romack at 23 Mar 22:16 UTC
Installation
1. Symlinking the code
The easiest way to install Nooku Framework is using our Symlinker which can be found in the Nooku Tools space. For instructions on how to use the script please see : Symlinker
2. Build installable packages
Although you could make zip packages of Nooku manually, that is not recommended. As Nooku grows, building packages might become more complex than just zipping. Files may need be downloaded from different locations, moved around etc. Humans can make errors, so it's always better to use scripts for these sort of tasks.
Phing is a PHP based command line application that allows you to easily create packaging scripts. It's similar to applications like Ant and GNU Make. Nooku Framework provides build scripts you can run to build the packages.
Follow these steps to build installable packages of Nooku Framework.
- Install these PEAR packages:
- Checkout the scripts/build folder in the branch you want to use (The current stable branch of koowa is in /releases/0.6, so that would make /releases/0.6/scripts/build)
- Edit build.properties if desired
- Run 'phing' in that folder
- a tar.gz package should now be created
2.1 Installing PEAR on Mac OS X
A good tutorial on how to install PEAR on Mac OS X can be found here. Even if you are using MAMP it's still interesting to install PEAR seperate so you can run it directly from the command line.
Tutorial : http://www.newmediacampaigns.com/page/install-pear-phpunit-xdebug-on-macosx-snow-leopard
2.2. Phing on Windows
Using the SVN tasks with Phing can be problematic if your SVN client isn't accessible in the command prompt. This is often an option when installing a client like TortoiseSVN, but if you have problems running SVN tasks in Phing, then you need to include the svnpath variable with your SVN tasks. You may find it helpful to install your SVN client to the root without any spaces in the folder names, and then include the path to svn.exe.
3. Taking SVN snapshots
There are times when the development in the Nooku Framework trunk are too rapid (yes it happens), and you need to start taking snapshots.
Assuming that you got a folder structure like this in your trunk or branch:
- code // Koowa code in here
- administrator
- site
- media
- plugins
- libraries
Here be the phing build script:
<?xml version="1.0" ?>
<project name="Update Koowa snapshot" basedir=".." default="build">
<target name="build">
<!-- Get the koowa plugin -->
<svnexport username="" password="" repositoryurl="http://svn2.assembla.com/svn/nooku-framework/trunk/code/" todir="code" nocache="true" force="true" />
</target>
</project>
4. Tutorials
Below are some great tutorials to get you started with Nooku.