Installation: Difference between revisions

From Artha
Updated to release 0.9.1
m Prefixed 'Who should read this' details
Line 1: Line 1:
If you are installing Artha using prebuilt binaries (.deb), please visit the [[Download]] page for installation instructions. If you are building Artha from source then this page is for you.
==Dependencies==
==Dependencies==
Artha directly depends on the following libraries. Please note that you will need to have the development headers (.h and .a/.so) of these libraries along with the actual library files.
Artha directly depends on the following libraries. Please note that you will need to have the development headers (.h and .a/.so) of these libraries along with the actual library files.
Line 73: Line 76:
     man artha
     man artha


A shortcut will also get created in the Applications main menu, under Accessories.
A shortcut will also get created in the ''Applications->Accessories'' menu.




==Uninstalling==
==Uninstalling==
To uninstall Artha give a ''make uninstall'' (as root)
To uninstall Artha give a ''make uninstall'' (as root) in a Terminal window.

Revision as of 10:01, 13 September 2009

If you are installing Artha using prebuilt binaries (.deb), please visit the Download page for installation instructions. If you are building Artha from source then this page is for you.


Dependencies

Artha directly depends on the following libraries. Please note that you will need to have the development headers (.h and .a/.so) of these libraries along with the actual library files.


Library Min. Version Common Package Name
wordnet 3.0 wordnet-dev
glib 2.14 libglib2.0-dev
gtk+ 2.12 libgtk2.0-dev


You will need the following tools to build:

If you have installed GTK+ and GLib properly, pkg-config should be able to give the cflags and libs of GTK+ and GLib on the following command.

   pkg-config --cflags --libs libgtk+-2.0


Optional Libraries

Notifications

For Notifications feature to be available, you need libnotify-dev (>= 0.4.1) and libdbus-glib-1-dev (>= 0.74). Also pkg-config should be able to give the cflags and libs of libnotify and libdbus-glib on the following command.

   pkg-config --cflags --libs libnotify dbus-glib-1


It is to be noted that even though libnotify is enough (necessary condition) to build Artha with notifications feature, the sufficient condition to actually see the notifications appear on-screen is to have notification daemon installed. This is to be installed, which will actually put up the notifications on request by Artha.

Suggestions

For Artha to show suggestions when a misspelled word is queried, libenchat binaries (run time files) are required. While building Artha, libenchant's development headers are not required. Artha looks for libenchat's availability only at run-time. Also a valid spell checker like GNU Aspell and an English dictionary that works with that spell checker, is required to be installed for libenchant to work. The locale of the English dictionary is not an problem; any English dictionary that could work with the installed spell checker is sufficient.


Configuring and Building

Once you have the tar ball from Download. Extract it. This will create a directory artha-0.9.1.

   tar xzvf artha-0.9.1.tar.gz
   cd artha-0.9.1

Now you can configure. Use the prefix parameter to install it in /usr and by default configure configures it to /usr/local, which is not the actual path for installations.

   ./configure --prefix=/usr

If you have all the aforementioned dependencies right, configure will end with no errors. Should it encounter errors, follow the on-screen instructions it says to fix them.

To build give

   make


Installing

You need to install Artha to run it, successful building is necessary but not sufficient. To install artha you need root privileges.

   make install (as root)

Once the installation is complete, you can run Artha

   artha

Or give man for Artha's manual

   man artha

A shortcut will also get created in the Applications->Accessories menu.


Uninstalling

To uninstall Artha give a make uninstall (as root) in a Terminal window.