SPB Git

Repository Public Research preview

REGLES_LATEX_COMMUNES.md 5.0 KB 43 lines markdown

1# Règles LaTeX communes aux trois decks (lire intégralement avant d'écrire une ligne)23## Fichiers et compilation4- 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.5- 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/`.6- 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).7- 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]`.8- `\date{Automne 2026}` pour les trois decks.910## Gotchas connus (babel-french + Beamer + TikZ)11- `!` 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`.12- Pas de `\ifnum` dans les options pgf/pgfplots ; définir les couleurs avec `\colorlet` avant.13- 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;`.14- 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`.15- Titres de tcolorbox courts (< 60 caractères) sinon `Overfull \hbox`.16- 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$`.17- Montants : `435~000~\$`, pourcentages `5\,\%`, signes en math `$-$8~000~\$`, `$+$`.18- Ne jamais rediriger une sortie vers `<nom>.out`.19- Une diapo = **une idée** ; ≤ 7 puces ; ≤ 2 boîtes tcolorbox par diapo ; pas de `[shrink]` sauf exception documentée.20- 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`).21- `\section{}` produit une page de section pleine (comptée dans le PDF, ignorée par le détecteur de débordement).2223## Macros à définir dans le préambule de chaque deck (copier tel quel)24```latex25\newcommand{\bloc}[2]{\begin{frame}[plain,noframenumbering]\begin{tikzpicture}[remember picture,overlay]26 \fill[uqoNavy] (current page.south west) rectangle (current page.north east);27 \node[text=uqoOr, font=\bfseries\Large, anchor=west] at ([xshift=12mm,yshift=14mm]current page.west) {Bloc #1};28 \node[text=white, font=\bfseries\huge, anchor=west, text width=0.8\paperwidth] at ([xshift=12mm,yshift=0mm]current page.west) {#2};29\end{tikzpicture}\end{frame}}30\newcommand{\duree}[1]{\hfill{\footnotesize\color{uqoGris}\faIcon{clock}\,#1}}31\newcommand{\question}[1]{\begin{quizbox}[Question à la classe]#1\end{quizbox}}32\newcommand{\erreur}[1]{\begin{importbox}[Erreur fréquente]#1\end{importbox}}33\newcommand{\src}[1]{{\tiny\color{uqoGris}Source : #1}}34\newcommand{\pi}[0]{pi\textsuperscript{2}}  % NON : \pi est pris — utiliser \pisq ci-dessous35```36⚠️ Ne pas redéfinir `\pi`. Définir plutôt `\newcommand{\pisq}{pi\textsuperscript{2}}`.3738## Style rédactionnel39- Français universitaire québécois ; **gras** pour les définitions, concepts clés, résultats et formules.40- 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).41- 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 ».42- 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.43
Files main
Menu

Theme