Update documentation

9 files changed, 803 insertions, 1 deletions

diff --git a/docs/fr/Makefile b/docs/fr/Makefile
index ddcbacfe8..24ff3e64e 100644
--- a/docs/fr/Makefile
+++ b/docs/fr/Makefile
@@ -36,7 +36,18 @@ help:
 clean:
 	-rm -rf $(BUILDDIR)/*
 
-html:
+dot:
+	for FILE in `ls source/media-src/*.dot`; do \
+		filename=$$(basename -- "$$FILE") ; \
+		extension="$${filename##*.}" ; \
+		filename="$${filename%.*}" ; \
+		echo $$extension ; \
+		echo $$filename ; \
+		dot -Tpng source/media-src/$$filename.dot > \
+			source/_static/$$filename.png ; \
+	done
+
+html: dot
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
diff --git a/docs/fr/source/_static/graphique-structure-ishtar.png b/docs/fr/source/_static/graphique-structure-ishtar.png
new file mode 100644
index 000000000..61707abfc
--- /dev/null
+++ b/docs/fr/source/_static/graphique-structure-ishtar.png
diff --git a/docs/fr/source/_static/graphique_structure_ishtar.png b/docs/fr/source/_static/graphique_structure_ishtar.png
new file mode 100644
index 000000000..997de1f6f
--- /dev/null
+++ b/docs/fr/source/_static/graphique_structure_ishtar.png
diff --git a/docs/fr/source/index.rst b/docs/fr/source/index.rst
index a89a831e7..72f90e6bb 100644
--- a/docs/fr/source/index.rst
+++ b/docs/fr/source/index.rst
@@ -12,3 +12,6 @@ Contents:
    :maxdepth: 3
 
    installation
+   principes
+   interface-utilisateur
+   interface-administrateur
diff --git a/docs/fr/source/interface-administrateur.rst b/docs/fr/source/interface-administrateur.rst
new file mode 100644
index 000000000..8e8506b6d
--- /dev/null
+++ b/docs/fr/source/interface-administrateur.rst
@@ -0,0 +1,17 @@
+.. -*- coding: utf-8 -*-
+
+========================
+Interface administrateur
+========================
+
+:Auteur: Étienne Loks
+:Date: 2018-10-02
+:Copyright: CC-BY 3.0
+
+
+.. _configuration-instance-ishtar:
+
+Configuration de l'instance Ishtar
+----------------------------------
+
+WIP
diff --git a/docs/fr/source/interface-utilisateur.rst b/docs/fr/source/interface-utilisateur.rst
new file mode 100644
index 000000000..e262e0df9
--- /dev/null
+++ b/docs/fr/source/interface-utilisateur.rst
@@ -0,0 +1,121 @@
+.. -*- coding: utf-8 -*-
+
+============
+Installation
+============
+
+:Auteur: Étienne Loks
+:Date: 2016-08-31
+:Copyright: CC-BY 3.0
+
+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.
+
+.. note:: Sauf mention explicite, chaque commande est exécutée en tant qu'utilisateur root. Les utilisateurs de sudo l'ajouteront à chaque commande faite.
+
+.. contents::
+
+Installation sur poste Debian Wheezy
+------------------------------------
+
+Un dépôt a été mis en place pour installer sous Debian Wheezy.
+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
+
+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
+
+.. _iggdrasil.list: http://deb.iggdrasil.net/dists/wheezy/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
+
+Enfin pour créer une nouvelle instance d'Ishtar ::
+
+    INSTANCE=le_nom_de_mon_instance URL=ishtar.my-organization.net ishtar-prepare-instance
+
+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.
+
+D'autres variables sont disponibles :
+
+- **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 ».
+
+.. 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 »).
+
+
+.. 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 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/
+
+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.
+
+
+Initialisation de la base de données
+------------------------------------
+
+Ishtar dispose de beaucoup de tables de paramétrage permettant d'avoir un logiciel au plus proche de vos besoins.
+Remplir toutes ces tables est fastidieux, c'est pour cela que des jeux de données de base sont disponibles.
+Lors de l'installation du paquet, à l'exception des communes (trop lourdes pour être inclues de base), cette initialisation est faite. Si vous avez opté pour cette installation vous pouvez passer tout de suite à l'initialisation des communes.
+
+Initialisation des paramètres de base
+*************************************
+
+Pour charger toutes les données par défaut ::
+
+    ISHTAR_PATH=/srv/ishtar # dépend de votre installation
+    PROJECT_PATH=$ISHTAR_PATH/mon_instance
+    cd $PROJECT_PATH
+    for data in $(find ../ -name "initial_*-fr.json"); do
+        ./manage.py loaddata $data
+    done
+
+Sinon regarder le détail de chaque fichier json et charger individuellement. Exemple ::
+
+    cd $PROJECT_PATH
+    ./manage.py loaddata ../ishtar_common/initial_importtypes-fr.json
+
+Initialisation des communes
+***************************
+
+Une liste des communes française peut être téléchargée et chargée ::
+
+    cd /tmp
+    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
+    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
+Lisez les instructions contenu dans le fichier pour savoir comment procéder.
+
+..
+  TODO:
+  .. warning:: L'installateur présume que vous avez un nom de domaine dédié pour votre installation. Si cela n'est pas le cas, reportez vous à la section de la documentation concernée.
+  paramètres de settings utiles :DEFAULT_FROM_EMAIL = "robot@iggdrasil.net", SERVER_EMAIL EMAIL_HOST  EMAIL_PORT  EMAIL_HOST_USER EMAIL_HOST_PASSWORD EMAIL_USE_TLS
+  installation depuis les sources
+
diff --git a/docs/fr/source/media-src/graphique-structure-ishtar.svg b/docs/fr/source/media-src/graphique-structure-ishtar.svg
new file mode 100644
index 000000000..5eec820b7
--- /dev/null
+++ b/docs/fr/source/media-src/graphique-structure-ishtar.svg
@@ -0,0 +1,538 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generated by graphviz version 2.38.0 (20140413.2041)
+ -->
+
+<!-- Title: structure_Ishtar Pages: 1 -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="554pt"
+   height="476pt"
+   viewBox="0.00 0.00 553.54 476.00"
+   version="1.1"
+   id="svg195"
+   sodipodi:docname="graphique-structure-ishtar.svg"
+   inkscape:version="0.92.1 r15371"
+   inkscape:export-filename="/home/etienne/Work/ishtar-project/ishtar/docs/fr/source/_static/graphique-structure-ishtar.png"
+   inkscape:export-xdpi="96"
+   inkscape:export-ydpi="96">
+  <metadata
+     id="metadata201">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <defs
+     id="defs199" />
+  <sodipodi:namedview
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1"
+     objecttolerance="10"
+     gridtolerance="10"
+     guidetolerance="10"
+     inkscape:pageopacity="0"
+     inkscape:pageshadow="2"
+     inkscape:window-width="1920"
+     inkscape:window-height="1053"
+     id="namedview197"
+     showgrid="false"
+     inkscape:zoom="1.0517471"
+     inkscape:cx="183.10036"
+     inkscape:cy="362.6514"
+     inkscape:window-x="1920"
+     inkscape:window-y="27"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="svg195" />
+  <polygon
+     style="fill:#ffffff;stroke:none"
+     id="polygon4"
+     points="549.539,-472 549.539,4 -4,4 -4,-472 "
+     transform="translate(4,472)" />
+  <g
+     class="node"
+     id="node1"
+     transform="translate(4,472)">
+    <title
+       id="title6">Opération archéologique</title>
+    <polygon
+       style="fill:#ff0000;stroke:#ff0000;fill-opacity:0.58823532"
+       id="polygon8"
+       points="137.5,-432 288.5,-432 288.5,-468 137.5,-468 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text10"
+       font-size="14.00"
+       y="-446.29999"
+       x="213">Opération archéologique</text>
+  </g>
+  <g
+     class="node"
+     id="node2"
+     transform="translate(-88.702895,473.4262)">
+    <title
+       id="title13">parcelle cadastrale</title>
+    <polygon
+       style="fill:none;stroke:#000000"
+       id="polygon15"
+       points="230.5,-360 230.5,-396 113.5,-396 113.5,-360 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text17"
+       font-size="14.00"
+       y="-374.29999"
+       x="172">Parcelle cadastrale</text>
+  </g>
+  <g
+     class="edge"
+     id="edge1"
+     transform="translate(4,472)">
+    <title
+       id="title20">Opération archéologique-&gt;parcelle cadastrale</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path22"
+       d="m 202.865,-431.697 c 1.48909,31.17433 -125.044374,0.17808 -123.533283,36.3061"
+       sodipodi:nodetypes="cc" />
+  </g>
+  <g
+     class="node"
+     id="node8"
+     transform="translate(4,472)">
+    <title
+       id="title25">Site archéologique</title>
+    <polygon
+       style="fill:#add8e6;stroke:#add8e6;fill-opacity:0.58823532"
+       id="polygon27"
+       points="205,-216 323,-216 323,-252 205,-252 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text29"
+       font-size="14.00"
+       y="-230.3"
+       x="264">Site archéologique</text>
+  </g>
+  <g
+     class="edge"
+     id="edge7"
+     transform="translate(4,472)">
+    <title
+       id="title32">Opération archéologique-&gt;Site archéologique</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path34"
+       d="m 227.717,-422.959 c 4.206,8.387 8.42,17.868 11.283,26.959 14.35,45.571 20.647,101.095 23.271,133.599" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon36"
+       points="230.784,-424.648 224.582,-421.402 223.045,-431.885 " />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon38"
+       points="258.79,-262.018 265.77,-262.541 263.026,-252.308 " />
+  </g>
+  <g
+     class="node"
+     id="node3"
+     transform="translate(4,472)">
+    <title
+       id="title41">Unité d'enregistrement</title>
+    <polygon
+       style="fill:#90ee90;stroke:#90ee90;fill-opacity:0.58823532"
+       id="polygon43"
+       points="96,-288 236,-288 236,-324 96,-324 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text45"
+       font-size="14.00"
+       y="-302.29999"
+       x="166">Unité d'enregistrement</text>
+  </g>
+  <g
+     class="edge"
+     id="edge2"
+     transform="translate(4,472)">
+    <title
+       id="title48">parcelle cadastrale-&gt;Unité d'enregistrement</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path50"
+       d="m 80.666502,-357.91425 c -5.652694,20.54978 85.185548,-1.55558 87.657498,23.80225"
+       sodipodi:nodetypes="cc" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon52"
+       points="164.833,-334.367 171.807,-333.769 167.466,-324.104 " />
+  </g>
+  <g
+     class="node"
+     id="node4"
+     transform="translate(4,472)">
+    <title
+       id="title55">Mobilier d'origine</title>
+    <polygon
+       style="fill:#800080;stroke:#800080;fill-opacity:0.58823532"
+       id="polygon57"
+       points="71,-216 187,-216 187,-252 71,-252 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text59"
+       font-size="14.00"
+       y="-230.3"
+       x="129">Mobilier d'origine</text>
+  </g>
+  <g
+     class="edge"
+     id="edge3"
+     transform="translate(4,472)">
+    <title
+       id="title62">Unité d'enregistrement-&gt;Mobilier d'origine</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path64"
+       d="m 156.854,-287.697 c -4.257,8.053 -9.41,17.803 -14.12,26.715" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon66"
+       points="139.62,-262.581 145.808,-259.31 138.041,-252.104 " />
+  </g>
+  <g
+     class="edge"
+     id="edge8"
+     transform="translate(4,472)">
+    <title
+       id="title69">Unité d'enregistrement-&gt;Site archéologique</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path71"
+       d="m 189.973,-287.876 c 12.577,8.983 28.159,20.113 41.779,29.842" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon73"
+       points="229.763,-255.154 233.831,-260.85 239.934,-252.19 " />
+  </g>
+  <g
+     class="node"
+     id="node5"
+     transform="translate(4,472)">
+    <title
+       id="title76">Mobilier</title>
+    <polygon
+       style="fill:#800080;stroke:#800080;fill-opacity:0.58823532"
+       id="polygon78"
+       points="96.5,-144 161.5,-144 161.5,-180 96.5,-180 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text80"
+       font-size="14.00"
+       y="-158.3"
+       x="129">Mobilier</text>
+  </g>
+  <g
+     class="edge"
+     id="edge4"
+     transform="translate(4,472)">
+    <title
+       id="title83">Mobilier d'origine-&gt;Mobilier</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path85"
+       d="m 129,-215.697 c 0,7.714 0,16.985 0,25.585" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon87"
+       points="125.5,-190.104 132.5,-190.104 129,-180.104 " />
+  </g>
+  <g
+     class="node"
+     id="node6"
+     transform="translate(4,472)">
+    <title
+       id="title90">Contenant</title>
+    <polygon
+       style="fill:#ffff00;stroke:#ffb400;fill-opacity:0.58823532;stroke-opacity:1"
+       id="polygon92"
+       points="0,-72 72,-72 72,-108 0,-108 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text94"
+       font-size="14.00"
+       y="-86.300003"
+       x="36">Contenant</text>
+  </g>
+  <g
+     class="edge"
+     id="edge5"
+     transform="translate(4,472)">
+    <title
+       id="title97">Mobilier-&gt;Contenant</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path99"
+       d="m 106.011,-143.697 c -11.8249,8.901 -26.403,19.874 -39.1896,29.498" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon101"
+       points="64.6092,-116.915 68.8188,-111.322 58.7243,-108.104 " />
+  </g>
+  <g
+     class="node"
+     id="node9"
+     transform="translate(4,472)">
+    <title
+       id="title104">Traitement</title>
+    <polygon
+       style="fill:#800080;stroke:#800080;fill-opacity:0.58823532"
+       id="polygon106"
+       points="90.5,-72 167.5,-72 167.5,-108 90.5,-108 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text108"
+       font-size="14.00"
+       y="-86.300003"
+       x="129">Traitement</text>
+  </g>
+  <g
+     class="edge"
+     id="edge9"
+     transform="translate(4,472)">
+    <title
+       id="title111">Mobilier-&gt;Traitement</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path113"
+       d="m 123.084,-143.697 c -0.795,7.714 -1.022,16.985 -0.679,25.585" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon115"
+       points="118.915,-117.836 125.898,-118.324 123.105,-108.104 " />
+  </g>
+  <g
+     class="node"
+     id="node7"
+     transform="translate(4,472)">
+    <title
+       id="title118">Dépôt</title>
+    <polygon
+       style="fill:#ffff00;stroke:#ffb400;fill-opacity:0.58823532;stroke-opacity:1"
+       id="polygon120"
+       points="9,0 63,0 63,-36 9,-36 " />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text122"
+       font-size="14.00"
+       y="-14.3"
+       x="36">Dépôt</text>
+  </g>
+  <g
+     class="edge"
+     id="edge6"
+     transform="translate(4,472)">
+    <title
+       id="title125">Contenant-&gt;Dépôt</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path127"
+       d="m 36,-71.6966 c 0,7.7139 0,16.9841 0,25.5842" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon129"
+       points="32.5001,-46.1044 39.5001,-46.1043 36,-36.1043 " />
+  </g>
+  <g
+     class="edge"
+     id="edge10"
+     transform="translate(4,472)">
+    <title
+       id="title132">Traitement-&gt;Mobilier</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path134"
+       d="m 134.895,-108.104 c 0.806,-7.687 1.042,-16.95 0.709,-25.561" />
+    <polygon
+       style="fill:#000000;stroke:#000000"
+       id="polygon136"
+       points="139.092,-133.96 132.109,-133.48 134.916,-143.697 " />
+  </g>
+  <g
+     class="node"
+     id="node10"
+     transform="translate(4,472)">
+    <title
+       id="title139">Module Opération</title>
+    <ellipse
+       style="fill:#ff0000;stroke:#ff0000;fill-opacity:0.58823532"
+       id="ellipse141"
+       ry="18"
+       rx="76.086502"
+       cy="-450"
+       cx="424" />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text143"
+       font-size="14.00"
+       y="-446.29999"
+       x="424">Module Opération</text>
+  </g>
+  <g
+     class="node"
+     id="node11"
+     transform="translate(4,472)">
+    <title
+       id="title146">Module Unité d'enregistrement</title>
+    <ellipse
+       style="fill:#90ee90;stroke:#90ee90;fill-opacity:0.58823532"
+       id="ellipse148"
+       ry="18"
+       rx="121.578"
+       cy="-378"
+       cx="424" />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text150"
+       font-size="14.00"
+       y="-374.29999"
+       x="424">Module Unité d'enregistrement</text>
+  </g>
+  <g
+     class="edge"
+     id="edge11"
+     transform="translate(4,472)">
+    <title
+       id="title153">Module Opération-&gt;Module Unité d'enregistrement</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path155"
+       d="m 424,-431.697 c 0,10.851 0,24.78 0,35.593" />
+  </g>
+  <g
+     class="node"
+     id="node12"
+     transform="translate(4,472)">
+    <title
+       id="title158">Module Mobilier</title>
+    <ellipse
+       style="fill:#800080;stroke:#800080;fill-opacity:0.58823532"
+       id="ellipse160"
+       ry="18"
+       rx="72.287498"
+       cy="-306"
+       cx="424" />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text162"
+       font-size="14.00"
+       y="-302.29999"
+       x="424">Module Mobilier</text>
+  </g>
+  <g
+     class="edge"
+     id="edge12"
+     transform="translate(4,472)">
+    <title
+       id="title165">Module Unité d'enregistrement-&gt;Module Mobilier</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path167"
+       d="m 424,-359.697 c 0,10.851 0,24.78 0,35.593" />
+  </g>
+  <g
+     class="node"
+     id="node13"
+     transform="translate(4,472)">
+    <title
+       id="title170">Module Dépôt</title>
+    <ellipse
+       style="fill:#ffff00;stroke:#ffb400;fill-opacity:0.58823532;stroke-opacity:1"
+       id="ellipse172"
+       ry="18"
+       rx="62.289101"
+       cy="-234"
+       cx="424" />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text174"
+       font-size="14.00"
+       y="-230.3"
+       x="424">Module Dépôt</text>
+  </g>
+  <g
+     class="edge"
+     id="edge13"
+     transform="translate(4,472)">
+    <title
+       id="title177">Module Mobilier-&gt;Module Dépôt</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path179"
+       d="m 424,-287.697 c 0,10.851 0,24.78 0,35.593" />
+  </g>
+  <g
+     class="node"
+     id="node14"
+     transform="translate(4,472)">
+    <title
+       id="title182">Module Site</title>
+    <ellipse
+       style="fill:#add8e6;stroke:#add8e6;fill-opacity:0.58823532"
+       id="ellipse184"
+       ry="18"
+       rx="54.690498"
+       cy="-162"
+       cx="424" />
+    <text
+       style="font-size:14px;font-family:Times, serif;text-anchor:middle"
+       id="text186"
+       font-size="14.00"
+       y="-158.3"
+       x="424">Module Site</text>
+  </g>
+  <g
+     class="edge"
+     id="edge14"
+     transform="translate(4,472)">
+    <title
+       id="title189">Module Dépôt-&gt;Module Site</title>
+    <path
+       style="fill:none;stroke:#000000"
+       inkscape:connector-curvature="0"
+       id="path191"
+       d="m 424,-215.697 c 0,10.851 0,24.78 0,35.593" />
+  </g>
+  <path
+     sodipodi:nodetypes="cc"
+     d="m 216.7727,40.40098 c 12.577,8.983 1.05264,71.42274 -25.1621,98.92611"
+     id="path71-7"
+     inkscape:connector-curvature="0"
+     style="fill:none;stroke:#000000" />
+  <polygon
+     points="229.763,-255.154 233.831,-260.85 239.934,-252.19 "
+     id="polygon73-5"
+     style="fill:#000000;stroke:#000000"
+     transform="rotate(79.484699,-26.994847,-83.299322)" />
+</svg>
diff --git a/docs/fr/source/media-src/graphique_structure_ishtar.dot b/docs/fr/source/media-src/graphique_structure_ishtar.dot
new file mode 100644
index 000000000..f052fe4a7
--- /dev/null
+++ b/docs/fr/source/media-src/graphique_structure_ishtar.dot
@@ -0,0 +1,5 @@
+digraph structure_Ishtar {
+    "Opération archéologique" -> Parcelle -> "Unité d'enregistrement" -> Mobilier;
+    "Opération archéologique" -> "Site archéologique";
+    "Unité d'enregistrement" -> "Site archéologique";
+}
diff --git a/docs/fr/source/principes.rst b/docs/fr/source/principes.rst
new file mode 100644
index 000000000..e3caaa1c9
--- /dev/null
+++ b/docs/fr/source/principes.rst
@@ -0,0 +1,107 @@
+.. -*- coding: utf-8 -*-
+
+=========
+Principes
+=========
+
+:Auteur: Valérie-Emma Leroux - Yann Le Jeune - Étienne Loks
+:Date: 2018-10-02
+:Copyright: CC-BY 3.0
+
+Ce document présente les grands principes qui structurent Ishtar.
+
+.. contents::
+
+Présentation
+============
+
+Présentation générale
+---------------------
+
+Ishtar est un projet de gestion de base de données visant à gérer les données et la documentation (mobilier inclus) provenant d'opérations archéologique, publié sous la forme d'un logiciel libre sous licence AGPL 3.0 (ou supérieure).
+
+L'objectif est d'assurer une traçabilité maximale des informations afin de faire vivre cette documentation et la rendre même éventuellement accessible au public ou encore à un (ou des) groupe(s) d'utilisateurs.
+
+Ce logiciel a vocation à être installé sur un serveur web mais peut également fonctionner en local, à l'échelle d'un chantier, d'une commune ou d'une région entière.
+
+Conçu afin de permettre une communication inter-bases, le projet Ishtar vise plutôt un modèle d'information distribué que centralisé : la communication entre les bases est favorisée.
+
+Il est organisé autour d'un tronc commun associé à des modules liés à des besoins « métiers » spécifiques : administration des opérations et inventaires, lieux de conservation, traitements liés aux laboratoires de restauration, analyse stratigraphique avancée, étiquetage QR-code, etc.
+
+De multiples niveaux d'utilisateurs sont possibles, d'un accès pour le public (ou non) à des accès pour chercheurs, responsables d'opérations, gestionnaires de CCE, connexion avec un SIG, etc.
+
+Voici quelques exemples des usages possibles (liste non exhaustive) pour la gestion des données :
+
+- d'une opération programmée ou préventive (une instance pour une opération ou une série d'opérations) gérée à l'échelle de l'équipe de recherche associée : gestion des données, mise en commun, production automatique d'inventaires conformes, export et import d'inventaires avec des spécialistes, gestion des relations stratigraphiques, etc. ;
+- d'une association de bénévoles : enregistrement des résultats de chacun dans une base commune ;
+- à l'échelle d'un service régional de l'archéologie : gestion des inventaires mobilier, opérations, dossiers d'urbanisme, rapports, dépôts, production d'arrêtés et de courriers, base de connaissances régionale, etc. ;
+- pour un service de collectivité territoriale : suivi des opérations, gestion de l'ensemble des données et mise à disposition du public et chercheurs ;
+- pour un laboratoire de restauration : gestion fine des traitements et traçabilité maximale du mobilier (tout l'historique des traitements est conservé) ;
+- pour un PCR : plate-forme de synthèse des données collectées et valorisation du travail effectué par l'ouverture au public de la base une fois le PCR achevé ;
+- pour des étudiants : base de données gratuite, utilisant des normes standardisées, possibilité de mettre en commun son travail avec d'autres, de le faire suivre par des tuteurs ou encadrants ;
+- etc.
+
+Fonctionnalités
+---------------
+
+La version actuelle permet d'accomplir les tâches suivantes :
+
+- saisie des opérations,
+- saisie des unités d'enregistrement (UE),
+- saisie du mobilier archéologique,
+- association à de la documentation,
+- production automatique d'inventaires conformes (UE, mobilier, documents),
+- gestionnaire de médias (stockage et gestion des photos, pdf des rapports, etc.),
+- personnalisation des formulaires (ajouts de champs personnalisés, choix de l'affichage des champs Ishtar),
+- imports paramétrables et archivables, incluant éventuellement les liens vers des images, depuis des fichiers tabulaires (format csv, fichier zip pour les images),
+- recherche avancée (recherche plein texte et par critère, enregistrement de recherche, gestion d'alertes),
+- exports (csv) suite à une recherche ou par élément sélectionné (opération, UE, mobilier),
+- production de documents formatés (patrons au format odt),
+- production de fiches types pour les opérations, UE ou mobilier (format odt et pdf),
+- tableau de bord produisant automatiquement des statistiques et des graphiques,
+- connexion (jointure) avec un SIG (testé avec QGIS),
+
+Module administratif
+********************
+
+- saisie des dossiers,
+- ajout d'actes administratifs (courriers, arrêtés, etc.),
+- production automatique de courriers administratifs (accusés de réception, etc.),
+
+Module lieux de conservation
+****************************
+
+- gestion des mouvements de mobilier,
+- production automatique de documents tels conventions de prêts, fiches d'état, etc.
+- conditionnement,
+- sélection par « panier »,
+- gestion des contenants et étiquetage : il n'est pas prévu qu'Ishtar génère directement des étiquettes (pdf) mais plutôt des fichiers csv pouvant être utilisés selon tout format d'étiquette via « publi-postage » dans un logiciel tiers (libre-office, excel, etc.).
+
+Modules / configuration
+=======================
+
+Selon le périmètre fonctionnel dans lequel Ishtar est utilisé, il convient d'activer ou désactiver certains modules. Ces modules permettent d'accéder à plus ou moins de fonctionnalités d'Ishtar, de faire apparaîtres des champs sur les formulaires, de présenter différement les données, etc. 
+
+.. note:: L'activation / désactivation d'un module ne change jamais la structure des données. Il est tout à fait possible d'activer ponctuellement un module sans que cela n'altère les données en base.
+
+Des dépendances entre modules existent. Ces dépendances sont logiques et se comprennent aisément si l'on a intégré la structure de la base de données d'Ishtar (cf. :ref:`structure-de-la-base-de-données`). En cas de doute, si une dépendance est manquante lors de l'activation du modul un message explicite est donné.
+
+L'activation des modules est faite en administration sur la page de configuration d'instance Ishtar (cf. :ref:`documentation administrateur <configuration-instance-ishtar>`).
+
+Par ailleurs au niveau de la configuration d'instance Ishtar un certain de nombre de paramètres de fonctionnement Ishtar peuvent être ajustés. Ceux-ci sont détaillés dans la :ref:`documentation administrateur <configuration-instance-ishtar>`.
+
+.. warning:: Contrairement à l'activation des modules, certains paramètres ont une incidence importante sur les données stockées dans Ishtar, notamment en ce qui concerne la gestion des identifiants mobiliers, des identifiants documents, etc. En tant qu'administrateur, si vous souhaitez une configuration différente de la configuration par défaut d'Ishtar, il est nécessaire de modifier ces paramètres en amont.
+
+.. _structure-de-la-base-de-données:
+
+Structure de la base de données
+===============================
+
+La base de données ne va pas être détaillée table par table mais nous allons vous présenter les grandes notions utilisées.
+
+.. image:: _static/graphique-structure-ishtar.png
+
+
+..
+  TODO:
+  Parler d'historisation