Previous: Windows installer, Up: Installation



2.5 Windows installation from the sources

This is an emergency solution in case that you can't (or don't want to) install tbook with the installer described in the previous section.

Make sure that you have installed the following programs on your system:

  1. Saxon. You may find it at http://saxon.sourceforge.net. There are two versions: “Instant Saxon” which is easier to install but runs rather slowly and “Full Saxon” that comes as a Java archive. The Saxon homepage offers detailed installation instructions. Anyway, it's important that there is an executable program called saxon on your computer, which may be an EXE or a batch file (shell script). Don't install Saxon 7, but Saxon 6.5.x!
  2. TeX. Get the latest MikTeX distribution or the TeXLive CD. The installation shouldn't be too hard.
  3. Ghostscript. Get AFPL Ghostcript and install also GSView, although only Ghostscript is needed by tbook.

  4. xindy. This is only necessary if you want to create index directories for your texts. It normally doesn't come with TeX, although it should. You find it on the xindy project page. Follow the installation instructions in the package, then installation should be easy.

Make sure that all programs are in your PATH environment variable and thus can be found by tbook!

Then install tbook: Copy the Zip file on your hard disk and unpack it with e.g. Winzip. All files are unpacked into a subdirectory of the current one. Open a command line interpreter (MS-DOS shell) and go into this subdirectory.

The first thing you have to do is to edit the file install.bat. Edit the SET ...=... entries at the beginning of the file and substitute your directory names for the default values. Then delete the two lines

pause
goto end

at the beginning of install.bat.

Then start install.bat. Maybe you have to be administrator to do this. After this, set the environment variable TBLIBDIR and set it to the value that you also gave in install.bat. For this, you probably have to edit autoexec.bat. At least on my system.

Make sure that the binary files of tbook wander in a directory (BINDIR) that is part of your PATH!

After that, you will probably have to update TeX's file database. How this is done depends on your TeX implementation. With MikTeX e.g., it's an item in the MikTeX program group of the start bar.

That's it. Hopefully.

If you're looking for a good free XML editor, have a look at Cooktop.