======================
 Message de Bienvenue
======================

:Author: Laurent Pointal
:Contact: laurent.pointal@laposte.net
:Révision: 1.01
:Date: 2007-08-30

... contents::

... note::

    Ce texte a été écrit il y a quelques années  suite à des échanges
    animés  sur  la liste  de  discussions  pythonfr.  Il a  pour but
    d'introduire les  nouveaux lecteurs  à la façon dont fonctionnent
    les listes  de discussion  et les newsgroups  Usenet,  et de leur
    donner des pistes de recherche d'informations,  afin de conserver
    en ces lieux  de discussion des échanges  sereins entre personnes
    de bonnes volonté  -  on peut toujours s'engueuler,  mais pour de
    bonnes raisons.

    Il est posté environ une fois par mois sur la liste *pythonfr* et
    sur le newsgroup *fr.comp.lang.python*.
    La derniÚre  version `texte`_  de ce document  est  disponible en
    ligne,  de  même  que  la  version  `HTMLisée`_  (traitement  via
    rst2html).
   
    .. _texte: http://www.limsi.fr/Individu/pointal/python/MessageBienvenue.txt
    .. _HTMLisée: http://www.limsi.fr/Individu/pointal/python/MessageBienvenue.txt.html


... |fr| replace:: *(en français)*
... |en| replace:: *(en anglais)*
... |livre-papier| replace:: *(dispo aussi dans le commerce sous forme de livre papier)*


------------
Introduction
------------
   
Bienvenue sur la  liste Python francophone,  hébergée par l'AFUL, ou
sur le newsgroup fr.comp.lang.python ("fclp").

Votre  abonnement à  cette  liste de diffusion ou   votre lecture de
fclp montrent  un intérêt  pour le  langage Python  et ce qui tourne
autour. AprÚs quelques temps de lecture, vous serez sûrement amené à
poster vous aussi un message. Voici quelques conseils d'utilisation,
suivi d'une série  de liens à partir  desquels vous  pourrez trouver
des informations sur Python et sur son utilisation.

Si  vous  n'êtes  pas  habitué(e)  à  l'utilisation  des  listes  de
diffusions,  la lecture  de  la  traduction  française  du  document
`smartquestions`_  devrait  vous  aider  à  poser  correctement  vos
questions afin d'avoir des réponses.

... _smartquestions: http://www.gnurou.org/writing/smartquestionsfr


Par  rapport   au  document  ci-dessus,   fclp  et   python-fr  sont
francophones,  donc  les  participants  s'attendent à  recevoir  des
questions et  réponses en français.  Des citations de documentations
en anglais pour  répondre à des interrogations sont  possibles, mais
de courtes  traductions sont  bienvenues pour les "pythoneurs" mal à
l'aise avec Shakespeare. Si vous avez une question à poser, un titre
('subject') clair et concis ainsi qu'un texte bien rédigé facilitent
la lecture et favorisent une éventuelle réponse. Si à l'inverse vous
voulez  donner  une réponse publique,  un petits  guide du bon usage
est disponibles dans `L'art et la maniÚre de répondre sur Usenet`_.

... _L'art et la maniÚre de répondre sur Usenet:
    http://www.usenet-fr.net/fur/usenet/repondre-sur-usenet.html

Afin d'éviter  que  ne se retrouvent  des questions  récurrentes  ou
encore des  interrogations  auxquelles un  minimum de lecture aurait
pû   répondre,  il  est  bienvenu,  avant de poser   une   question,
d'avoir  effectué  des  recherches   parmi  les  liens indiqués  ci-
dessous,   ainsi  que  sur  l'Internet  à  l'aide  des  moteurs   de
recherche (liste non exhaustive à la fin de ce message).



----------------------
Documentations Locales
----------------------

Vous devriez  avoir la  documentation  standard de Python (tutoriel,
références du langage,  documentation sur les modules, documentation
sur les extensions...) installée avec le programme:

  - Sous **linux**, voyez dans `/usr/share/doc/python`
    ou `/usr/share/doc/python-docs`,
    éventuellement avec `-2.5` (numéro de version) derriÚre.
 
  - Sous **Windows**, Python ajoute un lien vers la documentation au
    format Microsoft Help dans son groupe de programmes dans le menu
    Démarrer / Programmes.
   
  - Sur **Macintosh**, voyez le document "Documentation - start
    here.html" dans le dossier Python.


 
--------------------------
Archives Listes/Newsgroups
--------------------------

|fr|
 
La liste **python-fr**:

  :Site/archives: https://www.aful.org/wws/info/python
  :Abonnement: mailto:sympa@aful.org?subject=subscribe%20python
  :Désabonnement: mailto:sympa@aful.org?subject=unsubscribe%20python
  :Wiki associé: http://wikipython.flibuste.net/
                 (merci à William Dodé)
  :Miroir gmane:
        - http://news.gmane.org/gmane.comp.python.french
        - nntp://news.gmane.org/gmane.comp.python.french

Le newsgroup **fr.comp.lang.python**:

  :Usenet: news:fr.comp.lang.python
  :Miroir google: http://groups.google.com/groups?group=fr.comp.lang.python

|en|

Le newsgroups **comp.lang.python** (trÚs fort traffic):

  :Usenet: news:comp.lang.python
  :Miroir google: http://groups.google.com/groups?group=comp.lang.python


... note::

    Pour les annonces (nouvelles versions de Python ou de modules),
    voir le newsgroup news:comp.lang.python.announce.

    Plus généralement, `Gmane`_ référence (et donne accÚs via http
    et nntp) toute une série de listes concernant Python et les
    principaux packages.

    .. _Gmane: http://news.gmane.org/index.php?prefix=gmane.comp.python



--------------    
Sites Généraux
--------------    

Collections de liens:
 
  - *python eggs:*
    http://www.python-eggs.org/ (merci à l'auteur)

  - *ma collection perso:*
    http://www.limsi.fr/Individu/pointal/python.html

  - *PYTHON facile - Les ressources (liens) en français sur Python*
    http://pythonfacile.free.fr/python/ressources.html
   
   
~~~~~~~~~~~~~~~~
Sites Principaux
~~~~~~~~~~~~~~~~

|en|

  - http://www.python.org/
 
  - *téléchargement:*
    http://www.python.org/download/       
   
  - *docs en général:*
    http://www.python.org/doc/            
   
  - *documentations d'introduction:*
    http://www.python.org/doc/Intros.html 
   
  - *foires aux questions (FAQ):*
    http://www.python.org/doc/FAQ.html    
 
      - *générale:*
        http://www.python.org/doc/faq/general
     
      - *programmation:*
        http://www.python.org/doc/faq/programming
     
      - *libraires et modules d'extension:*
        http://www.python.org/doc/faq/library
     
      - *écriture de modules compilés / python embarqué:*
        http://www.python.org/doc/faq/extending
     
      - *problÚmes et trucs sous Windows:*
        http://www.python.org/doc/faq/windows
     
      - *interfaces graphiques:*
        http://www.python.org/doc/faq/gui
 
  - *conseils, guides pour les débutants:*
    http://wiki.python.org/moin/BeginnersGuide
 
  - *groupes d'intérêts spécifiques (SIG):*
    http://www.python.org/community/sigs/           
                                    
  - *contributions communautaires, le wiki:*
    http://wiki.python.org/moin/
                               

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Autres sources d'informations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|en|

  - *HOWTOs:*
    http://py-howto.sourceforge.net/      
   
  - *base de connaissances FAQTS:*
    http://www.faqts.com/knowledge_base/index.phtml/fid/199
                                          
  - *ancienne liste de sites:* [2]_
    http://py.vaults.ca/parnassus/apyllo.py/682269989
                                 
  - *Active State Python Cookbook:*
    http://aspn.activestate.com/ASPN/Python/Cookbook/
                                 
  - *liste de docs sur le Wiki Python:*
    http://wiki.python.org/moin/PythonDocumentation

  - *Python Quick Reference, condensé de doc dans une page HTML:*
    http://rgruet.free.fr/
   
  - *Python Quick Reference Card, condensé de doc dans un
    document PDF a imprimer:*
    http://perso.limsi.fr/pointal/python/pqrc/

|fr|

  - *Association Francophone Python (AFPY)*
    http://www.afpy.org/
   
  - *Portail Python Francophone:*
    http://www.python-fr.org/
   
  - *PythonFrance.com - sources:*
    http://www.pythonfrance.com/

  - *Python Blanc Bleu Belge:*
    http://www.p3b.org/
   
  - *Python chez Developpez.com:*
    http://python.developpez.com/
    
  - *traductions de certaines parties de la documentation:*
    http://frpython.sourceforge.net/



-------------
Apprentissage
-------------

|en|

  - *tutoriel:* [1]_
    http://www.python.org/doc/current/tut/tut.html
   
  - *référence:* [1]_
    http://www.python.org/doc/current/ref/ref.html
   
  - *introductions:*
    http://www.python.org/doc/Intros.html
   
  - *liens documentations débutants:*
    http://wiki.python.org/moin/BeginnersGuide

  - *"Instant Python" (par l'auteur de "Practical Python"),
    pour aller vite:*
    http://www.hetland.org/python/instant-python.php
   
  - *"Dive Into Python" - tutoriel Python par l'exemple pour
    les programmeurs:*
    http://diveintopython.org/

  - *"How to think like a Computer Scientist (Python)" (Allen
    B. Downey, Jeffrey Elkner et Chris Meyers):*
    http://www.ibiblio.org/obp/thinkCSpy/
    |livre-papier| http://www.greenteapress.com/thinkpython/

|fr|

  - *la page d'intro à Python de l'IUT de Villetaneuse:*
    http://www-gtr.iutv.univ-paris13.fr/Cours/Mat/Python/BibPython

  - *les notes de cours et TPs Python de l'IUT d'Orsay (Robert
    Cordeau):*
    http://www.iut-orsay.fr/dptmphy/Pedagogie/
   
  - *"Apprendre à Programmer avec Python" (Gérard Swinnen), cours
    complet d'apprentissage de la programmation avec Python:*
    http://www.ulg.ac.be/cifen/inforef/swi/download/python_notes.pdf
    |livre-papier| http://www.oreilly.fr/catalogue/2841772993

  - *Cours et TPs Programmation en langage Python (H.Garreta et
    L.Tichit):*
    http://www.dil.univ-mrs.fr/~garreta/PythonBBSG/index.html
   
  - *"Python est mon ami" (Ludovic Pinelli), introduction à la
    programmation avec Python :*
    http://ludovic.pinelli.free.fr/Python/Python_ami.html

  - *Plusieurs introductions à Python sur le Python Blanc Bleu
    Belge:*
    http://www.p3b.org/tutor

  - *Python & Cie - Le forum des débutants en Python:*
    http://artyprog.freezope.org/Forum/Python/index_html

  - *traduction en français de Dive Into Python - tutoriel Python
    par l'exemple:*
    http://diveintopython.org/#languages
 
  - *tutoriels AFPY:*
    http://www.afpy.org/python/tutoriels/

   
--------------------
Pour aller plus loin
--------------------

|en|

  - *"Thinking in Python" (Bruce Eckels):*
    http://www.mindview.net/Books/TIPython

  - *pour apprendre les astuces, le Python Cookbook:*
    http://aspn.activestate.com/ASPN/Python/Cookbook/

  - *"Charming Python" (D.Mertz):*
    http://gnosis.cx/publish/tech_index_cp.html

  - *guide de style pour avoir des sources Python sympa à relire
    (et accessoirement pour éviter certaines erreurs):*
    http://www.python.org/dev/peps/pep-0008/



-------
Modules
-------

~~~~~~~~~~~~~~~~~~~
Modules d'extension
~~~~~~~~~~~~~~~~~~~

  - *modules standards:* [1]_
    http://docs.python.org/lib/lib.html

  - *PyPI - le Python Package Index:*
    http://pypi.python.org/
    *que l'on peut parcourir par catégories:*
    http://pypi.python.org/pypi?%3Aaction=browse
   
  - *Vault of Parnassus: Python Resources (ancien dépot de
    modules d'extension):* [2]_
    http://www.vex.net/parnassus/  



~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Extension/interfaçage avec le C/C++
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|en|

  - *écriture de modules d'extention en langage C:* [1]_
    http://docs.python.org/ext/ext.html
                               
  - *interface de programmation (API Python) C:* [1]_
    http://docs.python.org/api/api.html

  - *integration avec d'autres langages sur le wiki:*
    http://www.python.org/cgi-bin/moinmoin/IntegratingPythonWithOtherLanguages

  - *boost Python:*   
    http://www.boost.org/libs/python/doc/index.html
 
  - *swig:*
    http://www.swig.org/
   
  - *mes liens dans la section autres langages:*
    http://www.limsi.fr/Individu/pointal/python.html#liens-intautlang
   
   
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Interfaces graphiques (GUI-Graphical User Interface)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|en|

  - *Foire Aux Questions Graphic User Interface Programming:*
    http://www.python.org/doc/faq/gui/
   
  - *images et graphisme sur le wiki:*
    http://wiki.python.org/moin/GraphicsAndImages

  - *Python GUI Programming (Michele Moore), liste de GUI et
    liens:*
    http://www.metaslash.com/brochure/tutorial/
   
  - *Tkinter sur le wiki:*
    http://wiki.python.org/moin/TkInter

  - *An Introduction to Tkinter (F.Lundh):*
    http://www.pythonware.com/library/tkinter/introduction

  - *Tkinter Life Preserver (Matt Conway):*
    http://www.python.org/doc/life-preserver/

  - *mes liens dans la section Graphisme:*
    http://www.limsi.fr/Individu/pointal/python.html#liens-graph
   
  - *modules GUI & Co sur le Vault of Parnassus:* [2]_
    http://py.vaults.ca/parnassus/apyllo.py/302299380 (graphisme)
    http://py.vaults.ca/parnassus/apyllo.py/238168060 (jeux)
    http://py.vaults.ca/parnassus/apyllo.py/808292924 (interface utilisateur)


|fr|
  - *Tkinter en 10 leçons à l'université de Pau:*
    http://www.univ-pau.fr/~bruel/Enseignements/TER/InterfacePython/tutoriel_tkinter.html

  - *Module graphique Tkinter pour Python:*
    http://www.jchr.be/inf/doc/tkinter.htm
                        
                        
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Développement WWW, XML, HTML, CGI...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|en|

  - *Python and XML Processing:*
    http://pyxml.sourceforge.net/topics/
   
  - *groupe d'intérêt XML:*
    http://www.python.org/community/sigs/current/xml-sig/
   
  - *programmation WWW sur le wiki (serveurs, frameworks,
    templates...):*
    http://wiki.python.org/moin/WebProgramming/ 
 
  - *support protocoles de l'Internet sur le wiki:*
    http://wiki.python.org/moin/InternetSupport

  - *support réseau sur le wiki:*
    http://wiki.python.org/moin/NetworkingSupport
 
  - *serveur applicatif Zope:*
    http://www.zope.org/

  - *mes liens dans la section texte (XML, HTML...):*
    http://www.limsi.fr/Individu/pointal/python.html#liens-texte-xml
    *- et dans la section réseaux:*
    http://www.limsi.fr/Individu/pointal/python.html#liens-reseau
   
|fr|

  - *mailing list zope fr:*
    http://www.zope.org/Resources/MailingLists
   
  - *portail Zope francophone:*
    http://www.zopera.org/


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Calcul et utilisation scientifique
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|en|

  - *calcul numérique et utilisation scientifique sur le wiki:*
    http://wiki.python.org/moin/NumericAndScientific
   
  - *mes liens dans la section science:*
    http://www.limsi.fr/Individu/pointal/python.html#liens-science

  - *modules mathématiques sur le Vault of Parnassus:* [2]_
    http://py.vaults.ca/parnassus/apyllo.py/684222876

   
~~~~~~~~~~~~~~~~
Bases de données
~~~~~~~~~~~~~~~~

|en|
  - *bases de données, modules, docs:*
    http://www.python.org/topics/database/    
   
  - *programmation des bases de données sur le wiki:*
    http://wiki.python.org/moin/DatabaseProgramming
   
  - *interfaces bases de données sur le wiki:*
    http://wiki.python.org/moin/DatabaseInterfaces
   
  - *groupe d'intérêt bases de données:*
    http://www.python.org/community/sigs/current/db-sig/
 
  - *mes liens dans la section bases de données:*
    http://www.limsi.fr/Individu/pointal/python.html#liens-db
   
  - *modules bases de données sur le Vault of Parnassus:* [2]_
    http://py.vaults.ca/parnassus/apyllo.py/973100124


------
Livres
------

Voyez sur les sites des librairies  en ligne, il y a de plus en plus
de  livres  sur Python  (vous  pouvez chercher  les  références  sur
amazon, et faire fonctionner votre libraire local).

|en|


  - *liste de livres sur le wiki:*
    http://wiki.python.org/moin/PythonBooks

  - *liste de livres sur ma page de liens:*
    http://www.limsi.fr/Individu/pointal/python.html#liens-livres
 
  - *chez O'Reilly (US) (indiquez Python dans le champs "search
    for"):*
    http://www.oreillynet.com/search/
 
  - *collection de versions électronique de livres dans le but
    de se faire un avis avant un achat!:*
    http://www.miex.org/book.html

|fr|

  - *livres en français sur le wiki:*
    http://wiki.python.org/moin/FrenchPythonBooks

  - *chez O'Reilly (france):*
    http://www.oreilly.fr/tags/python

  - *chez Eyrolles:*
    http://www.eyrolles.com/php.informatique/Ouvrages/resultat_recherche_ouvrages.php3?words=python&theme=INF


   
--------------------
Moteurs de recherche
--------------------

Avec les  documentations  en ligne,  c'est un  des premiers réflexes
que l'on  devrait avoir avant  de poser une question  dans un forum,
une liste  de discussion ou  un newsgroup:  consulter les moteurs de
recherche sur l'Internet.

Il est  important de  savoir préciser  sa demande,  en utilisant les
options de recherche  avancée,  généralement  `-xxxxx`  pour exclure
les  résultats  contenant   le  terme  xxxxx,   `"xxxxx xxxx"`  pour
rechercher  l'expression  `xxxxx xxxx` exacte (et non pas chaque mot
séparément) - *on utilise souvent la recherche exacte avec un copier
coller  d'un message  d'erreur casse-pied  afin de  trouver  comment
d'autres  personnes  qui y ont  déjà été  confrontées  ont résolu le
problÚme*.


Voici quelques moteurs de recherche, liste non exhaustive.


~~~~~~~~~~~~~~~~~~~~~
Recherches sur le Web
~~~~~~~~~~~~~~~~~~~~~

  - *Google*
 
      - *Centre d'Aide:*
        http://www.google.fr/support/
     
      - *Moteur de recherche:*
        http://www.google.com/
       
      - *Recherche avancée:*
        http://www.google.com/advanced_search?hl=fr
     
      - *Python sur Google:*
        http://www.google.fr/search?q=python

  - *Metacrawler (interroge d'autres moteurs de recherche):*

      - *Moteur de recherche:*
        http://www.metacrawler.com/customize/
       
      - *Python sur Metacrawler:*
        http://www.metacrawler.com/info.metac/search/web/python/

  - *Hotbot (maintenant sous Lycos):*
 
      - *Moteur de recherche:*
        http://www.hotbot.com/
       
      - *Python sur Hotbot:*
        http://www.hotbot.com/?query=Python

  - *Exalead:*
    http://www.exalead.fr/search
   
  - *Kartoo (présente ses résultats sous forme de carte graphique -
    flash inside):*
    http://www.kartoo.com/
   
   
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Recherche sur Usenet (newsgroups)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - *Google-groups (ex-DejaNews):*
    http://groups.google.com/
   
      - *recherche avancée:*
        http://groups.google.com/advanced_group_search?hl=fr
       
      - *Sujets sur comp.lang.python:*
        http://groups.google.com/group/comp.lang.python/topics?hl=fr
       
      - *Sujets sur comp.lang.python:*
        http://groups.google.com/group/fr.comp.lang.python/topics?hl=fr


... note::
    Sans passer par la page de recherche avancée, il est possible de
    spécifier  `group:xxx.yyy.zzz` pour  rechercher  dans  un groupe
    particulier.

       
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Recherche dans les codes sources
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Certains moteurs de recherche  indexent  les codes  de projets open-
source,  ce qui permet de  trouver rapidement  des  exemples de mise
en oeuvre de certains modules.

  - *Krugle:*
    http://krugle.com/
   
  - *Google code search:*
    http://www.google.com/codesearch
   
  - *Koders:*
    http://www.koders.com/
 
   
   
...
    _____________________________________________________________________
    Notes:

...  [1] Il s'agit de documentations standards qui sont
        normalement installées avec Python sur votre machine.

...  [2] Le *Vault of Parnassus: Python Resources* fut un des principaux
        sites indexant et stockant des ressources (liens, modules,
        documentations) sur Python.
        Il n'est plus à jour, mais on y trouve encore des informations
        qui peuvent être intéressantes.