On all supported platforms, TrEd requires a Perl language interpreter, the Perl-Tk module (a GUI library for Perl), and depending on the I/O _backends used also various XML related modules. Installation of all these tools differs on Unix-like and Windows platforms.
To install TrEd on your system follow the instructions specific for your platform below:
TrEd for Windows requires ActivePerl. Due to its re-distribution restrictions, the tool cannot be bundled with TrEd and you have to download and install it separately from:
If the ActivePerl Installer complains about
being unable to create entries in the windows registry due to
missing permissions, just press Ignore
.
In that case you may need to point TrEd Installer to
the directory in which you installed ActivePerl, as described below.
To finish the installation, download a TrEd installer for Windows from the project's homepage. This single package contains TrEd as well as all required Perl modules. To complete the installation, run the installer and follow the instructions.
The installer tries to automatically
detect the current ActivePerl installation
based on Windows registry entries.
Sometimes (e.g. if ActivePerl was installed by
some other user and the registry entries
are not readable)
the auto-detection may fail; for such cases, the
installer offers an option to browse to the folder
containing the installation of Perl
(usually c:\perl
),
which bypasses the registry.
The last step of the installer allows you
to select and install some of the
extension packages.
For example, the users of the Prague Dependency Treebank 2.0 are adviced
to install at least the pdt20
extension package.
(Note that extensions can be
installed anytime later, using
the Extension Manager.
It is not recommended to run TrEd with the CygWin distribution of Perl (but you can install ActiveState Perl, even if you already have a Perl installation in CygWin). If you really must try running TrEd in CygWin, follow the instructions for setup on UNIX-like systems (but you have been warned).
Almost every today's UNIX/Linux system contains a Perl installation, so we expect that you already have a working Perl setup (version >= 5.8.3 is required but at least 5.8.8 is recommended).
TrEd further requires at least the following Perl modules and their dependencies:
File-Temp
File-Which
File-Spec
Text-Iconv
Tie-IxHash
Tk
(for GUI)Compress-Zlib
(for printing to PDF)XML-LibXML
(requires libxml2)XML-Simple
XML-Writer
Archive-Zip
TrEd along with all the required Perl modules and libraries can be installed
in one step using an installer script install_tred.bash
, as follows:
$wget http://ufal.mff.cuni.cz/~pajas/tred/install_tred.bash
$bash install_tred.bash --tred-dir ~/tred
This installs TrEd under ~/tred
and all missing modules and libraries
under ~/tred/dependencies
. TrEd should be started using a wrapper script
~/tred/bin/start_tred
which configures correct library paths.
The installation script offers several options that allow custom choice of installation paths and also supports installation of development versions of TrEd from SVN. Use
$ bash install_tred.bash --help
for more information.
Check your installation with:
$ ~/tred/bin/start_tred -v
TrEd 1.3587 2008-10-01 14:16:32Z
Perl: 5.008008
Platform: linux
Tk: 804.028
If you get a similar output, you have successfully installed TrEd
on your system. You can add ~/tred/bin
to your PATH or symlink all ~/tred/bin/start_*
scripts to some
directory in your PATH, e.g. ~/bin
.
Unfortunatelly, another commonly used package contains an executable named tred, namely the GraphViz package by AT&T. This tool requires standard input, so if you attempt to start TrEd using the command tred and it just hangs, you may be running the GraphViz tool, not the tree editor TrEd.