Documentation is now exhaustive and zerobin is apache friendly

docs/fr/apache_install.rst

@@ -2,8 +2,7 @@
 Installation avec Apache
 =========================
 
-Apache est plus lent, plus lourd, et plus complexe à mettre en oeuvre que Nginx.
-Mais il est aussi beaucoup plus connu:
+Apache est plus lourd que Nginx mais il est aussi beaucoup plus connu:
 
 - plus de gens pourront vous aider les fora;
 - votre hébergeur propose surement Apache;
@@ -34,9 +33,67 @@ l'installation du modle Apache mod_wsgi. Si vous ne savez pas comment faire,
 ou si vous ne pouvez pas le faire (par exemple sur un hébergement mutualisé
 qui ne le propose pas), il vous faudra choisir l'installation CGI.
 
+Premièrement, assurez-vous d'avoir mod_wsgi installé et chargé (en tant qu'admin)::
 
-Mod_CGI
-==========
+    a2enmod wsgi
+
+Ceci va activer mod_wsgi. Si cela ne marche pas, il faudra l'installer d'abord (
+sur ubuntu, le paquet est libapache2-mod-wsgi)
+
+Ensuite, il faut créer un fichier de configuration Apache, généralement dans
+/etc/apache/sites-available/. Nommez le zerobin::
+
+    <VirtualHost *:80>
+        ServerName www.votersiteweb.com
+
+        WSGIDaemonProcess zerobin user=www-data group=www-data processes=1 threads=5
+        WSGIScriptAlias / /chemin/vers/zerobin/app.wsgi
+
+        <Directory /chemin/vers/zerobin/>
+            WSGIProcessGroup zerobin
+            WSGIApplicationGroup %{GLOBAL}
+            Order deny,allow
+            Allow from all
+        </Directory>
+    </VirtualHost>
+
+Activez le site web (en tant qu'admin)::
+
+    a2ensite zerobin
+
+Et rechargez la configuration d'Apache (en tant qu'admin)::
+
+    service apache2 reload
+
+Vous aurez noté que l'on fait référence à un fichier nommé app.wsgi. C'est un
+fichier Python qui créé l'application qu'Apache va utiliser pour lancer le
+processus Python::
+
+    import os, sys
+
+    # s'assurer que le module zerobin est dans le PYTHON PATH et importable
+    ZEROBIN_PARENT_DIR = os.path.dirname(os.path.dirname(__file__))
+    sys.path.insert(0, ZEROBIN_PARENT_DIR)
+
+    # créer le wsgi callable
+    from zerobin.routes import get_app
+    settings, application = get_app(compressed_static=True)
+
+Vous pouvez bien sûr créer le votre, puisque la fonction `get_app` et le seul
+moyen de passer des paramètres à 0bin avec cette installation. Cela peut se
+faire en créant un fichier de configuration et en le passant à la fonction::
+
+    import os, sys
+
+    ZEROBIN_PARENT_DIR = '/chemin/du/dossier/parent/de/zerobin'
+    sys.path.insert(0, ZEROBIN_PARENT_DIR)
+
+    from zerobin.routes import get_app
+    settings, application = get_app(settings_file='/path/to/settings.py')
+
+CGI
+===
+
+Vous pouvez aussi utiliser CGI, mais nous n'avons pas encore eu le temps de
+couvrir cette partie. Contactez nous si vous avez besoin de l'utiliser.
 
-Cette installation est considérée comme relativement lente. Mais vous bénéficierez
-tout de même de la robustesse d'Apache