Installation: Difference between revisions
Updated to release 0.9.1 |
m Updated to version 1.0.3 |
||
| (5 intermediate revisions by the same user not shown) | |||
| 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 8: | Line 11: | ||
!bgcolor="lightgreen"|Common Package Name | !bgcolor="lightgreen"|Common Package Name | ||
|- | |- | ||
| [http://wordnet.princeton.edu/ | | [http://wordnet.princeton.edu/wordnet/download/ wordnet] | ||
|align="center"| 3.0 ||align="center"| wordnet-dev | |align="center"| 3.0 ||align="center"| wordnet-dev | ||
|- | |- | ||
| [http://www.gtk.org/download.html glib] | | [http://www.gtk.org/download.html glib] | ||
|align="center"| 2. | |align="center"| 2.28 ||align="center"| libglib2.0-dev | ||
|- | |- | ||
| [http://www.gtk.org/download.html gtk+] | | [http://www.gtk.org/download.html gtk+] | ||
|align="center"| 2. | |align="center"| 2.24 ||align="center"| libgtk2.0-dev | ||
|- | |||
| [http://www.freedesktop.org/wiki/Software/DBusBindings dbus-glib] | |||
|align="center"| 0.70 ||align="center"| libdbus-glib-1-dev | |||
|} | |} | ||
| Line 23: | Line 29: | ||
* [http://www.gnu.org/software/autoconf/#downloading Autoconf] (>= 2.50) | * [http://www.gnu.org/software/autoconf/#downloading Autoconf] (>= 2.50) | ||
* [http://www.gnu.org/software/automake/#downloading Automake] | * [http://www.gnu.org/software/automake/#downloading Automake] | ||
* [http://pkg-config.freedesktop.org/wiki/ pkg-config] | * [http://pkg-config.freedesktop.org/wiki/ pkg-config] | ||
If you have installed GTK+ and | If you have installed GTK+, GLib and dbus-glib properly, ''pkg-config'' should be able to give the CFLAGS and LIBS params of the libraries on the following command: | ||
pkg-config --cflags --libs | $ pkg-config --cflags --libs gtk+-2.0 glib-2.0 dbus-glib-1 | ||
==Optional Libraries== | ==Optional Libraries== | ||
===Notifications=== | ===Notifications=== | ||
For Notifications feature to be available, you need [http://www.galago-project.org/downloads.php libnotify | For Notifications feature to be available, you need [http://www.galago-project.org/downloads.php libnotify's] (>= 0.4.1) binary (libnotify.so.1 or higher) available on your system. The development headers of libnotify is not required, just the runtime of libnotify alone is enough. | ||
'''NOTE:''' Even though libnotify (necessary condition) is enough for Artha to expose the ''Notifications'' feature, the sufficient condition to actually see the notifications appear on-screen is to have the [http://www.galago-project.org/downloads.php notification daemon] installed. It is this daemon which actually will put up the notifications requested by Artha. | |||
===Suggestions=== | ===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 [[Wikipedia:Aspell|GNU Aspell]] and an [ftp://ftp.gnu.org/gnu/aspell/dict/en/aspell6-en-6.0-0.tar.bz2 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. | 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 [[Wikipedia:Aspell|GNU Aspell]] and an [ftp://ftp.gnu.org/gnu/aspell/dict/en/aspell6-en-6.0-0.tar.bz2 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. | ||
===Regex Search=== | |||
For regular expressions based search to work, the sense index file '''''index.sense''''' of WordNet should be available on your system, in the same directory as your other WordNet dict files. | |||
==Configuring and Building== | ==Configuring and Building== | ||
Once you have the tar ball from [[Download]]. Extract it. This will create a directory ''artha-0. | Once you have the tar ball from [[Download]]. Extract it. This will create a directory ''artha-1.0.3''. | ||
tar xzvf artha-0. | $ tar xzvf artha-1.0.3.tar.bz2 | ||
cd artha-0. | $ cd artha-1.0.3 | ||
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. | 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 | $ ./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. | 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. | ||
| Line 58: | Line 63: | ||
To build give | To build give | ||
make | $ make | ||
| Line 64: | Line 69: | ||
You need to install Artha to run it, successful building is necessary but not sufficient. To install artha you need ''root'' privileges. | 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'') | # make install (as ''root'') | ||
Once the installation is complete, you can run Artha | Once the installation is complete, you can run Artha | ||
artha | $ artha | ||
Or give ''man'' for Artha's manual | Or give ''man'' for Artha's manual | ||
man artha | $ man artha | ||
A shortcut will also get created in the Applications | 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. | ||
Latest revision as of 19:34, 7 October 2012
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.28 | libglib2.0-dev |
| gtk+ | 2.24 | libgtk2.0-dev |
| dbus-glib | 0.70 | libdbus-glib-1-dev |
You will need the following tools to build:
- GNU Compiler Collection (GCC)
- Autoconf (>= 2.50)
- Automake
- pkg-config
If you have installed GTK+, GLib and dbus-glib properly, pkg-config should be able to give the CFLAGS and LIBS params of the libraries on the following command:
$ pkg-config --cflags --libs gtk+-2.0 glib-2.0 dbus-glib-1
Optional Libraries
Notifications
For Notifications feature to be available, you need libnotify's (>= 0.4.1) binary (libnotify.so.1 or higher) available on your system. The development headers of libnotify is not required, just the runtime of libnotify alone is enough.
NOTE: Even though libnotify (necessary condition) is enough for Artha to expose the Notifications feature, the sufficient condition to actually see the notifications appear on-screen is to have the notification daemon installed. It is this daemon which actually will put up the notifications requested 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.
Regex Search
For regular expressions based search to work, the sense index file index.sense of WordNet should be available on your system, in the same directory as your other WordNet dict files.
Configuring and Building
Once you have the tar ball from Download. Extract it. This will create a directory artha-1.0.3.
$ tar xzvf artha-1.0.3.tar.bz2 $ cd artha-1.0.3
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.
