# betteriutinfoaix/wiki-betteralgopapier architecture

> Architecture diagram of the GitHub repository betteriutinfoaix/wiki-betteralgopapier, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/betteriutinfoaix/wiki-betteralgopapier
- Repository: https://github.com/betteriutinfoaix/wiki-betteralgopapier

## Overview

Wiki statique francophone d’algorithmique papier pour les étudiants de L1 de l’IUT d’Aix. Le parcours mène des notions fondamentales aux exercices interactifs, puis à l’usage de l’extension VSCode. Les pages Markdown constituent le contenu pédagogique; Docusaurus les présente avec une coloration dédiée et des composants de page d’accueil. Les exercices corrigent les réponses, conservent leur état localement et proposent une navigation manuelle. Les liens de signalement préremplissent un formulaire GitHub sans backend. Les sous-systèmes de cours et d’extension sont documentés, mais leurs implémentations respectives ne sont pas présentes dans ce dépôt.

Main entry points: [`src/pages/index.tsx`](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/pages/index.tsx) (Page d’accueil), [`src/components/Exercises/Quiz.tsx`](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/Quiz.tsx) (QCM), [`src/components/Exercises/FillInBlank.tsx`](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/FillInBlank.tsx) (Texte à trous), [`src/components/LandingChapters/index.tsx`](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingChapters/index.tsx) (Parcours chapitré)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Parcours pédagogique"]
  node_docs["Cours Markdown"]
  node_extension["Guide extension"]
end

subgraph group_interactive["Exercices interactifs"]
  node_quiz["QCM<br/>[Quiz.tsx]"]
  node_fillblank["Texte à trous<br/>[FillInBlank.tsx]"]
  node_inline["Rendu inline<br/>[Inline.tsx]"]
  node_types["Modèles exercices<br/>[types.ts]"]
  node_navigation["Navigation exercices<br/>[navigate.ts]"]
  node_localstorage[("Stockage navigateur")]
  node_report["Signalement prérempli<br/>[index.tsx]"]
end

subgraph group_presentation["Présentation du wiki"]
  node_chapters["Parcours chapitré<br/>[index.tsx]"]
  node_home["Page d’accueil<br/>[index.tsx]"]
  node_hero["Introduction visuelle<br/>[index.tsx]"]
  node_extension_promo["Présentation extension<br/>[index.tsx]"]
  node_compiler_promo["Compilateur annoncé<br/>[index.tsx]"]
  node_stats["Statistiques accueil<br/>[index.tsx]"]
end

subgraph group_language["Langage et extension"]
  node_prism_hook["Chargement Prism"]
  node_algo_highlight["Coloration algo<br/>[algo-papier.js]"]
  node_extension_runtime["Extension VSCode"]
end

node_student(("Étudiant"))
node_github(("Formulaire GitHub"))

node_student -.->|"ouvre"| node_home
node_home -.->|"affiche"| node_hero
node_home -.->|"affiche"| node_chapters
node_home -.->|"affiche"| node_extension_promo
node_home -.->|"affiche"| node_compiler_promo
node_home -.->|"affiche"| node_stats
node_chapters -->|"oriente vers"| node_docs
node_chapters -->|"oriente vers"| node_extension
node_student -.->|"consulte"| node_docs
node_quiz -->|"utilise types"| node_types
node_fillblank -->|"utilise types"| node_types
node_quiz -->|"rend le texte"| node_inline
node_fillblank -->|"rend le texte"| node_inline
node_quiz -->|"déclenche au clic"| node_navigation
node_fillblank -->|"déclenche au clic"| node_navigation
node_quiz -->|"lit et écrit"| node_localstorage
node_fillblank -->|"lit et écrit"| node_localstorage
node_quiz -->|"prépare signalement"| node_report
node_fillblank -->|"prépare signalement"| node_report
node_report -->|"ouvre formulaire"| node_github
node_prism_hook -->|"enregistre langage"| node_algo_highlight
node_docs -.->|"charge coloration"| node_prism_hook
node_extension_promo -->|"promeut installation"| node_extension
node_extension -->|"documente"| node_extension_runtime
node_extension_promo -->|"présente capacités"| node_extension_runtime
node_compiler_promo -.->|"annonce futur compilateur"| node_extension_runtime

click node_docs "https://github.com/betteriutinfoaix/wiki-betteralgopapier/tree/main/docs"
click node_chapters "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingChapters/index.tsx"
click node_home "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/pages/index.tsx"
click node_hero "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingHero/index.tsx"
click node_extension "https://github.com/betteriutinfoaix/wiki-betteralgopapier/tree/main/docs/extension"
click node_extension_promo "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingExtension/index.tsx"
click node_compiler_promo "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingCompiler/index.tsx"
click node_stats "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingStats/index.tsx"
click node_quiz "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/Quiz.tsx"
click node_fillblank "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/FillInBlank.tsx"
click node_inline "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/Inline.tsx"
click node_types "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/types.ts"
click node_navigation "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/navigate.ts"
click node_report "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/ReportIssue/index.tsx"
click node_prism_hook "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/theme/prism-include-languages.js"
click node_algo_highlight "https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/prism/algo-papier.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_docs,node_extension toneBlue
class node_quiz,node_fillblank,node_inline,node_types,node_navigation,node_localstorage,node_report toneAmber
class node_chapters,node_home,node_hero,node_extension_promo,node_compiler_promo,node_stats toneMint
class node_prism_hook,node_algo_highlight,node_extension_runtime toneRose
class node_student,node_github toneIndigo
```

## Components

### Parcours pédagogique

- [Cours Markdown](https://github.com/betteriutinfoaix/wiki-betteralgopapier/tree/main/docs): `docs`
- [Guide extension](https://github.com/betteriutinfoaix/wiki-betteralgopapier/tree/main/docs/extension): `docs/extension`

### Exercices interactifs

- [QCM](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/Quiz.tsx): `src/components/Exercises/Quiz.tsx`
- [Texte à trous](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/FillInBlank.tsx): `src/components/Exercises/FillInBlank.tsx`
- [Rendu inline](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/Inline.tsx): `src/components/Exercises/Inline.tsx`
- [Modèles exercices](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/types.ts): `src/components/Exercises/types.ts`
- [Navigation exercices](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/Exercises/navigate.ts): `src/components/Exercises/navigate.ts`
- **Stockage navigateur**
- [Signalement prérempli](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/ReportIssue/index.tsx): `src/components/ReportIssue/index.tsx`

### Présentation du wiki

- [Parcours chapitré](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingChapters/index.tsx): `src/components/LandingChapters/index.tsx`
- [Page d’accueil](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/pages/index.tsx): `src/pages/index.tsx`
- [Introduction visuelle](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingHero/index.tsx): `src/components/LandingHero/index.tsx`
- [Présentation extension](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingExtension/index.tsx): `src/components/LandingExtension/index.tsx`
- [Compilateur annoncé](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingCompiler/index.tsx): `src/components/LandingCompiler/index.tsx`
- [Statistiques accueil](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/components/LandingStats/index.tsx): `src/components/LandingStats/index.tsx`

### Langage et extension

- [Chargement Prism](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/theme/prism-include-languages.js): `src/theme/prism-include-languages.js`
- [Coloration algo](https://github.com/betteriutinfoaix/wiki-betteralgopapier/blob/main/src/prism/algo-papier.js): `src/prism/algo-papier.js`
- **Extension VSCode**

### Other components

- **Étudiant**
- **Formulaire GitHub**

## Connections

- Étudiant → Page d’accueil: ouvre (evidence: `README.md`)
- Page d’accueil → Introduction visuelle: affiche (evidence: `src/pages/index.tsx`)
- Page d’accueil → Parcours chapitré: affiche (evidence: `src/pages/index.tsx`)
- Page d’accueil → Présentation extension: affiche (evidence: `src/pages/index.tsx`)
- Page d’accueil → Compilateur annoncé: affiche (evidence: `src/pages/index.tsx`)
- Page d’accueil → Statistiques accueil: affiche (evidence: `src/pages/index.tsx`)
- Parcours chapitré → Cours Markdown: oriente vers (evidence: `src/components/LandingChapters/index.tsx`)
- Parcours chapitré → Guide extension: oriente vers (evidence: `src/components/LandingChapters/index.tsx`)
- Étudiant → Cours Markdown: consulte (evidence: `README.md`)
- QCM → Modèles exercices: utilise types (evidence: `src/components/Exercises/Quiz.tsx`)
- Texte à trous → Modèles exercices: utilise types (evidence: `src/components/Exercises/FillInBlank.tsx`)
- QCM → Rendu inline: rend le texte (evidence: `src/components/Exercises/Quiz.tsx`)
- Texte à trous → Rendu inline: rend le texte (evidence: `src/components/Exercises/FillInBlank.tsx`)
- QCM → Navigation exercices: déclenche au clic (evidence: `src/components/Exercises/Quiz.tsx`)
- Texte à trous → Navigation exercices: déclenche au clic (evidence: `src/components/Exercises/FillInBlank.tsx`)
- QCM → Stockage navigateur: lit et écrit (evidence: `src/components/Exercises/Quiz.tsx`)
- Texte à trous → Stockage navigateur: lit et écrit (evidence: `src/components/Exercises/FillInBlank.tsx`)
- QCM → Signalement prérempli: prépare signalement (evidence: `src/components/Exercises/Quiz.tsx`)
- Texte à trous → Signalement prérempli: prépare signalement (evidence: `src/components/Exercises/FillInBlank.tsx`)
- Signalement prérempli → Formulaire GitHub: ouvre formulaire (evidence: `src/components/ReportIssue/index.tsx`)
- Chargement Prism → Coloration algo: enregistre langage (evidence: `src/theme/prism-include-languages.js`)
- Cours Markdown → Chargement Prism: charge coloration (evidence: `README.md`)
- Présentation extension → Guide extension: promeut installation (evidence: `src/components/LandingExtension/index.tsx`)
- Guide extension → Extension VSCode: documente (evidence: `README.md`)
- Présentation extension → Extension VSCode: présente capacités (evidence: `src/components/LandingExtension/index.tsx`)
- Compilateur annoncé → Extension VSCode: annonce futur compilateur (evidence: `README.md`)
