Study Site
Créez des pages d'étude HTML interactives, autonomes, publiées sous forme d'artefacts (ou enregistrées sous forme de fichiers .html si les artefacts ne sont pas disponibles). Chaque page part de assets/template.html, afin que les fonctionnalités permanentes ne soient jamais oubliées.
0. Paramètres — modifiez-les pour vous
| Paramètre | Valeur |
|---|---|
| URL de l'index principal (hub qui lie tous les cours) | none — définissez l'URL de votre hub, ou laissez none pour ignorer les mises à jour de l'index |
| Thème par défaut | light (un bouton de basculement sombre est toujours inclus) |
| Navigation entre chapitres | Lien de retour vers l'index du cours uniquement — pas de liens chapitre précédent/suivant |
| Style des fiches d'index | Minimal : icône, code du cours, nom du cours — pas de statistiques |
1. Demander d'abord (un tour de questions)
Ne demandez que ce qui n'est pas déjà clair dans la demande :
- Est-ce pour un cours ? Si oui : quel cours, quel chapitre ou bloc. Une page de cours reçoit le mode examen et les outils de révision en plus des fonctionnalités standard ; une page hors cours (sujet général, explication ponctuelle) les ignore.
- Où doit-elle être listée ? Directement sur l'index principal, à l'intérieur d'un index d'étude de cours (lequel), ou nulle part. Ignorez cette question si le paramètre de l'index principal est
none. - Si l'URL de l'index d'étude du cours n'est pas connue, demandez-la — le lien de retour de la page en a besoin.
Si l'utilisateur a enregistré des notes sur la façon dont il souhaite qu'un cours soit enseigné (mémoire, instructions de projet, messages précédents), lisez-les et suivez-les plutôt que les valeurs par défaut ci-dessous.
2. Rassembler le matériel avant de construire
- Lisez entièrement chaque fichier joint : diapositives, notes, annales, fiches d'exercices.
- Collectez les questions des années précédentes (PYQ) et les questions d'exercices appartenant à chaque sujet.
- Corrigez silencieusement les erreurs dans le matériel source ; ne les soulignez que si on vous le demande.
- Ce n'est qu'ensuite que vous planifiez la liste des sujets : une
<section class="topic">par sujet logique, suffisamment petite pour être terminée en une seule séance.
3. Règles d'enseignement (toutes matières)
- Ne supposez aucune connaissance préalable. Partez des bases, définissez chaque terme lors de sa première utilisation, développez plutôt que de condenser.
- Ordre à l'intérieur de chaque sujet : explication → son diagramme immédiatement après → explication du diagramme → exemple concret → questions PYQ/exercices → QCM d'entraînement. Ne regroupez jamais les diagrammes à la fin.
- Chaque diagramme reçoit une explication. Ne livrez jamais un diagramme nu.
- Marquez les points importants pour l'examen avec
.callout.impet les pièges courants avec.callout.mistake. - Questions : rédigez chaque question en entier avant sa solution, jamais condensée. Répondez à chaque question ; n'en laissez aucune sans réponse. Étiquetez les PYQ avec la source, l'année et les points (par ex.
PYQ 2024 Midsem · 5M). - Au moins 3 QCM d'entraînement par sujet, avec des distracteurs plausibles et une explication
.why. - Les diagrammes sont en SVG intégré, jamais en ASCII. Utilisez un
.stepper(unfigure.fig.steppar état) pour tout ce qui évolue étape par étape. - Pas de planning d'étude ou de plans journaliers sauf si demandé.
4. Adapter par matière
| Type de matière | Accent |
|---|---|
| Théorie / preuves (théorie du calcul, maths discrètes, algorithmes) | Diagrammes d'états pour chaque automate ; steppers qui tracent les chaînes d'entrée ; modèles de preuve (pompage, réductions, induction) sous forme d'étapes à remplir ; nombreux petits exemples |
| Systèmes (systèmes d'exploitation, architecture des ordinateurs, réseaux) | Visuel en premier ; steppers pour les pipelines, diagrammes de Gantt d'ordonnancement, remplacement de pages, accès cache ; exercices numériques résolus étape par étape ; exercices de fin de chapitre de manuels |
| Langages / notation formelle (langages de programmation, compilateurs) | BNF/EBNF, arbres d'analyse et grammaires attribuées sous forme d'arbres SVG propres ; regex construite pièce par pièce ; questions d'exercices résolues en ligne |
| Mathématiques lourdes (apprentissage automatique, statistiques, signaux) | Intuition d'abord, puis dérivation ligne par ligne avec chaque étape justifiée ; graphiques en SVG ; exercices résolus de manuels |
| Descriptif (biologie, management, sciences humaines) | Piloté par les annales : regrouper les PYQ par thème, réponses modèles à la longueur de l'examen, organigrammes et tableaux de comparaison pour les processus |
Choisissez la ligne la plus proche pour une matière non listée. Les notes de cours de l'utilisateur prévalent sur ce tableau.
5. Fonctionnalités de la page (intégrées au template)
| Fonctionnalité | Comment ça fonctionne | Votre tâche |
|---|---|---|
| Thème clair + basculement sombre | Clair par défaut ; 🌙 bascule ; choix mémorisé | Utilisez uniquement les variables CSS — pas de couleurs codées en dur |
| Restauration du défilement | Position sauvegardée et restaurée à la réouverture | Rien |
| Suivi de progression | "Marquer comme fait" par sujet, barre de progression, ✓ dans le sommaire | id unique sur chaque section de sujet |
| Recherche | Filtre les sujets et met en évidence les résultats | Rien |
| Copie d'image | Bouton survol sur chaque figure.fig qui copie un PNG (toujours visible sur tactile) | Encadrez chaque diagramme ou image dans figure.fig |
| Adapté aux mobiles | Responsive ; les tableaux défilent horizontalement | Gardez les SVG basés sur viewBox ; pas de largeurs fixes |
| QCM d'entraînement | Retour instantané ; réponses mémorisées | data-answer = index basé sur 0 de la bonne option |
| Afficher la réponse | details.answer | Utilisez pour toute solution longue |
| Lien de retour | L'en-tête renvoie vers l'index d'étude du cours | Remplissez {{COURSE_INDEX_URL}} |
| Pages de cours uniquement : outils de révision | Aide-mémoire (.cheatsheet) + flashcards (.flashdeck) | Résumé d'une page des formules, définitions, diagrammes clés ; 10+ flashcards |
| Pages de cours uniquement : mode examen | Flouté jusqu'au démarrage ; minuteur ; QCM notés à la soumission ; réponses modèles révélées | Mélangez les QCM (data-marks) et les questions longues stylisées d'après les annales du cours ; définissez data-minutes |
La progression et les scores vivent dans le navigateur du lecteur, par page — une page d'index ne peut pas afficher la progression des chapitres, et rien n'est synchronisé entre les appareils.
6. Règles de design
- Minimal et calme. Police avec empattement pour la lecture longue, sans empattement pour l'interface utilisateur. Largeur du contenu ~820px.
- Évitez l'IA générique : pas de dégradés violets, bannières héros, mises en page tout-centré, Inter, ou confettis d'emoji.
- La couleur porte du sens : bleu = information, or = important pour l'examen, rouge = erreur, vert = correct/fait.
- Diagrammes SVG : étiquetez tout ; utilisez
var(--text),var(--accent), etc. pour les traits et les remplissages ; texte ≥12px à la largeur mobile.
7. Pages d'index d'étude de cours
Pour un index ou hub de cours : fiches minimales (voir paramètres), même en-tête (recherche + basculement de thème), restauration du défilement, clair par défaut.
8. Construire, publier, vérifier
- Copiez
assets/template.html, remplissez les{{placeholders}}, supprimez les blocs réservés aux cours pour les pages hors cours (ou décommentez-les pour les pages de cours). - Publiez sous forme d'artefact (ou enregistrez le
.html). Montrez-le d'abord ; vérifiez ensuite. - Vérifiez sur ordinateur et à une largeur d'environ 390px, dans les deux thèmes : chaque figure a un bouton de copie, chaque QCM a un
data-answercorrect, chaque question a une réponse, aucun{{placeholders}}ne subsiste. - Ajoutez le lien de la page à l'index principal ou du cours comme choisi à l'étape 1. Ne reconcevez pas l'index.