From 36d455eabfbf9f0485416bb9880f44726b644477 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Mon, 14 Nov 2022 12:54:38 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20ajout=20des=20r=C3=A9f=C3=A9rences=20de?=
 =?UTF-8?q?s=20figures=20pour=20les=20lois=20d'ouvrage?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fix #575
---
 docs/en/calculators/par/theorie_fatou.md          | 8 ++++----
 docs/en/calculators/structures/kivi.md            | 9 +++++++--
 docs/en/calculators/structures/villemonte_1947.md | 9 ++++++---
 docs/fr/calculators/structures/kivi.md            | 6 +++++-
 docs/fr/calculators/structures/villemonte_1947.md | 9 ++++++---
 5 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/docs/en/calculators/par/theorie_fatou.md b/docs/en/calculators/par/theorie_fatou.md
index 162db8256..443338b02 100644
--- a/docs/en/calculators/par/theorie_fatou.md
+++ b/docs/en/calculators/par/theorie_fatou.md
@@ -4,7 +4,7 @@
 
 ![Characteristics of a Fatou baffle fishway](theorie_fatou_schema.png)
 
-*Excerpt fromLarinier, 2002[^1]*
+*Excerpt from Larinier, 2002[^1]*
 
 ## Hydraulic laws given by abacuses
 
@@ -16,15 +16,15 @@ $$ Q^* = \dfrac{Q}{\sqrt{g}L^{2,5}} $$
 
 ![Abacuses of a Fatou baffle fishway for a slope of 10%](baffle_fishway_Fatou_slope_10_.svg)
 
-*Abacuses of a Fatou baffle fishway for a slope of 10% (Excerpt fromLarinier, 2002[^1])*
+*Abacuses of a Fatou baffle fishway for a slope of 10% (Excerpt from Larinier, 2002[^1])*
 
 ![Abacuses of a Fatou baffle fishway for a slope of 15%](baffle_fishway_Fatou_slope_15_.svg)
 
-*Abacuses of a Fatou baffle fishway for a slope of 15% (Excerpt fromLarinier, 2002[^1])*
+*Abacuses of a Fatou baffle fishway for a slope of 15% (Excerpt from Larinier, 2002[^1])*
 
 ![Abacuses of a Fatou baffle fishway for a slope of 20%](baffle_fishway_Fatou_slope_20_.svg)
 
-*Abacuses of a Fatou baffle fishway for a slope of 20% (Excerpt fromLarinier, 2002[^1])*
+*Abacuses of a Fatou baffle fishway for a slope of 20% (Excerpt from Larinier, 2002[^1])*
 
 To run calculations for all slopes between 8% and 22%, polynomes coefficients of abacuses above are themelves adjusted in the form of slope \(S\) depending polynomes.
 
diff --git a/docs/en/calculators/structures/kivi.md b/docs/en/calculators/structures/kivi.md
index 80e05c0c2..5e18dea59 100644
--- a/docs/en/calculators/structures/kivi.md
+++ b/docs/en/calculators/structures/kivi.md
@@ -6,7 +6,10 @@ The calculation module allows hydraulic calculations to be carried out for sever
 
 ![Kindsvater-Carter formula: weir diagram](kivi_schema_seuil.png)
 
-Figure 12: perspective view of a rectangular weir with lateral contraction.
+*Perspective view of a rectangular weir with lateral contraction from CETMEF (2005)[^CETMEF2005]*
+
+[^CETMEF2005]: CETMEF. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Compiègne: Centre d’Études Techniques Maritimes Et Fluviales, 2005. <http://www.side.developpement-durable.gouv.fr/EXPLOITATION/DEFAULT/doc/IFD/IFD_REFDOC_0513410/notice-sur-les-deversoirs-synthese-des-lois-d-ecoulement-au-droit-des-seuils-et-deversoirs>
+
 
 Kindsvater-Carter formula corresponds to the classic weir formula:
 
@@ -19,7 +22,7 @@ With:
 - \(h_1\) the water level above the weir crest
 - \(p\) the sill or weir crest height
 
-The coefficients \(\alpha\) and \(\beta\) depend on the ratio between the width of the weir (\(L\)) and the width of the basin (\(B\)). Their values are given in the abacuses below (Excerpt from Larinier, M., Porcher, J.-P., 1986. Programmes de calcul sur HP86 : hydraulique et passes à poissons):
+The coefficients \(\alpha\) and \(\beta\) depend on the ratio between the width of the weir (\(L\)) and the width of the basin (\(B\)). Their values are given in the abacuses below (Excerpt from *Larinier, M., Porcher, J.-P., 1986. Programmes de calcul sur HP86 : hydraulique et passes à poissons*):
 
 ![Kindsvater-Carter formula: abacuses](kivi_abaques_alpha_beta.png)
 
@@ -27,6 +30,8 @@ The coefficients \(\alpha\) and \(\beta\) depend on the ratio between the width
 
 ![Villemonte formula: submerged weir diagram](kivi_villemonte_schema_seuil_noye.png)
 
+*Excerpt from CETMEF (2005)[^CETMEF2005]*
+
 For a downstream water elevation higher than the elevation of the weir crest, the flow is submerged and a flooding coefficient is applied to the flow coefficient.
 
 Villemonte proposes the following formula:
diff --git a/docs/en/calculators/structures/villemonte_1947.md b/docs/en/calculators/structures/villemonte_1947.md
index 56cd9eb72..31859a4d8 100644
--- a/docs/en/calculators/structures/villemonte_1947.md
+++ b/docs/en/calculators/structures/villemonte_1947.md
@@ -1,9 +1,13 @@
 # Villemonte 1947
 
-The "Villemonte (1947)" equation uses the equation of the [Free weir](seuil_denoye.md) to which the flooding coefficient proposed by Villemonte applies (see explanations below). This flooding coefficient is also used for the triangular and truncated triangular weir formulas.
+The "Villemonte (1947)[^Villemonte1947]" equation uses the equation of the [Free weir](seuil_denoye.md) to which the flooding coefficient proposed by Villemonte applies (see explanations below). This flooding coefficient is also used for the triangular and truncated triangular weir formulas.
 
 ![Villemonte formula: submerged weir diagram](kivi_villemonte_schema_seuil_noye.png)
 
+*Excerpt from CETMEF (2005)[^CETMEF2005]*
+
+[^CETMEF2005]: CETMEF. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Compiègne: Centre d’Études Techniques Maritimes Et Fluviales, 2005. <http://www.side.developpement-durable.gouv.fr/EXPLOITATION/DEFAULT/doc/IFD/IFD_REFDOC_0513410/notice-sur-les-deversoirs-synthese-des-lois-d-ecoulement-au-droit-des-seuils-et-deversoirs>
+
 For a downstream water elevation higher than the crest elevation of the weir, the flow is flooded and a flooding coefficient is applied to the flow coefficient.
 
 Villemonte proposes the following formula:
@@ -16,5 +20,4 @@ With:
  - \(h_2\) the downstream water level above the crest of the weir
  - \(n\) the exponent in free flow relationships (rectangular=1.5, triangular=2.5, parabolic=2)
 
- *Villemonte, J.R., 1947. Submerged weir discharge studies. Engineering news record 866, 54–57.*
- 
\ No newline at end of file
+[^Villemonte1947]: Villemonte, J.R., 1947. Submerged weir discharge studies. Engineering news record 866, 54–57.
diff --git a/docs/fr/calculators/structures/kivi.md b/docs/fr/calculators/structures/kivi.md
index a50e3c33b..362200179 100644
--- a/docs/fr/calculators/structures/kivi.md
+++ b/docs/fr/calculators/structures/kivi.md
@@ -7,7 +7,9 @@ Le module de calcul permet d'effectuer des calculs hydrauliques pour plusieurs o
 
 ![Formule de Kindsvater-Carter&nbsp;: Schéma déversoir](kivi_schema_seuil.png)
 
-Figure 12&nbsp;: vue en perspective d'un déversoir rectangulaire avec contraction latérale.
+*Vue en perspective d'un déversoir rectangulaire avec contraction latérale (Extrait de CETMEF, 2005[^CETMEF2005])*
+
+[^CETMEF2005]: CETMEF. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Compiègne: Centre d’Études Techniques Maritimes Et Fluviales, 2005. <http://www.side.developpement-durable.gouv.fr/EXPLOITATION/DEFAULT/doc/IFD/IFD_REFDOC_0513410/notice-sur-les-deversoirs-synthese-des-lois-d-ecoulement-au-droit-des-seuils-et-deversoirs>
 
 La formule de Kindsvater-Carter correspond à la formule classique du déversoir&nbsp;:
 
@@ -28,6 +30,8 @@ Les coefficient \(\alpha\) et \(\beta\) dépendent du rapport entre la largeur d
 
 ![Formule de Villemonte&nbsp;: schéma seuil noyé](kivi_villemonte_schema_seuil_noye.png)
 
+*Extrait de CETMEF, 2005[^CETMEF2005]*
+
 Pour une cote de l'eau aval supérieure à la cote de la crête du déversoir, l'écoulement est noyé et un coefficient de noyage s'applique sur le coefficient de débit.
 
 Villemonte propose la formule suivante&nbsp;:
diff --git a/docs/fr/calculators/structures/villemonte_1947.md b/docs/fr/calculators/structures/villemonte_1947.md
index afabe2539..e6831d481 100644
--- a/docs/fr/calculators/structures/villemonte_1947.md
+++ b/docs/fr/calculators/structures/villemonte_1947.md
@@ -1,9 +1,13 @@
 # Villemonte 1947
 
-L'équation "Villemonte (1947)" utilise l'équation du [seuil dénoyé](seuil_denoye.md) auquel s'applique le coefficient de noyage proposé par Villemonte (cf. explications ci-dessous). Ce coefficient de noyage est aussi utilisé pour les formules de seuil triangulaire et seuil triangulaire tronqué.
+L'équation "Villemonte (1947)[^Villemonte1947]" utilise l'équation du [seuil dénoyé](seuil_denoye.md) auquel s'applique le coefficient de noyage proposé par Villemonte (cf. explications ci-dessous). Ce coefficient de noyage est aussi utilisé pour les formules de seuil triangulaire et seuil triangulaire tronqué.
 
 ![Formule de Villemonte&nbsp;: schéma seuil noyé](kivi_villemonte_schema_seuil_noye.png)
 
+*Extrait de CETMEF, 2005[^CETMEF2005]*
+
+[^CETMEF2005]: CETMEF. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Compiègne: Centre d’Études Techniques Maritimes Et Fluviales, 2005. <http://www.side.developpement-durable.gouv.fr/EXPLOITATION/DEFAULT/doc/IFD/IFD_REFDOC_0513410/notice-sur-les-deversoirs-synthese-des-lois-d-ecoulement-au-droit-des-seuils-et-deversoirs>
+
 Pour une cote de l'eau aval supérieure à la cote de la crête du déversoir, l'écoulement est noyé et un coefficient de noyage s'applique sur le coefficient de débit.
 
 Villemonte propose la formule suivante&nbsp;:
@@ -16,5 +20,4 @@ Avec&nbsp;:
  - \(h_2\) la hauteur d'eau aval au dessus de la crête du déversoir
  - \(n\) l'exposant dans les relations d'écoulement dénoyé (rectangulaire=1.5, triangulaire=2.5, parabolique=2)
 
- *Villemonte, J.R., 1947. Submerged weir discharge studies. Engineering news record 866, 54–57.*
- 
\ No newline at end of file
+[^Villemonte1947]: Villemonte, J.R., 1947. Submerged weir discharge studies. Engineering news record 866, 54–57.
-- 
GitLab