Docs: autogen value documentation

1 files changed, 79 insertions, 0 deletions

diff --git a/docs/fr/source/_templates/annexe-tech-3-variables-gen.jinja b/docs/fr/source/_templates/annexe-tech-3-variables-gen.jinja
new file mode 100644
index 000000000..e9576352e
--- /dev/null
+++ b/docs/fr/source/_templates/annexe-tech-3-variables-gen.jinja
@@ -0,0 +1,79 @@
+.. -*- coding: utf-8 -*-
+
+.. _annexe-technique-3-variables:
+
+==============================
+Annexe technique 3 - Variables
+==============================
+
+:Auteur: Étienne Loks
+:Date: 2020-11-24
+:Copyright: CC-BY 3.0
+
+----------------------------------
+
+Ces variables sont utilisées pour les configurations des imports, les patrons de documents et la configuration des identifiants, des index personnalisés.
+
+Ces variables correspondent aux noms des champs utilisés en base de données (exemple : ``code_patriarche`` pour accéder au code patriarche d'une opération) ainsi que des « facilitateurs » qui permettent de disposer de champs plus évolués (exemple : ``get_next_index`` pour accéder au prochain numéro d'index).
+
+On peut passer d'un élément lié à un autre (par exemple, accéder à l'opération d'une unité d'enregistrement) avec la notation double tiret `__` et ensuite accéder aux variables de l'élément lié (exemple : ``operation__code_patriarche`` permet d'accéder au code patriarche de l'opération ).
+
+Ci-dessous la liste des variables pour chaque type d'éléments.
+
+.. _valeurs-champs-adresse:
+
+Champs adresse
+==============
+
+Les champs adresse sont une liste de variables partagées par plusieurs éléments :
+{{ ishtar_common['address']['render'] }}
+
+.. _valeurs-champs-geo:
+
+Champs géographiques
+====================
+
+Les champs géographiques sont une liste de variables partagées par plusieurs éléments :
+{{ ishtar_common['geoitem']['render'] }}
+
+Le détail du fonctionnement de ces champs est explicité dans :ref:`« Principes > Notions avancées > Données géographiques » <donnees-geographiques>`.
+
+
+Personne
+========
+
+Chaque personne dispose des :ref:`champs adresse <valeurs-champs-adresse>`, ainsi que des champs suivants :
+{{ ishtar_common['person']['render'] }}
+
+
+Auteur
+======
+{{ ishtar_common['author']['render'] }}
+
+Organisation
+============
+
+Chaque organisation dispose des :ref:`champs adresse <valeurs-champs-adresse>`, ainsi que des champs suivants :
+{{ ishtar_common['organization']['render'] }}
+
+
+Documentation
+=============
+
+{{ ishtar_common['document']['render'] }}
+
+Opération
+=========
+
+Chaque opération dispose des :ref:`champs géographiques <valeurs-champs-geo>`, ainsi que des champs suivants :
+
+
+Site/Entité archéologique
+=========================
+
+Chaque opération dispose des :ref:`champs géographiques <valeurs-champs-geo>`, ainsi que des champs suivants :
+
+
+Dossier archéologique
+=====================
+