Fix import_geofla withe new file format - update documentation for town import and installation

1 files changed, 24 insertions, 28 deletions

diff --git a/docs/fr/source/installation.rst b/docs/fr/source/installation.rst
index 261284989..68aed6fab 100644
--- a/docs/fr/source/installation.rst
+++ b/docs/fr/source/installation.rst
@@ -5,73 +5,68 @@ Installation
 ============
 
 :Auteur: Étienne Loks
-:Date: 2018-10-02
+:Date: 2020-09-23
 :Copyright: CC-BY 3.0
 
 
-.. warning::
-   Cette documentation concerne la version 1 d'Ishtar. L'installation de la version 2 via paquet n'est pas possible pour l'instant. Un travail est en cours pour que le paquet soit mis à jour d'ici fin 2018. Pour installer la version 2 « à la main », veuillez suivre les instructions sur cette `page`_.
-
-.. _page: https://gitlab.com/iggdrasil/ishtar/blob/develop/INSTALL.md
-
 Ce document présente les instructions d'installation d'Ishtar.
 
 Pour l'instant, elles se limitent à l'installation sous Debian GNU/linux via le paquet Debian.
 
+Un nom de domaine dédié est nécessaire pour chaque instance (une instance Ishtar n'est pas installable dans un sous-répertoire). Par contre un sous-domaine est tout à fait utilisable (par exemple : *ishtar.mon-domaine.net*).
+
 .. note:: Sauf mention explicite, chaque commande est exécutée en tant qu'utilisateur root. Les utilisateurs de sudo l'ajouteront à chaque commande faite.
 
-Installation sur poste Debian Wheezy
+Installation sur poste Debian Buster
 ------------------------------------
 
-Un dépôt a été mis en place pour installer sous Debian Wheezy.
+Un dépôt a été mis en place pour installer sous Debian Buster.
 Ce dépôt est signé, pour ajouter la clé du dépôt à votre gestionnaire de paquet, lancez la commande ::
 
     wget -O - http://deb.iggdrasil.net/contact@iggdrasil.net.gpg.key | apt-key add -
 
 Puis, au choix, ajoutez le dépôt à votre /etc/apt/sources.list ::
 
-    deb http://deb.iggdrasil.net/ wheezy main
-    deb-src http://deb.iggdrasil.net/ wheezy main
+    deb http://deb.iggdrasil.net/apt/debian/ buster main
+    deb-src http://deb.iggdrasil.net/apt/debian/ buster main
 
 Ou sauvegardez le fichier `iggdrasil.list`_ dans votre répertoire **/etc/apt/sources.list.d/** ::
 
-    wget -O - http://deb.iggdrasil.net/dists/wheezy/iggdrasil.list > /etc/apt/sources.list.d/iggdrasil.list
+    wget -O - http://deb.iggdrasil.net/apt/debian/dists/buster/iggdrasil.list > /etc/apt/sources.list.d/iggdrasil.list
 
-.. _iggdrasil.list: http://deb.iggdrasil.net/dists/wheezy/iggdrasil.list
+.. _iggdrasil.list: http://deb.iggdrasil.net/apt/debian/dists/buster/iggdrasil.list
 
 Ensuite mettez à jour la base de données de votre gestionnaire de paquet et installez le paquet ::
 
     apt-get update
-    apt-get install python-django-ishtar
+    apt-get install python3-django-ishtar
 
-Enfin pour créer une nouvelle instance d'Ishtar ::
+Deux paquets optionnels peuvent être installés :
 
-    INSTANCE=le_nom_de_mon_instance URL=ishtar.my-organization.net ishtar-prepare-instance
+* **ishtar-tasks** : installe un service de tâche pour gérer en tâche de fond les opérations longues (par exemple les imports). Cette installation est conseillée si vous n'êtes pas juste en ressources serveur.
+* **ishtar-libreoffice** : installe libreoffice en mode serveur pour faciliter des imports / exports aux formats bureautique. Ce service permettra notamment à terme de gérer les formats Office Open XML de la suite Microsoft Office. Peu utilisé pour le moment, l'installation de ce paquet est tout à fait optionnelle.
 
-INSTANCE est le nom de l'instance et URL le nom du domaine associé (juste l'url pas de http:// ou https://).
 
-.. note:: Le nom de domaine doit bien entendu pointer vers l'adresse IP du serveur. Si à l'issue de l'installation, le service n'est pas joignable, verifiez bien votre configuration DNS ou le cas échéant verifez bien auprès du gestionnaire de nom de domaine que c'est le cas.
+Enfin pour créer une nouvelle instance d'Ishtar ::
 
-D'autres variables sont disponibles :
+    ishtar-prepare-instance
 
-- **UWSGI_PORT** : par défaut à 8891, faites bien attention d'incrémenter ce nombre pour chaque nouvelle instance.
-- **NGINX_PORT** : si vous voulez que le serveur web réponde sur un port différent, par exemple si vous avez déjà Apache installé. Ensuite pour accéder à l'application il faudra mettre clairement le numéro de port dans l'adresse du logiciel. Exemple : http://ishtar.my-organization.net:8000
-- **DB_HOST**, **DB_PORT**, **DB_PASSWORD**, **DB_NAME** : si vous souhaitez personnaliser la base de données dans laquelle sera stockée Ishtar. Par défaut, elle sera stockée localement, sur le port par défaut de PostgreSQL (5432), le mot de passe sera généré aléatoirement, le nom de la base de données sera : « ishtar-le_nom_de_mon_instance ».
+Un ensemble de questions vous sera posé afin de déterminer les paramètres qui concernent cette instance.
 
-.. note:: Pour le nom de l'instance, seuls sont permis le tiret bas **_** et les caractères alphanumériques en minuscule. Ce nom doit commencer par un caractères alphabétique. Évitez aussi des noms pouvant entrer en conflit avec des bibliothèques Python existantes (par exemple « test »).
 
+.. note:: Le nom de domaine doit bien entendu pointer vers l'adresse IP du serveur. Si à l'issue de l'installation, le service n'est pas joignable, verifiez bien votre configuration DNS ou le cas échéant verifez bien auprès du gestionnaire de nom de domaine que c'est le cas.
 
 .. warning::
     En terme de serveur Web, cette première version de l'installateur fonctionne avec la configuration que nous considérons comme la plus optimisée qui est le couple nginx / uwsgi. À terme, l'installateur prendra aussi en compte Apache. Pour l'instant, si vous avez des services tournant sous Apache, plusieurs options se présentent à vous :
  
-    - faire tourner nginx sur un autre port (cf. la variable NGINX_PORT) ;
+    - faire tourner nginx sur un autre port ;
     - faire fonctionner vos autres services avec nginx (je vous laisse découvrir l'abondante documentation en ligne en cherchant « nginx + le nom de mon service ») ;
     - configurer Ishtar pour fonctionner avec Apache (référez vous à la `documentation de Django`_).
 
-.. _`documentation de Django`: https://docs.djangoproject.com/fr/1.9/howto/deployment/wsgi/modwsgi/
+.. _`documentation de Django`: https://docs.djangoproject.com/fr/1.11/howto/deployment/wsgi/modwsgi/
 
 L'installateur vous demandera un identifiant / mot de passe pour le compte administrateur.
-Une fois l'instance préparée une base de données a été crée avec un nom du type ishtar-le_nom_de_mon_instance (ou le nom que vous avez spécifiquement donné), Ishtar est joignable à l'adresse donnée par la variable URL et les données de cette instances sont stockées dans le répertoire /var/lib/python-django-ishtar/le_nom_de_mon_instance.
+Une fois l'instance préparée une base de données a été crée avec un nom du type ishtar-le_nom_de_mon_instance (ou le nom que vous avez spécifiquement donné), Ishtar est joignable à l'adresse donnée par la variable URL et les données de cette instances sont stockées dans le répertoire /srv/ishtar/le_nom_de_mon_instance.
 
 
 Initialisation de la base de données
@@ -107,14 +102,15 @@ Une liste des communes française peut être téléchargée et chargée ::
     wget "http://ishtar-archeo.net/fixtures/initial_towns-fr.tar.bz2"
     tar xvjf initial_towns-fr.tar.bz2
 
-    ISHTAR_PATH=/var/lib/python-django-ishtar # dépend de votre installation
-                                              # ici pour le paquet Debian
+    ISHTAR_PATH=/srv/ishtar # dépend de votre installation
+                            # ici pour le paquet Debian
     PROJECT_PATH=$ISHTAR_PATH/mon_instance
     cd $PROJECT_PATH
     ./manage.py loaddata /tmp/initial_towns-fr.json
     rm /tmp/initial_towns-fr.*
 
-Sinon un script est mis à disposition pour charger des communes depuis des données OSM : $ISHTAR_PATH/scripts/import_towns_from_osm.py
+Sinon un script est mis à disposition pour charger des communes depuis des données OSM : `$ISHTAR_PATH/scripts/import_towns_from_osm.py`.
+
 Lisez les instructions contenu dans le fichier pour savoir comment procéder.
 
 ..