add table modules

docs/faq.rst

@@ -1,13 +1,13 @@
-==========================
-Frequently asked questions
-==========================
+=============================
+10 Frequently asked questions
+=============================
 
 .. contents::
    :local:
    :depth: 2
 
-How are 3D informations obtained ?
-----------------------------------
+10.1 How are 3D informations obtained ?
+---------------------------------------
 
 All paths geometries are *"draped"* on a Digital Elevation Model, when created
 or updated.
@@ -16,8 +16,8 @@ All linear objects that defined using topologies (*treks, ...*) take their 3D in
 from their related paths, instead of reading the DEM.
 
 
-How is the ascent computed on treks ?
--------------------------------------
+10.2 How is the ascent computed on treks ?
+-------------------------------------------
 
 We compute the `cumulative elevation gain <http://en.wikipedia.org/wiki/Cumulative_elevation_gain>`_.
 
@@ -31,10 +31,8 @@ For more details :
 * `Draping lines with PostGIS <http://blog.mathieu-leplatre.info/drape-lines-on-a-dem-with-postgis.html>`_
   (or `french version <http://makina-corpus.com/blog/metier/2013/draper-des-lignes-sur-un-mnt-avec-postgis>`_)
 
-
-
-How are POIs related to treks ?
--------------------------------
+10.3 How are POIs related to treks ?
+------------------------------------
 
 POIs are considered as an *editorial* information, and are created carefully
 along treks.
@@ -57,8 +55,8 @@ POIs are thus related to treks using a basic spatial intersection, with a
 distance set in setting ``TREK_POI_INTERSECTION_MARGIN`` (default to 500 meters).
 
 
-Can I have overlapping districts ?
-----------------------------------
+10.4 Can I have overlapping districts ?
+---------------------------------------
 
 Districts are a generic notion to qualify your territory. They can be valleys,
 mounts, ...
@@ -68,8 +66,8 @@ resulting in overlapping geometries. Geotrek-admin will associate them all to yo
 objects.
 
 
-Why does Makina Corpus sell Geotrek, released under an Open-Source license ?
-----------------------------------------------------------------------------
+10.5 Why does Makina Corpus sell Geotrek, released under an Open-Source license ?
+---------------------------------------------------------------------------------
 
 In the early years of the Free Software movement, it was quite common to pay
 in order to receive a physical copy (on floppy disks) of some GNU programs and source
@@ -106,9 +104,8 @@ which represents a substantial cost for a company like ours.
 To conclude, we don't really sell *Geotrek*, since you can get it on Github and install it easily, but
 we ask for a financial contribution regarding the above responsabilities. It is not only legal, but also recommended by the funders of the Free and Open Source Software movement.
 
-
-How can I help and contribute ?
--------------------------------
+10.6 How can I help and contribute ?
+-------------------------------------
 
 There are many ways to contribute to a Free Software. And modifying
 the source code is probably the least common action. For example :

docs/index.rst

@@ -16,14 +16,12 @@ Welcome to Geotrek's documentation!
     usage/overview.rst
     usage/management-modules.rst
     usage/touristic-modules.rst 
-    usage/screencasts.rst
     usage/editing-objects.rst
-    usage/treks.rst
-    usage/outdoor.rst
-    usage/static-pages.rst
     usage/configuration-ttw.rst
+    usage/outdoor.rst
     usage/externals-apis.rst
-    usage/qgis.rst
+    usage/static-pages.rst
+    usage/screencasts.rst
     faq.rst
 
 .. toctree::

docs/usage/configuration-ttw.rst

@@ -1,14 +1,14 @@
-=============
-Paramétrage
-=============
+==============
+5. Paramétrage
+==============
 
 .. contents::
    :local:
    :depth: 2
 
 
-Accès interface admin
-=====================
+5.1 Accès interface admin
+=========================
 
 Menu à droite > admin
 
@@ -20,11 +20,11 @@ Menu à droite > admin
 
 .. _parametrages-des-modules:
 
-Paramétrages des modules
-========================
+5.2 Paramétrages des modules
+============================
 
-Itinéraires
------------
+5.2.1 Itinéraires
+-----------------
 
 -  Pratiques
 -  Accessibilités
@@ -39,8 +39,8 @@ Itinéraires
 
    Ensemble des champs paramétrables du module Itinéraires
 
-Exemple : ajouter une pratique
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+5.2.1.1 Exemple : ajouter une pratique
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 -  Dans admin, à la ligne “Pratiques” cliquer sur “+ ajouter”
 -  Remplir les champs (en gras les champs obligatoires)
@@ -53,8 +53,8 @@ Exemple : ajouter une pratique
 
    Ajout d'une nouvelle pratique
 
-Exemple : ajouter une étiquette
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+5.2.1.2 Exemple : ajouter une étiquette
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Les étiquettes sont des encarts "pré-configurés" pouvant être réutilisés sur de multiples itinéraires. Elles présentent plusieurs avantages : 
 - ne pas avoir à saisir à chaque itinéraire les même informations
@@ -110,8 +110,8 @@ Rendu dans **Geotrek Rando** (partie :guilabel:`Filtres`) :
 
 .. _sites-et-parcours-outdoor-1:
 
-Sites et parcours outdoor
--------------------------
+5.2.2 Sites et parcours outdoor
+-------------------------------
 
 -  Cotations
 -  Filières
@@ -121,16 +121,16 @@ Sites et parcours outdoor
 -  Échelles de cotation
 
 
-Plongées
---------
+5.2.3 Plongées
+--------------
 
 -  Niveau de difficulté
 -  Niveau technique
 -  Pratique
 
 
-Tourisme
---------
+5.2.4 Tourisme
+--------------
 
 -  Autres sports : catégorie activités → Types de contenus touristiques
 -  Lieux de renseignements
@@ -144,8 +144,8 @@ Tourisme
 
    Ensemble des champs paramétrables des modules Contenus et Évènements touristiques
 
-Exemple : catégorie de contenu touristique et ses sous-types
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+5.2.4.1 Exemple : catégorie de contenu touristique et ses sous-types
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
 .. figure:: ../images/admin/django-admin-categorie-contenu-touristique.png
@@ -173,8 +173,8 @@ Dans l’édition d’un contenu touristique de catégorie “Hébergement”
 
    Ajout d'un type d'usage à la catégorie “Hébergements”
 
-Zones
------
+5.2.5 Zones
+-----------
 
 -  Communes
 -  Secteurs
@@ -183,8 +183,8 @@ Zones
 
 .. _user-management-section:
 
-Gestion des utilisateurs
-========================
+5.3 Gestion des utilisateurs
+============================
 
 Geotrek-admin s'appuie sur le `système d'authentification et de permissions Django <https://docs.djangoproject.com/en/4.2/topics/auth/default>`_ .
 
@@ -200,8 +200,8 @@ Toute la configuration des utilisateurs, groupes et permissions est disponible d
 
    Interface de configuration des utilisateurs/groupes
 
-Utilisateurs et permissions
----------------------------
+5.3.1 Utilisateurs et permissions
+---------------------------------
 
 L’application permet d’attribuer des droits à autant de groupes que souhaité.
 Nous recommandons cependant de privilégier la diffusion la plus large par défaut et de ne restreindre l’application que pour des raisons impératives.
@@ -258,8 +258,8 @@ Voici la signification des actions autorisées dans les permissions :
 * *publish* : publier la donnée
 * *export* : exporter les données via l’interface de Geotrek-admin (CSV, JSON…)
 
-Groupes
--------
+5.3.2 Groupes
+-------------
 
 Les groupes facilitent la gestion des utilisateurs et des permissions.Chaque groupe est configuré avec un certain nombre de permissions.
 
@@ -283,8 +283,8 @@ De même qu’il est possible d’ajouter, modifier ou supprimer des itinéraire
 
 Les éditeurs et les administrateurs peuvent travailler en simultané sur des fiches balades, mais pas en même temps sur la même fiche, car il y aurait sinon un risque de perte d’informations lors de la validation / enregistrement des informations saisies.
 
-Structures
-----------
+5.3.3 Structures
+----------------
 
 Chaque utilisateur est obligatoirement rattaché à une structure. Lors de l’installation, Geotrek crée une structure par défaut à laquellles premiers utilisateurs seront rattachés.Il est possible d’ajouter de nouvelles structures, reflétant des partenaires territoriaux, entreprises, entités qui seront amenés à travailler à vos côtés sur Geotrek.
 
@@ -307,8 +307,8 @@ Cette notion de structures permet de segmenter les périmètres d’action des u
     - celui-ci possède la permission « Can by structure », qui permet d’outrepasser la restriction des structures.
 
 
-Multilingue
-============
+5.4 Gestion multilingue
+=======================
 
 La configuration des langues de la plate-forme est réalisée au travers du fichier de configuration principal. 
 Lors de sa mise à jour, la commande de déploiement créé les champs nécessaires qui manquent dans la base de données (exemple : nom_fr, nom_es, nom_it…).
@@ -322,8 +322,8 @@ Il est par exemple possible d'intégrer des textes dans différentes langues (à
 
    Gestion multilingue dans la fiche détail
 
-Configuration des portails
-==========================
+5.5 Configuration des portails
+==============================
 
 Geotrek permet de configurer un ou plusieurs portails. Ce terme est utilisé pour référencer un site grand public sur lequel seront visibles les objets publiés de Geotrek.
 
@@ -341,8 +341,8 @@ Pour configurer un ou pluseurs portails, il faut se rendre dans l'interface d'ad
 
 Il est possible de choisir de publier sur un ou plusieurs portails les objets suivants : itinéraires, contenus et évènements touristiques, pages statiques. Pour cela il suffit de sélectionner la valeur souhaitée dans le champ "portail" à l'édition de l'objet.
 
-Intégration des données SIT
-===========================
+5.6 Intégration des données SIT
+================================
 
 Des développements ont déjà été réalisés dans Geotrek pour intégrer des données de divers SIT (Système d’Informations Touristiques), notamment APIDAE, Tourinsoft, LEI, SITLOR... si les flux sont disponibles dans des formats ouverts.
 
@@ -353,8 +353,8 @@ L’obtention d’un flux de données GeoJSON (agnostique et standard) présente
 
 Pour configurer l'import de SIT, référez vous à cette section :ref:`Import data from touristic data systems (SIT) <import-data-from-touristic-data-systems-sit>`
 
-Intégration des fonds de cartes
-===============================
+5.7 Intégration des fonds de cartes
+====================================
 
 Il est possible d'intégrer dans Geotrek différents fonds de carte comme :
 
@@ -364,8 +364,8 @@ Il est possible d'intégrer dans Geotrek différents fonds de carte comme :
 
 Pour configurer l'ajout de fonds de plan, référez vous à cette section :ref:`Map settings <map-settings>`
 
-Pictogrammes
-============
+5.8 Intégration de pictogrammes
+================================
 
 Les pictogrammes contribués dans Geotrek doivent être au format :
 

docs/usage/editing-objects.rst

@@ -1,17 +1,19 @@
-==================
-Edition d'un objet
-==================
+=====================
+4. Edition d'un objet
+=====================
 
 .. contents::
    :local:
    :depth: 2
 
-Segmentation dynamique
-======================
+4.1 Segmentation dynamique
+==========================
 
 Certains objets sont saisis et stockés relativement aux tronçons, en utilisant `la segmentation dynamique <https://makina-corpus.com/sig-webmapping/la-segmentation-dynamique>`_. Il s'agit des objets suivants : sentiers, statuts, aménagements, interventions, itinéraires et POI. Tous les autres objets sont indépendants et ont leur propre géométrie.
 
-La **segmentation dynamique** permet de saisir et stocker des informations relatives aux tronçons. Elle s'accompagne d'un ensemble de déclencheurs calculant automatiquement les géométries résultantes à la création et lors de modifications sur le réseau de tronçons. Cela permet de garantir une cohérence géométrique et topologique entre les tronçons et les objets liés (travaux, aménagements, statuts, itinéraires...), mais aussi d'associer tous les objets entre eux en vérifiant leur superposition sur le réseau.
+La **segmentation dynamique** permet de saisir et stocker des informations relatives aux tronçons. Elle s'accompagne d'un ensemble de déclencheurs calculant automatiquement les géométries résultantes à la création et lors de modifications sur le réseau de tronçons. 
+
+Cela permet de garantir une **cohérence géométrique et topologique entre les tronçons et les objets liés** (travaux, aménagements, statuts, itinéraires...), mais aussi d'associer tous les objets entre eux en vérifiant leur superposition sur le réseau.
 
 C'est pourquoi, modifier un tronçon peut entrainer des modifications des objets qui lui sont rattachés (interventions, itinéraires, POIs...). Supprimer un tronçon, supprime les objets qui lui sont rattachés par segmentation dynamique.
 
@@ -21,20 +23,28 @@ Un objet peut ainsi être associé à un ou plusieurs tronçons, partiellement o
 
 Les objets ponctuels ne sont associés qu'à un seul tronçon, sauf dans le cas où ils sont positionnés à une intersection de tronçons.
 
-Chaque évènement dispose néanmoins d'une géométrie calculée à partir de leur segmentation dynamique pour faciliter leur affichage dans Geotrek ou dans QGIS. Il ne faut néanmoins pas modifier directement ces géométries, elles sont calculées automatiquement quand on modifie l'évènement d'un objet.
+Chaque évènement dispose néanmoins d'une géométrie calculée à partir de leur segmentation dynamique pour faciliter leur affichage dans Geotrek ou dans QGIS (voir la section :ref:`Visualiser les données dans Qgis <visualiser-les-donnees-dans-qgis>`). Il ne faut néanmoins pas modifier directement ces géométries, elles sont calculées automatiquement quand on modifie l'évènement d'un objet.
 
 .. notes
 
     Des vues SQL sont disponibles pour accéder aux objets de manière plus lisible et simplifiée (``v_interventions`` par exemple).
 
-Snapping - Aimantage - Accrochage
-=================================
+4.2 Snapping - Aimantage - Accrochage
+======================================
 
 Quand vous créez un objet, il est possible de le snapper (aimanter) aux objets existants. C'est notamment utile pour bien raccorder les tronçons entre eux. Quand vous raccrochez un tronçon à un tronçon existant, ce dernier est coupé automatiquement à la nouvelle intersection.
 
 Les fonctions d'aimantage ne sont pas disponibles lors de la création d'un nouvel objet (linéraire ou ponctuel). Il faut commencer par le créer puis le modifier pour disposer des fonctionnalités d'aimantage, activées automatiquement lorsque l'on se rapproche d'un objet existant. Par défaut la distance d'imantage est de 30 pixels mais elle est modifiable en configuration avancée.
 
-Informations altimétriques
-==========================
+4.3 Informations altimétriques
+==============================
 
 L'édition des objets s'effectue en 2D, et leur géométrie est “drapée” automatiquement en 3D sur un Modèle Numérique de Terrain stocké en base au format raster.
+
+Cette information est visible à travers le profil altimétrique pour les tronçons et les itinéraires.
+
+.. figure:: ../images/user-manual/altimetrie.png
+   :alt: Profil altimétrique d'un itinéraire
+   :align: center
+
+   Profil altimétrique d'un itinéraire