Why we called it Alfanous?¶
Alfanous is an arabic word “الفانوس” that means the Lantern. The name was inspired from a picture that contains a Mushaf, a chronometer and a lantern.
It didnt find the word X while I checked it exists!¶
Alfanous use the exact matching for words as default, so if you look for alzaytoon (الزيتون), you will not find it because it occurs in Quran as wazzaytoon (والزيتون). Yet, you will find it in suggestions or derivations. You can activate fuzzy search to search all close words to searched words.
- Why we use exact match?
- It is better for statistical search.
How you can help?¶
You can help us by:
- Spreading the word
- Following and sharing our social network pages : @Facebook @Twitter @GooglePlus
- Sharing a link to our website via your accounts in Social networks.
- Pointing skilled developers and Quranic researchers to the importance of the project.
- Writing articles about the project in blogs, newspapers.
- Showing a banner on your Blog/Website.
- creating an ad for alfanous links using Google adwords or facebook if you’re familiar with that (btw,it needs money)
- Managing and Animating our social network pages with news and daily posts [Arabic, English]: @Facebook @Twitter @GooglePlus
- Translating project interfaces to your language , we are using Launchpad platform for translation, link here.
- Testing the modules and releases, Reporting bugs , see How to report a bug? and How to help by testing? .
- Fixing bugs , Coding new features or Developing new interfaces , See: `How to Contribute?`_ .
- Designing Icons, Logoes , Banners.
- Packaging the project for different systems: Windows, Linux distributions, MacOs.
- Donating/Supporting to the project: We’re stuck looking for possible ways for donations/Funding. Any help is appreciated!
For more discussion, you can contact us via the mailing list : email@example.com
How to report a bug?¶
If you have a concrete bug report for Alfanous please go to the Issues Tracker, submit your report and tag it “bug”.
How to contribute by translation?¶
- Contact us to confirm the translation need into your language and to request the PO file.
- Use Use Poedit or Virtaal to edit it and complete the translation.
- Send us the update po file so we can include it in the website.
How to contribute by donation?¶
Funding is a critical point for our project. Whereas we’re stuck looking for possible ways to get. Donations as far as we tried is so restricted in our home country so Any help in that is appreciated!
Any way you can:
How to contribute by coding?¶
If you are a coder, and want to participate in actively developing Alfanous :
- Learning Git is essential, read about Set up Git and you can also try it online here!
- Browse a milestone and choose an open issue (or more) that fits your skills.
- To get more information about any issue you can contact us on mailing list: or leave a comment on the issue.
- Start with forking the repository and preparing your development environment, see How to prepare your development environment to contribute?.
- Prepare your changes, test them and then make a pull request to alfanous-team when you think your code is ready.
- The project is not well documented but you may find helpful information in Readme files:
See also How you can help?
How to help by testing?¶
If you want to help us testing the project modules, just follow these steps and Sooner as you encounter a problem, stop testing and submit it as an issue in our issue tracker and then send about it to the mailing list (firstname.lastname@example.org):
Get the code source:
Run the build:
Go to the root path of the code source and execute this command
$ make build
/bin/sh: python2: not found : if you dont have the command “python2”, create one using a symbolic link
$ python --version Python 2.7.4 $ sudo ln -s /usr/bin/python2.7 /usr/bin/python2
ImportError: No module named pyparsing : you need to install pyparsing python library
$ sudo pip pyparsing
Install the API:
Also in the root path of the code source, execute the command
$ make install_api_no_arguments
Test the console interface, it provides results in Json format:
$ alfanous-console -h $ alfanous-console -a search -q qawol $ alfanous-console -a search -q الصلاة+الزكاة $ ...
Test the basic script:
$ cd src/alfanous-tests $ python sample.py
Test the desktop interface:
$ cd src/alfanous-desktop $ python Gui.py
Test the installation of alfanous-desktop as a library
$ sudo python setup.py install $ alfanous-desktop
Test the json output system II
install it in apache as a cgi script
# Install apache2 first $ sudo make install_jos2
test it in browser by checking those links
Test Django app (don’t forget to install django)
run the server
$ cd src/alfanous-django $ python manage.py runserver
test it in browser by checking this link
Test Firefox toolbar
$ make dist_xpi
use it, you’ll find the package in output folder with the extension .xpi
Test Ubuntu/Sabily package
run the command of packaging
$ make dist_deb
Add sabily repository and test the package
Test Windows Installer script (later)
Test MacOs package (later)
Test PyCorpus (later)
See also How you can help?
How to prepare your development environment to contribute?¶
Best OS for that is Ubuntu (>11.10).
Secondly, install git-scm and then clone locally your fork :
git clone LINK_OF_GITHUB_FORK.
then run in the root of your local repo:
$ make build
then run also in the same path:
$ sudo make install_api_no_arguments
test the installation with this command:
$ alfanous-console -h
Forth, prepare your dev tool :
- if you want work on web tasks, install aptana with pydev plugin (install apache2 also for local tests).
- else install eclipse with pydev plugin.
- or you can just use a simple text editor.
You can also use git with eclipse, by installing EGit.
How API works?¶