Improve PDF doc

fix depth level bug in mkdocs2pdf.py
add Mathias Chouet as co-author
fix crappy titles in .md doc

docs/en/calculators/structures/fente_noyee.md

@@ -14,4 +14,4 @@ With:
 * *H<sub>1</sub>* the head on the slot m
 * *μ* the discharge coefficient (equal to 0.65 by default).
 
-The discharge coefficient *μ* may vary from 0.65 for a sharp-edged slot to more than 0.85 when the slot profile is rounded.
+The discharge coefficient *μ* may vary from 0.65 for a sharp-edged slot to more than 0.85 when the slot profile is rounded.
\ No newline at end of file

docs/en/calculators/structures/kivi.md

@@ -2,7 +2,7 @@
 
 The calculation module allows hydraulic calculations to be carried out for several structures in parallel.
 
-## Kindsvater-Carter formula (1957)
+## Kindsvater-Carter formula (1957)
 
 ![Kindsvater-Carter formula: weir diagram](kivi_schema_seuil.png)
 

docs/en/calculators/structures/seuil_noye.md

+
 # Submerged weir formula
 
 ![Submerged weir diagram](seuil_noye_schema.png)

docs/fr/calculators/hyd_en_charge/cond_distri.md

@@ -2,7 +2,7 @@
 
 Relation analytique pour le calcul direct des pertes de charge en conduite distribuant un débit de façon homogène établi à partir de la formule de Blasius.
 
-## Hypothèses
+## Hypothèses
 
 ![Schéma conduite](cond_distri.png)
 
@@ -10,7 +10,7 @@ On suppose une conduite de longueur \(L\), diamètre intérieur \(D\), avec un d
 
 $$\lambda \simeq a Re^{-0.25}$$
 
-## Développement analytique
+## Développement analytique
 
 On note \(x\) la position depuis l'aval de la conduite. Le débit est supposé varier linéairement avec \(x\), et s'écrit alors:
 
@@ -46,7 +46,7 @@ $$\Delta H=a \nu ^{0.25} \frac{(4/\pi)^{1.75}Q^{1.75}}{2g D^{4.75}}\frac{L}{2.75
 
 $$\Delta H=a \nu ^{0.25} \frac{4^{1.75}}{5.5g \pi^{1.75}}\frac{Q^{1.75}L}{D^{4.75}}$$
 
-## Application numérique
+## Application numérique
 
 Pour une  eau à 20°C: \(\nu\simeq 10^{-6}\) m<sup>2</sup>/s, ce qui donne
 

docs/fr/calculators/structures/fente_noyee.md

@@ -14,4 +14,4 @@ Avec :
 * *H<sub>1</sub>* la charge sur la fente m&nbsp;
 * *μ* le coefficient de débit (égal à 0.65 par défaut).
 
-Le coefficient de débit *μ* peut varier de 0.65 pour une fente à arêtes vives à plus de 0.85 lorsque le profil de la fente est arrondi.
+Le coefficient de débit *μ* peut varier de 0.65 pour une fente à arêtes vives à plus de 0.85 lorsque le profil de la fente est arrondi.
\ No newline at end of file

docs/fr/calculators/structures/kivi.md

@@ -3,7 +3,7 @@
 
 Le module de calcul permet d'effectuer des calculs hydrauliques pour plusieurs ouvrages en parallèle.
 
-## Formule de Kindsvater-Carter (1957)
+## Formule de Kindsvater-Carter (1957)
 
 ![Formule de Kindsvater-Carter : Schéma déversoir](kivi_schema_seuil.png)
 

docs/fr/calculators/structures/seuil_denoye.md

+
 # Formule du déversoir dénoyé
 
 La formule est dérivée de la formule originale de Poleni (1717).

docs/fr/mentions_legales.md

@@ -87,7 +87,7 @@ Les contenus produits par Cassiopée (Résultats de calculs, tableaux, graphique
 
 La documentation de Cassiopée est publiée sous [Licence CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode.fr) qui autorise à copier, distribuer, communiquer tout ou partie de la documentation par tous moyens et tous formats à condition de la créditer, d'intégrer un lien vers la licence, de ne pas en faire un usage commercial, et de ne pas l'avoir modifiée.
 
-## Logiciels libres
+## Logiciels libres
 
 ### Licence du module de calcul de Cassiopée
 

docs/latex/cassiopee_doc_en.tex

@@ -24,7 +24,7 @@
 \newcommand{\sousTitre}{User documentation}
 %Statut du document [rapport final, rapport intermédiaire]
 % auteur intellectuel, rédacteur du document, il peut y avoir plusieurs auteurs ; chaque auteur est renseigné sous la forme « Prénom NOM »
-\newcommand{\auteur}{David DORCHIES}
+\newcommand{\auteur}{David DORCHIES, Mathias CHOUET}
 % date de validation du document (qui entraine sa diffusion)]
 \newcommand{\dateValidation}{\today}
 % Site INRAE

docs/latex/cassiopee_doc_fr.tex

@@ -24,7 +24,7 @@
 \newcommand{\sousTitre}{Documentation utilisateur}
 %Statut du document [rapport final, rapport intermédiaire]
 % auteur intellectuel, rédacteur du document, il peut y avoir plusieurs auteurs ; chaque auteur est renseigné sous la forme « Prénom NOM »
-\newcommand{\auteur}{David DORCHIES}
+\newcommand{\auteur}{David DORCHIES, Mathias CHOUET}
 % date de validation du document (qui entraine sa diffusion)]
 \newcommand{\dateValidation}{\today}
 % Site INRAE

mkdocs2pdf.py

@@ -47,7 +47,6 @@ def getMdHeader(title, level):
     return "#" * level + " " + title + "\n"
 
 def shiftMdHeaders(mdContent, level):
-
     if level == 0:
         return mdContent
 
@@ -85,7 +84,9 @@ def exploreAndMerge(docs_dir, nav, output = '', level = 0):
             for key, value in d.items():
                 if type(value) is list:
                     output += "\n" + getMdHeader(key, level) + "\n"
-                output = exploreAndMerge(docs_dir, value, output, level)
+                    output = exploreAndMerge(docs_dir, value, output, level)
+                else:
+                    output = exploreAndMerge(docs_dir, value, output, level-1) # do not dig level when sub-chapter has only one entry (alias)
             level -= 1
     return output