====== Installing Zim on Linux or Unix ======

This page describes how to install Zim manually on a Linux or Unix system. A number of Linux distributions have standard packages for Zim now, using these is usually the easiest.

===== Dependencies =====

==== Perl ====
You need to have perl 5.8.0 or newer installed. This is a standard package in almost any distribution.

==== Gtk+ ====
This program uses the gtk+ toolkit version 2.4 or newer.
It is NOT backward compatible with gtk+ 2.0 and 2.2.

==== Gtk-Perl ====
You can install the Glib and Gtk2 perl modules from [[http://search.cpan.org|CPAN]], however check if your distribution has standard packages for this first, this will usually be much easier.

==== CPAN modules ====
You will need the following modules, which are all available from [[http://search.cpan.org|CPAN]]:

	Module::Build
	Test::More
	Storable
	File::Spec
	File::BaseDir
	File::MimeInfo

Optional modules:

	Gtk2::TrayIcon
	Gtk2::Spell    (requires gtkspell)

To install a module from CPAN you can run the following command: ''perl -MCPAN -e install foo::bar''.

===== Installing Zim =====

To install using only perl:

	$ perl ./Build.PL
	$ ./Build
	$ ./Build test
	$ ./Build install

or if you have GNU Make available, you can try:

	$ ./configure
	$ make
	$ make test
	$ make install

For more information about install targets etc. see the
documentation for the ''Module::Build'' perl module.

