team4alfanous team mailing list archive

Thread
Date

[Branch ~team4alfanous/alfanous/alfanous-git] Rev 331: Merge branch 'master' of github.com:Alfanous-team/alfanous

To: Alfanous team <team4alfanous@xxxxxxxxxxxxxxxxxxx>
From: noreply@xxxxxxxxxxxxx
Date: Fri, 07 Sep 2012 21:53:11 -0000
Reply-to: noreply@xxxxxxxxxxxxx
Sender: bounces@xxxxxxxxxxxxx

Merge authors:
  Assem Chelli (عاصم شلي) (assem-ch)
------------------------------------------------------------
revno: 331 [merge]
committer: Assem Chelli <assem.ch@xxxxxxxxx>
timestamp: Fri 2012-09-07 07:39:00 +0100
message:
  Merge branch 'master' of github.com:Alfanous-team/alfanous
modified:
  AUTHORS.rst
  FAQ.rst
  README.rst
  src/alfanous-desktop/README.rst


--
lp:alfanous
https://code.launchpad.net/~team4alfanous/alfanous/alfanous-git

Your team Alfanous team is subscribed to branch lp:alfanous.
To unsubscribe from this branch go to https://code.launchpad.net/~team4alfanous/alfanous/alfanous-git/+edit-subscription

=== modified file 'AUTHORS.rst'
--- AUTHORS.rst	2012-08-18 11:42:24 +0000
+++ AUTHORS.rst	2012-09-07 00:49:56 +0000
@@ -20,7 +20,7 @@
 .. _`Assem Chelli`: https://github.com/assem-ch
 .. _`Abdellah Chelli`: https://github.com/sneetsher 
 .. _`Zaki Smahi`: https://github.com/zsmahi
-
+.. _`Mouad Debbar` : https://github.com/mdebbar
 
 ============ 
 Contributors 
@@ -30,7 +30,7 @@
 --------
 * API & JSON interface: `Assem Chelli`_    
 * Desktop Interface: `Assem Chelli`_   
-* Web Interface: `Assem Chelli`_   , `Abdellah Chelli`_ , Mouad Debbar, Ahmed Ramadan
+* Web Interface: `Assem Chelli`_   , `Abdellah Chelli`_ , `Mouad Debbar`_, Ahmed Ramadan
 * Mobile Web Interface: `Abdellah Chelli`_ 
 * Firefox toolbar: `Zaki Smahi`_ 
 

=== modified file 'FAQ.rst'
--- FAQ.rst	2012-09-03 22:41:31 +0000
+++ FAQ.rst	2012-09-07 04:56:00 +0000
@@ -2,20 +2,15 @@
 FAQ 
 ===
 
+-----------------
+What is Alfanous? 
+-----------------
+see `what-is-alfanous <https://github.com/Alfanous-team/alfanous/blob/master/README.rst#what-is-alfanous>`_.
+
 --------------
 Why Alfanous? 
 --------------
-* Alfanous is FREE LIBRE OPEN SOURCE: Any one can use it and any one can contribute in coding, translating, design...etc. alfanous will die only if his community dies
-
-* Alfanous is a Python API: that allow anyone to create independently a web interface, desktop interface , Android/Iphone/Windows phone interfaces , facebook/twitter/G+ applications .... . the search process is too fast and too stable
-
-* Alfanous is a research project : so we figure out features not only do what other websites/applications do.
-
-* Alfanous has lot of features: check it your self in the desktop interface # http://sourceforge.net/projects/alfanous/files/Interfaces/AlfanousDesktop/ 
-
-* Alfanous has many interfaces for many platforms: Desktop for linux/windows, Web (wui.alfanous.org | m.alfanous.org) ...
-
-* Alfanous is Free gratis : no payment, no ads 
+see `why-alfanous <https://github.com/Alfanous-team/alfanous/blob/master/README.rst#why-alfanous>`_.
 
 --------------------------
 Why we called it Alfanous?  
@@ -26,9 +21,7 @@
 ------------------
 How to contact us?
 ------------------
-You can contact us via the mailing list on Google groups:  `alfanous@xxxxxxxxxxxxxxxx <http://groups.google.com/group/alfanous>`_ .
-Here also the emails of `Maintainers <https://github.com/Alfanous-team/alfanous/blob/master/AUTHORS.rst#maintainers>`_.
-
+see `contacts <https://github.com/Alfanous-team/alfanous#contacts>`_.
 
 -----------------
 How you can help?
@@ -42,6 +35,7 @@
   - 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 <https://www.facebook.com/alfanous>`_ `@Twitter <https://twitter.com/alfanous>`_ `@GooglePlus <https://plus.google.com/111305625425237630318>`_ 
 
@@ -55,6 +49,7 @@
 - Packaging the project for different systems: Windows, Linux distributions, MacOs.
 - Donating/Supporting to the project: *we're stuck here, looking for possible ways for donations since Algeria is  very restricting foreign transactions. Any help is appreciated*
 
+For more discussion, you can contact us via the mailing list : `alfanous@xxxxxxxxxxxxxxxx <http://groups.google.com/group/alfanous/>`_
 
 
 --------------------

=== modified file 'README.rst'
--- README.rst	2012-08-23 12:12:24 +0000
+++ README.rst	2012-09-07 06:30:38 +0000
@@ -16,6 +16,23 @@
 
 
 
+--------
+Contacts
+--------
+- If you have a concrete bug report for Alfanous please go to the `Issues Tracker  <https://github.com/Alfanous-team/alfanous/issues>`_, submit your report and tag it "bug".
+
+- If you want to participate in actively developing Alfanous,  read this `How to contribute?  <https://github.com/Alfanous-team/alfanous/blob/master/FAQ.rst#how-to-contribute>`_. 
+
+- If you want to help in Alfanous somehow,  read this `How you can help?  <https://github.com/Alfanous-team/alfanous/blob/master/FAQ.rst#how-you-can-help>`_. 
+
+- If you have a feature request, a proposition or a question for the project, you may use the mailing list.
+
+- If you want to criticize the project, we'll be thankful if you resume your criticism and send it to the mailing list.
+
+For anything else, you can contact us via the mailing list:  `alfanous@xxxxxxxxxxxxxxxx <http://groups.google.com/group/alfanous>`_ .
+Here also the emails of `Maintainers <https://github.com/Alfanous-team/alfanous/blob/master/AUTHORS.rst#maintainers>`_, use them wisely.
+
+
 --------------
  Why Alfanous? 
 --------------
@@ -26,20 +43,69 @@
 
 * Alfanous is a research project : so we figure out features not only do what other websites/applications do.
 
-* Alfanous has lot of features: check it your self in the desktop interface ( `Arabic <http://sourceforge.net/projects/alfanous/files/Interfaces/AlfanousDesktop/0.3/alfanousDesktop-windows-0.3ar.exe/download>`_ `@English <http://sourceforge.net/projects/alfanous/files/Interfaces/AlfanousDesktop/0.4.3/alfanousInstallerV0.4.3.exe/download>`_ )
+* Alfanous has lot of features: see `Search Features`_.
 
-* Alfanous has many interfaces for many platforms: Desktop for linux/windows, Web (http://wui.alfanous.org | http://m.alfanous.org) ...
+* Alfanous has many interfaces for many platforms: see `Interfaces`_.
 
 * Alfanous is Free gratis : no payment, no ads 
 
 see `FAQ <https://github.com/Alfanous-team/alfanous/blob/master/FAQ.rst>`_
 
---------
-Contacts
---------
-- If you have a concrete bug report for Alfanous please go to the `Issues Tracker  <https://github.com/Alfanous-team/alfanous/issues>`_, submit your report and tag it "bug".
-
-- If you want to participate in actively developing Alfanous,  read this `How to contribute?  <https://github.com/Alfanous-team/alfanous/blob/master/FAQ.rst#how-to-contribute>`_. 
+----------
+Interfaces
+----------
+#. Alfanous Python API, `source <https://github.com/Alfanous-team/alfanous/tree/master/src/alfanous>`_.
+#. JSON web interface, `link <http://www.alfanous.org/json>`_, actually we're moving to JSON web interface II, `source <https://github.com/Alfanous-team/alfanous/tree/master/src/alfanous-cgi>`_.
+#. Web User interface [Arabic], `link <http://wui.alfanous.org/>`_, `source <https://github.com/Alfanous-team/alfanous/tree/master/interfaces/web/wui>`_.
+#. Web User interface for mobiles [Multi-language], `link <http://m.alfanous.org/>`_, `source <https://github.com/Alfanous-team/alfanous/tree/master/interfaces/web/mobile_wui>`_.
+#. Alfanous Desktop application (Windows: `[Arabic] <http://sourceforge.net/projects/alfanous/files/Interfaces/AlfanousDesktop/0.3/alfanousDesktop-windows-0.3ar.exe/download>`_ `[English] <http://sourceforge.net/projects/alfanous/files/Interfaces/AlfanousDesktop/0.4.3/alfanousInstallerV0.4.3.exe/download>`_; Ubuntu/Sabily), `source <https://github.com/Alfanous-team/alfanous/tree/master/src/alfanous-desktop>`_. 
+#. Alfanous Firefox toolbar, `link <https://addons.mozilla.org/en-us/firefox/addon/alfanous-toolbar/>`_, `source <https://github.com/Alfanous-team/alfanous/tree/master/interfaces/toolbars/firefox>`_.
+#. Alfanous Firefox search bar addon, `link <https://addons.mozilla.org/en-us/firefox/addon/alfanous/>`_.
+#. Django app (alpha), `source <https://github.com/Alfanous-team/alfanous/tree/master/src/alfanous-django>`_.
+#. Chrome extension (alpha), `source <https://github.com/Alfanous-team/alfanous/tree/master/interfaces/toolbars/chrome>`_.
+#. App for Nokia S60 (prototype), `source <https://github.com/Alfanous-team/alfanous/tree/master/interfaces/smart_phones/alfanousS60>`_.
+#. Facebook app (prototype), `source <https://github.com/Alfanous-team/alfanous/tree/master/interfaces/web/facebook_app>`_.
+#. Third party:
+  * `Alfanous4WP7 <http://www.windowsphone.com/en-US/apps/f9e1504d-ce31-4802-a2d1-24ff9f41a06e>`_ by  Abdelmoumen BOUABDALLAH ,  source: unavailable.
+  * `Alfanous4Iphone <http://itunes.apple.com/us/app/alfanws-mhrk-bhth-qrany-mtqdm/id543646326?mt=8>`_ by i4islam, source: closed.
+
+**note:** you can find the perspective interfaces under the milestone: `Extra Interfaces <https://github.com/Alfanous-team/alfanous/issues?milestone=8&page=1&sort=updated&state=open>`_.
+
+---------------
+Search Features
+---------------
+This is the list of search features already implemented, preview links use Alfanous web user interface: www.alfanous.org. 
+
+#. Exact Word: that is the simple search, eg: `فأسقيناكموه <http://alfanous.org/?search=%D9%81%D8%A3%D8%B3%D9%82%D9%8A%D9%86%D8%A7%D9%83%D9%85%D9%88%D9%87>`_
+#. Phrase: for searching a whole phrase rather then independent words, eg:`"رسول الله" <http://alfanous.org/%22%D8%B1%D8%B3%D9%88%D9%84%20%D8%A7%D9%84%D9%84%D9%87%22>`_
+#. Logical relations
+
+   * Conjuction: for searching only the ayahs that contains two terms or more, eg: `الصلاة + الزكاة <http://alfanous.org/?search=%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%A9%20%2B%20%D8%A7%D9%84%D8%B2%D9%83%D8%A7%D8%A9>`_.
+   * Disjunction (default): for searching all the ayahs that contains one of two terms or more, eg:`الصلاة | الزكاة <http://alfanous.org/?search=%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%A9%20%7C%20%20%D8%A7%D9%84%D8%B2%D9%83%D8%A7%D8%A9>`_.
+   * Exception: for eleminating a term from search results, eg:`الصلاة - الزكاة <http://alfanous.org/?search=%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%A9%20-%20%20%D8%A7%D9%84%D8%B2%D9%83%D8%A7%D8%A9>`_. You can understand it as "Ayahs that contains الصلاة but doesn't contain الزكاة". 
+
+#. Wildcards or Jokers: for search all words that share many letters, we have:
+ 
+   * Asterisk: replace zero or many undefined letters, eg: `*نبي* <http://alfanous.org/?search=*%D9%86%D8%A8%D9%8A*>`_
+   * Interogation mark: replace one undefined letter, eg: `نعم؟ <http://alfanous.org/?search=%D9%86%D8%B9%D9%85%D8%9F>`_
+
+#. Fielded  search: to search in more information of Quran , not only ayahs'text, we cite here the most significant fields for users:
+
+   * aya_id or رقم_الآية (Aya local ID): that's the number of ayah inside its sura, use it for example to search all first ayahs (`رقم_الآية:1 <http://alfanous.org/?search=%D8%B1%D9%82%D9%85_%D8%A7%D9%84%D8%A2%D9%8A%D8%A9%3A1>`_).
+   * sura_id or رقم_السورة (Sura ID): use it with  aya_id to specify an exact ayah,for example the first ayah of surate an-nass will be :  `aya_id:1 + sura_id:114 <http://alfanous.org/?search=aya_id%3A1%20%2Bsura_id%3A114>`_.       
+   * subject or موضوع (Topics): thats field contains all topics information, it will be helpful to search for a topic,eg:  `موضوع:الشيطان <http://alfanous.org/?search=%D9%85%D9%88%D8%B6%D9%88%D8%B9%3A%D8%A7%D9%84%D8%B4%D9%8A%D8%B7%D8%A7%D9%86%20>`_
+   for more fields, see: `Fields <https://github.com/Alfanous-team/alfanous/tree/master/src/alfanous#fields>`_
+
+#. Intervals: this will be helpful in statistics or positions, for example search the divine name only in the first surahs: `رقم_السورة :[1 الى 5 ] + الله <http://alfanous.org/?search=%D8%B1%D9%82%D9%85_%D8%A7%D9%84%D8%B3%D9%88%D8%B1%D8%A9%20%3A%5B1%20%D8%A7%D9%84%D9%89%205%20%5D%20%2B%20%D8%A7%D9%84%D9%84%D9%87>`_
+#. Partial vocalization: to consider given diacritics and ignore the others, eg: `آية_ :'مَن' <http://alfanous.org/?search=%D8%A2%D9%8A%D8%A9_%20%3A'%D9%85%D9%8E%D9%86'>`_.
+#. Word Properties: to search using root and type of words, type could be اسم, فعل or أداة,eg: `{قول،اسم} <http://alfanous.org/?search=%7B%D9%82%D9%88%D9%84%D8%8C%D8%A7%D8%B3%D9%85%7D%20>`_.
+#. Derivations
+
+   * light (using lemma): to search all the words having the same lemma of the given word,eg: `>ملك <http://alfanous.org/?search=%3E%D9%85%D9%84%D9%83>`_.
+   * heavy (using root): to search all the words having the same root of the given word,eg: `>>ملك <http://alfanous.org/?search=%3E%3E%D9%85%D9%84%D9%83>`_. 
+
+
+**note:** you can find the perspective search features under the milestones: `Quranic Search Features Pack 1 <https://github.com/Alfanous-team/alfanous/issues?milestone=7&state=open>`_,  `Quranic Search Features Pack 2 <https://github.com/Alfanous-team/alfanous/issues?milestone=10&state=open>`_.
 
 -------
 History

=== modified file 'src/alfanous-desktop/README.rst'
--- src/alfanous-desktop/README.rst	2012-09-05 20:39:57 +0000
+++ src/alfanous-desktop/README.rst	2012-09-07 03:47:20 +0000
@@ -12,7 +12,7 @@
 ------------------
 How to contribute?
 ------------------
-* Browse the issues under the milstone: `Django Web Interface 0.7 <https://github.com/Alfanous-team/alfanous/issues?milestone=1&state=open>`_
+* Browse the issues under the milstone: `AlfanousDesktop 0.7 <https://github.com/Alfanous-team/alfanous/issues?milestone=1&state=open>`_
 * Read about how to use `Alfanous API <https://github.com/Alfanous-team/alfanous/blob/master/src/alfanous/README.rst>`_, Qt designer, PyQt 
 * Fork the source, Do your changes then make a pull request to `Alfanous-team/alfanous <https://github.com/Alfanous-team/alfanous>`_