# Règles LaTeX communes aux trois decks (lire intégralement avant d'écrire une ligne)

# Fichiers et compilation

• Classe : \documentclass[aspectratio=169,10pt]{beamer} + \usepackage{uqo-style} (le style du cours, présent dans 02_Slides/sources/ de chaque cours ; NE PAS le modifier). 10 pt (et non 11 pt) pour éviter les débordements.
• Le deck est découpé : un fichier principal seanceNN*.tex (préambule, page titre, \input des parties) et des parties dans parties/sNN_bloc<k>.tex (un fichier par bloc). Chaque \input est relatif au dossier sources/.
• Compilation de contrôle : ~/Desktop/UQO/Enseignement/UQO_COURS/UQO_COURS_UPGRADE/validation/compile_deck.sh <dossier sources> <nom_sans_ext> <sandbox> → affiche pages, Overfull, et les pages en débordement (check_overflow.py). Objectif : 0 débordement, 0 erreur. Compiler souvent (à chaque bloc).
• Bibliographie : biblatex/biber via references.bib du cours (déjà chargé par le style). Ajouter les nouvelles entrées dans ce references.bib (clés fournies par la recherche documentaire : recherche/refs_*.bib), puis \nocite{...} + \printbibliography[heading=none] dans la dernière diapo [allowframebreaks].
• \date{Automne 2026} pour les trois decks.

# Gotchas connus (babel-french + Beamer + TikZ)

• ! est actif en babel-french : jamais ($(a)!0.5!(b)$) dans TikZ ; utiliser coordinate[pos=0.5], [yshift=…], ou \tikzset{...} avec midway. Pas de bibliothèque TikZ babel.
• Pas de \ifnum dans les options pgf/pgfplots ; définir les couleurs avec \colorlet avant.
• pgfplots : \pgfplotsset{compat=1.18} est déjà posé ; pas de fill between + soft clip ; pour une aire sous courbe : \addplot[fill=…, draw=none, domain=a:b] {f} \closedcycle;.
• Beamer n'avertit pas des débordements dans columns → budget : \footnotesize dans les colonnes, tableaux en \footnotesize ou \scriptsize (≤ 11 lignes par diapo ; scinder sinon), notes en \tiny.
• Titres de tcolorbox courts (< 60 caractères) sinon Overfull \hbox.
• Pas de caractères Unicode exotiques (√, ½ en texte → \tfrac12 en math, « 1/2 » en texte) ; \textonehalf existe (textcomp) ; \up{2} n'existe pas : écrire pi\textsuperscript{2} ou pi$^2$.
• Montants : 435~000~\$, pourcentages 5\,\%, signes en math $-$8~000~\$, $+$.
• Ne jamais rediriger une sortie vers <nom>.out.
• Une diapo = une idée ; ≤ 7 puces ; ≤ 2 boîtes tcolorbox par diapo ; pas de [shrink] sauf exception documentée.
• Environnements disponibles (uqo-style) : defbox[titre], importbox, exbox, notebox, quizbox ; macros \uqotitle{}, \uqoalert{}, \uqogreen{}, \uqohighlight{}, \uqosep, \contactslide[texte] ; styles TikZ uqostep, uqocard, uqoflow, uqoarrow ; couleurs uqoBleu, uqoBleuClair, uqoOr, uqoGris, uqoGrisClair, uqoVert, uqoRouge, uqoBgClair, uqoNavy, uqoInk (⚠️ uqoTeal n'existe PAS dans la copie IMM1003 du style ; dans IMM1033 vérifier avec grep uqoTeal uqo-style.sty et sinon utiliser uqoBleuClair).
• \section{} produit une page de section pleine (comptée dans le PDF, ignorée par le détecteur de débordement).

# Macros à définir dans le préambule de chaque deck (copier tel quel)

\newcommand{\bloc}[2]{\begin{frame}[plain,noframenumbering]\begin{tikzpicture}[remember picture,overlay]
 \fill[uqoNavy] (current page.south west) rectangle (current page.north east);
 \node[text=uqoOr, font=\bfseries\Large, anchor=west] at ([xshift=12mm,yshift=14mm]current page.west) {Bloc #1};
 \node[text=white, font=\bfseries\huge, anchor=west, text width=0.8\paperwidth] at ([xshift=12mm,yshift=0mm]current page.west) {#2};
\end{tikzpicture}\end{frame}}
\newcommand{\duree}[1]{\hfill{\footnotesize\color{uqoGris}\faIcon{clock}\,#1}}
\newcommand{\question}[1]{\begin{quizbox}[Question à la classe]#1\end{quizbox}}
\newcommand{\erreur}[1]{\begin{importbox}[Erreur fréquente]#1\end{importbox}}
\newcommand{\src}[1]{{\tiny\color{uqoGris}Source : #1}}
\newcommand{\pi}[0]{pi\textsuperscript{2}}  % NON : \pi est pris — utiliser \pisq ci-dessous

⚠️ Ne pas redéfinir \pi. Définir plutôt \newcommand{\pisq}{pi\textsuperscript{2}}.

# Style rédactionnel

• Français universitaire québécois ; gras pour les définitions, concepts clés, résultats et formules.
• Chaque bloc commence par \bloc{k}{Titre} puis une diapo « Objectifs du bloc » ; la durée indicative des diapositives n'est PAS affichée sur les diapos (elle est dans le script et le plan).
• Toute donnée chiffrée externe porte un \src{} (auteur/organisme, année) correspondant à une entrée de references.bib ou de la recherche documentaire ; toute hypothèse pédagogique est étiquetée « convention du cours » ou « hypothèse pédagogique ».
• Tous les chiffres des cas (grilles, chaînes de coût, sensibilités) viennent de validation/RESULTATS_CALCULS.md / resultats.json — ne recalculer à la main que pour vérifier ; en cas de désaccord, signaler.