Instructions for a windows installation:

These instruction can be found in c:\page\doc.

The new installation package is page-2.3.exe. Running the installation program page-2.3.exe does not install Python, Tcl, Tix. It will be necessary to do those installs separately. Fortunately, they are all standard installations. They should be install before PAGE. The steps necessary are the following:

I have just installed Python 2.3.3 and in the process the installation actually includes tix; it doesn't work because they have used tix8183 and tcl/tk 8.4 and they are not compatible. But the PAGE installation package will replace the tix8183 stuff with tix8184 files.



  1. Install Python-2.3.x Download Python-2.3.x.exe from www.python.org. The default installation directory is C:\Python23 and that is where I put it. To complete the installation you will need to add the installation directory to your path; running the page installer attempts to invoke a python script that moves some required files into the python install directory. If python is not in the PATH then the installer will fail to move those files. Incidently, the fix-up script is python_fix.py in the WIN_INSTALL subdirectory.

  2. Install Tcl. The version that I have been testing with is ActiveTcl8.4.5.0-win32-ix86-83642.exe which is available from activestate.com. You may think that Python installs tcl support, but support for executing tcl scripts is missing and that is required for running PAGE. I recommend that you install Tcl into C:\Tcl; it's the default directory. To complete the installation you will need to add the {installation directory}/bin to your path. That is, if you did use C:\Tcl as the installation directory then add C:\Tcl\bin to your path.

  3. Install Tix into the same directory into which you installed Tcl. Unfortunately, the Tix home page does not as yet provided a binary Tix installer for windows. As a temporary expedient I have provided tix8184_install.exe. When executing tix8184_install.exe, use as the installation directory the one used for Tcl. You might expect the name to be tix8134.exe, but I used a different name so that it would not be confused with an "official" release. I suspect that soon an official tix installer will be available. Obviously, that is the one you will want to use.

  4. Execute page-2.3.exe to install PAGE and when given a chance to select the input directory make your choice. Obviously, I like c:\page. I recommend that you add the installation directory to your path. As part of executing page-2.3.exe, Tix files will be transfered from the Tcl installation directory to the Python installation directory. This is necessary for executing Tix under Python. A dialog box will appear allowing you to cancel this transfer. In general it is necessary to do it at least once following the Tix install and the Python install. However, it is not necessary to do it repeatedly. It is done using a python script, so if the python executable is not in the PATH, then this necessary step will fail with a rather cryptic message. The message may indicate "Unable to execute python.exe". This step installs an icon on the desktop. For it to work properly the script winpg.bat mentioned below needs to be set correctly.

  5. winpg.bat in the PAGE install directory is a one-liner which is:
          tix8184.exe c:\page\page.tcl %1
    
    which assumes that tix8184.exe is in your execution path and that page is installed in c:\page. If tix8184.exe is not in your path then change tix8184.exe to be the full path specification of the file. If PAGE is not installed in c:\page replace 'c:\page' the full path of the installation directory.
The windows installation of PAGE will move the necessary Tix files from the Tcl installation directory into the Python installation directory tree. So it is necessary to have Tcl and Python already installed when you are installing PAGE. This move is done with a python script so be sure the python directory is in the PATH environmental variable.

The installation can be tested by executing the following command:

	c:\page\winpg

which will test the PAGE installation itself. When it comes up, try

	 File -> Open -> examples/t3.tcl.

The other interesting command is:

	python t3.py

which runs the the python GUI generated by PAGE.

If things don't seem to work you can try the following steps to confirm the installation.