Mode d'emploi
Pour les étudiants
Section intitulée « Pour les étudiants »- Les encadrés 🎓 Pour aller plus loin contiennent les formules et les démonstrations. Ils sont fermés par défaut ; le bouton 🎓 Tout approfondir, en haut de chaque chapitre, les ouvre tous.
- Les graphiques interactifs réagissent aux curseurs et aux boutons. Ils sont calculés dans le navigateur : vous pouvez les manipuler autant que vous voulez.
- Les liens 🔬 ouvrent le simulateur déjà réglé ; revenez au cours avec le menu « Cours ».
- Le quiz de fin de chapitre est corrigé immédiatement ; votre score est gardé dans ce navigateur.
- 📄 PDF : enregistre le chapitre en PDF (ou l’imprime), avec tous les encadrés ouverts.
- La recherche (en haut) parcourt tout le cours.
🎓 Pour aller plus loin : un exemple d'encadré
Voici à quoi ressemble un encadré : il peut contenir du texte, des listes et des formules, comme ou
Pour l’enseignant : écrire un chapitre
Section intitulée « Pour l’enseignant : écrire un chapitre »Chaque chapitre est un fichier .mdx du dossier cours/src/content/docs/, rangé par partie (par exemple supervise/regression/surapprentissage.mdx). On l’écrit en Markdown, avec quelques ajouts.
L’en-tête décrit le chapitre :
---title: Sous-apprentissage et surapprentissagedescription: Une phrase de résumé (affichée dans la recherche).duree: 45 minprerequis: [Régression linéaire, Erreur quadratique moyenne]objectifs: - distinguer erreur d'entraînement et erreur de test ; - reconnaître le sous- et le surapprentissage.---Les formules s’écrivent en LaTeX : $…$ dans une phrase, $$…$$ sur une ligne à part.
Les encadrés de Starlight : :::note, :::tip[À retenir], :::caution, :::danger, terminés par :::.
Les composants, à importer en haut du fichier :
import Approfondir from '../../../components/Approfondir.astro';import Simulation from '../../../components/Simulation.astro';import Quiz from '../../../components/Quiz.astro';
<Approfondir titre="la décomposition biais-variance">Texte, formules…</Approfondir>
<Simulation href="/observer?jeu=lunes&modele=knn&k=1" titre="k = 1 sur les deux lunes">Une phrase qui dit quoi observer.</Simulation>
<Quiz id="identifiant-unique" questions={[ { q: "La question ?", choix: ["réponse A", "réponse B"], bonne: 1, explication: "Pourquoi B." },]} />Les graphiques interactifs s’insèrent comme des balises HTML, par exemple <ds-ajustement degre="3" courbe-u></ds-ajustement>. Ils sont définis dans visualiseur/static/widgets/ et utilisables aussi dans les pages du simulateur.
Les liens vers le simulateur acceptent les réglages dans l’adresse : jeu, n, bruit, vue, vx, vy, etiquettes_fausses, variables_bruit, desequilibre, normaliser, puis modele et ses réglages (k, C, gamma, profondeur…).
Pour voir le résultat en direct pendant l’écriture : lancer l’application (uv run python -m visualiseur), puis dans le dossier cours/, npm run dev, et ouvrir http://localhost:4321/cours/. Pour publier : npm run build.