🏗️ documentation: reST to markdown (mkdocs)develop-md

1 files changed, 88 insertions, 0 deletions

diff --git a/docs/fr/annexe-tech-2-ign-communes.md b/docs/fr/annexe-tech-2-ign-communes.md
new file mode 100644
index 000000000..f7c6269f5
--- /dev/null
+++ b/docs/fr/annexe-tech-2-ign-communes.md
@@ -0,0 +1,88 @@
+Annexe technique 2 - Import des communes IGN {#import-communes-ign}
+============================================
+
+Auteur
+
+:   Étienne Loks
+
+Date
+
+:   2020-09-23
+
+Copyright
+
+:   CC-BY 3.0
+
+------------------------------------------------------------------------
+
+[L\'IGN](http://www.ign.fr/) met à disposition sous licence libre
+([Licence
+ouverte](https://www.etalab.gouv.fr/wp-content/uploads/2014/05/Licence_Ouverte.pdf))
+les géométries du découpage administratif du territoire métropolitain
+français avec une réactualisation annuelle. Au sein d\'Ishtar, il est
+opportun de récupérer le découpage des communes avec leur géométrie
+associée. On réalise cela en deux temps : récupération des données et
+export au format CSV, puis import au sein d\'Ishtar. Il est nécessaire
+pour faire cet import d\'un accès en ligne de commande au serveur sur
+lequel est hébergé Ishtar.
+
+Récupération des données
+------------------------
+
+Le jeu de données qui nous intéresse est distribué sous le nom ADMIN
+EXPRESS. Ce jeu de données est disponible en ligne directement sur le
+site de l\'IGN : [ADMIN
+EXPRESS](https://geoservices.ign.fr/documentation/diffusion/telechargement-donnees-libres.html#admin-express).
+
+Une fois le fichier récupéré, il doit être décompressé (il faut disposer
+d\'un utilitaire à même de décompresser les archives 7z). Les fichiers
+qui nous intéressent concernent le shapefile COMMUNE ou COMMUNE\_CARTO
+(géométrie généralisée - moins précise et de fait moins volumineuse).
+Celui se trouve dans le répertoire
+[ADMIN-EXPRESS-COG/1\_DONNEES\_LIVRAISON\_\<date de livraison\>/\<zone
+concernée\>/]{.title-ref}.
+
+Ce shapefile doit ensuite être ouvert dans QGIS puis exporté au format
+CSV en n\'oubliant pas d\'inclure la géométrie au format WKT.
+
+![image](static/annexe-technique-1-export-qgis.png)
+
+Import dans Ishtar
+------------------
+
+Il ne reste plus qu\'à importer dans Ishtar. Pour cela, se connecter sur
+le serveur hébergeant Ishtar, déposer le fichier CSV que l\'on a généré,
+puis se rendre dans le répertoire d\'installation de l\'instance
+concernée. Enfin, lancer la commande suivante (en remplaçant \<année\>
+et \<chemin vers le fichier CSV\> par les valeurs adéquates) :
+
+``` {.bash}
+root@ishtar-server:# cd <chemin vers l instance> # exemple : /srv/ishtar/prod_deb
+root@ishtar-server:# python3 ./manage.py import_geofla_csv --year <année> \
+                              --srid <code epsg de la projection> <chemin vers le fichier CSV>
+root@ishtar-server:#  # exemple
+root@ishtar-server:# python3 ./manage.py import_geofla_csv --year 2019 --srid 4326 /tmp/2019.csv
+```
+
+::: {.warning}
+::: {.title}
+Warning
+:::
+
+L\'année attendue est celle correspondant à l\'année de création pour
+des communes nouvelles. Le jeu de données d\'une année concerne les
+communes créées l\'année précédente ainsi pour le jeu de données 2020,
+il faut indiquer 2019.
+:::
+
+::: {.warning}
+::: {.title}
+Warning
+:::
+
+Si l\'on souhaite garder un suivi des regroupements de communes, il est
+important de procéder à l\'import des nouvelles communes (cf.
+`import-regroupements-communes-insee`{.interpreted-text role="ref"}) de
+l\'année concernée depuis les sources INSEE avant de faire l\'import des
+géométries depuis les sources IGN.
+:::