Cygwin offers a UNIX environment which runs from within Windows™ itself. Since most of the tools and utilities JoomlaPack uses come from the Linux™ world, Cygwin offers the most painless method for obtaining them and making sure everything works fine.

You can download Cygwin from http://www.cygwin.com/. Click the link for setup.exe, download it and run it. On the first screen, choose Install from Internet. Keep pressing Next. In the Choose a download site screen, select a mirror close to you. On the Select Packages page, select the following items on top of the defaults:

Click Next and wait for installation to complete.

Unfortunately, Cygwin doesn't offer PHP as part of its distribution. No worries, though! Any Windows™ command line program will work from within Cygwin. So, we'll have to install PHP binaries for Windows™. At the time of this writing, the current PHP version is 5.2.6. You can always get the latest version from http://www.php.net/downloads.php. Make sure you select the “PHP x.y.z installer” package (where x.y.z is the PHP version number). Download and run the installer.

For destination folder you'd better use a path with no spaces. For the purpose of this How-To, we'll assume you install PHP on C:\PHP. On the next screen, select Do not setup a web browser and click Next. On the following screen, make sure everything is installed (by default only a small subset of features is installed), this means make sure no item has a red X and no item is greyed out. Click Next and Finish. Wait for the installation to complete.

After that, edit the php.ini file found in PHP's installation directory. At the end of the file you will find a bunch of lines like this:

[PHP_BZ2]
extension=php_bz2.dll
[PHP_CURL]
extension=php_curl.dll
[PHP_DBA]
extension=php_dba.dll
[PHP_DBASE]
extension=php_dbase.dll

and so on.

Remove these lines and replace them with:

[PHP_BZ2]
extension=php_bz2.dll
[PHP_CURL]
extension=php_curl.dll
[PHP_GD2]
extension=php_gd2.dll
[PHP_GETTEXT]
extension=php_gettext.dll
[PHP_IMAP]
extension=php_imap.dll
[PHP_MBSTRING]
extension=php_mbstring.dll
[PHP_MCRYPT]
extension=php_mcrypt.dll
[PHP_MHASH]
extension=php_mhash.dll
[PHP_MIME_MAGIC]
extension=php_mime_magic.dll
[PHP_MING]
extension=php_ming.dll
[PHP_SOCKETS]
extension=php_sockets.dll
[PHP_SQLITE]
extension=php_sqlite.dll
[PHP_XSL]
extension=php_xsl.dll
[PHP_DOMXML]
extension=php_domxml.dll
[PHP_ZLIB_FILTER]
extension=php_zlib_filter.dll
[PHP_EXIF]
extension=php_exif.dll

Also, find the line

error_reporting = E_ALL

and change it to

error_reporting = E_ALL & ~E_NOTICE | E_STRICT

In order to make sure all tools can be found from the command line, we'll have to edit the system's PATH variable. Open Windows Explorer. Right-click “My Computer” icon and click on “Properties”. Go to the Advanced tab and click on the Environment Variables button. In the second list box, find and click on the “Path” variable to make it selected, then click Edit. In the end of the existing text append (do not replace with!) the following text:

;c:\cygwin\bin;c:\php

I assume you have installed Cygwin on the defaultl folder and you installed PHP on C:\PHP, which you should if you followed these instructions to the letter.

Click OK, then OK and once more OK.

First of all, make sure you have Internet access on your PC! The process you are about to go through requires a fair ammount of data to be downloaded from the Internet.

Open up the Cygwin command line by clicking on your desktop's Start - Programs - Cygwin - Cygwin Bash Shell. You'll see a UNIX-style command line. Type the following commands:

cd /usr/share
mkdir dbxsl
cd dbxsl
wget http://heanet.dl.sourceforge.net/sourceforge/docbook/docbook-xsl-ns-1.74.0.tar.bz2
tar xjf docbook-xsl-ns-1.74.0.tar.bz2
mv docbook-xsl-ns-1.74.0/* .

First of all, make sure you have Internet access on your PC! The process you are about to go through requires a fair ammount of data to be downloaded from the Internet.

If you have not done so yet, open up the Cygwin command line by clicking on your desktop's Start - Programs - Cygwin - Cygwin Bash Shell. You'll see a UNIX-style command line. In order to get a new copy of JoomlaPack's SVN and compile it you have to enter the following commands:

cd /usr/src
mkdir jp13
cd jp13
svn co http://joomlacode.org/svn/jpack/branch/1.3 .
make svn XSLSTYLEROOT=/usr/share/dbxsl/      -- alternatively, you can use: --
make svnlight XSLSTYLEROOT=/usr/share/dbxsl/

The "make svn" command includes the on-line help, whereas the "make svnlight" command does not build and include the on-line help. Use either one of them, not both! Use the com_joomlapack-svn.zip to install JoomlaPack on your site.

Next time you want to update your SVN copy and compile JoomlaPack again, you just need to type the following commands:

cd /usr/src/jp13
svn update
make svn XSLSTYLEROOT=/usr/share/dbxsl/      -- alternatively, you can use: --
make svnlight XSLSTYLEROOT=/usr/share/dbxsl/