Zekr

From openSUSE

This procedure was tested on openSUSE 11.0 x86_64

Introduction

Zekr is an open platform Quran study tool. It is an project planned to be an universal, open source, and cross-platform application to perform most of the usual refers to Quran. The main idea is to build an as generic as possible platform to accept different Islamic resources.

Zekr is written in Java, on Eclipse platform, and uses SWT as widget toolkit. It works on different platforms, such as Windows (XP, Vista), Linux (most popular distributions) and Mac. This article will focuss only on the SUSE/openSUSE distribution.

At the moment Zekr 0.7.1 is released.

Requirements

• Java 1.4.2 or higher.
• A version of a Mozilla GTK2 (1.4+)/ Firefox browser.

Installion

Incomplete | Yet to be done

1. Go to http://zekr.org/quran/quran-for-linux
2. From this page download the zekr-version-linux.tar.gz. There used to be a RPM-package, but this package cannot be found anymore from the site. Therefore, the most obvious solution would be to install Zekr as on all other Linux platforms by downloading the TAR-package.
3. Untar this package and place it where you like it.
4. Once untar the package, you should make sure to set your Firefox/Mozilla installation directory manually in the zekr.sh file as MOZILLA_FIVE_HOME variable.
5. As you already have Firefox (Mozilla) installed, you should find out its location (like /usr/local/firefox, /usr/share/firefox, or /usr/lib/firefox), and check whether the components folder is inside the Firefox/Mozilla home directory. You should set an environment variable MOZILLA_FIVE_HOME to the Mozilla home directory in the zekr.sh file. If there is no components folder inside Mozilla home, check [path mozilla]/lib, and if there was such a folder, set the environment variable to this location. To set the variable put this line in zekr.sh file:

   export MOZILLA_FIVE_HOME=/usr/share/mozilla

   or set this variable to whatever location your Mozilla is installed.
6. There is also a possibility that in the zekr.sh file the location is already set. It just needs to be uncomment.

   # uncomment and change the following line to a proper Mozilla-GTK2 installation directory.<br>
   # export MOZILLA_FIVE_HOME=/usr/lib/firefox

Running Zekr

Incomplete | Yet to be done

Because this is a manual installation, Zekr does not appears in the menu nor in your favored terminal. In order to run Zekr, you have several options. You can either run ALT+F2 and enter "Zekr" (or the path to zekr.sh) and Zekr will be loaded. Or you can manually add Zekr to the menu.

When adding Zekr to the menu, click right on the menu-button and choose "Menu Editor". Then choose in which category you wish Zekr to be placed in, like "Education". Click right on the "Education" and choose "New Item". Enter "Zekr" as name and a dialog appears where you can configure the Zekr program.

Name: Zekr
Description: Free to fill in yourself
Comment: Free to fill in yourself
Command: path to zekr.sh

For using the Zekr-icon, click on the "Select Icon" - button and browse for Other Icons for to the path of icons in the Zekr directory. This would be

[path to zekr-directory]/res/image/icon/zekr.ico

Extensions

Zekr has extensions in order to customize the program to make it more simple to study the Quran. Zekr has translations and recitations. Besides that, Zekr also provides some theme packages.

Installing Translations

1. First go to Translation Page and download the translation(s) you wish to download.
2. Then open Zekr, choose Tools > Add > Translation
3. Choose one or more translation files from the open dialog.
4. Select then the import option. Two options are displayed: Me only and All users (requires write access to installation direction). Select Me only if you don't want other users of the computer to see the translation. Select All users if you want other users to see this translation in Zekr.
5. A message will show that you have successfully added the translation(s).
6. In the Zekr-windows, choose View > Translation and choose the translation you favor.

Installing Recitations

Incomplete | Yet to be done

External Links

• Official Home Page
• Download Zekr
• Zekr Installation Guide
• Installing Java

Passed QA check: --Shayon 17:33, 19 October 2009 (UTC)