# noor /

Filename Size Date modified Message
docs
noor
45 B
34.2 KB
116 B
2.8 KB
3.5 KB
6.2 KB
516 B
1.2 KB
1.1 KB

# Noor, A python Quran viewer

## Overview

Noor is a program written in Python for viewing quran. Currently it contains a GTK interface that uses PyGtk library, a CGI interface that can be used in web servers and a text interface that outputs a sura to a text file. Also you can specify translation files; The translation of each aya is shown after it.

## New Features

• Changing CGI and GTK interfaces fonts

## Getting Started

For using the GTK interface you need to install Python and PyGTK (they are installed by default in some linux distributions like Ubuntu). You can start it by running "noorgtk.py" script either from the command line or by double clicking it in the extracted folder. That is, no installation is necessary.

But if you like, you can run "python setup.py install" to install Noor. After that you'll be able to run "noorgtk.py" in the terminal from any location.

Installing the CGI script, "noorcgi.py", is like installing any other CGI script. You probably have to copy it to the cgi-bin directory of your web server. Bu before that you should either install noor as described in the previous paragraph or change the line in noorcgi.py file which looks like:

# Add noor to the python path if its not installed:
sys.path.append('/noor/extracted/folder/')


to point to the folder in which you've extracted noor. Note that if you want to use the CGI interface you no longer need to install PyGTK.

You can edit the ~/.noor file:

[common]
translation = /path/to/translation/file


The translation file can be in two formats. It can be either a zip file in the same format as Zekr translation files which can be obtained from http://siahe.com/zekr/resources.html or it can be a utf-8 text file with translation of each aya in one line.

### Changing Font

You can change the GTK or CGI fonts in ~/.noor file:

[gtk]
font = nazli 19

[cgi]
font = nazli 4


This program is under the terms of GNU GPL (GNU General Public License). Have a look at COPYING file for more information.

## Source Repository

Noor uses Mercurial CMS:

## Contributing

Patches to noor's code are welcome.

Patch style: