Site d'exercices pratiques en Vue 3 + Vite : un catalogue de sujets (Linux, Git, Python, Docker), chacun avec ses exercices. Chaque exercice ouvre un environnement Linux éphémère dans le navigateur (container incus).
npm install
npm run dev -- --host 127.0.0.1 # http://127.0.0.1:5173
npm run build # sortie dans dist/src/data/site.js: tout le contenu (logo, menu, sujets, exercices, sections de l'accueil, pied de page)src/styles/tokens.css: couleurs, police, taille des cartes, espacementspublic/: vos images ; mettezbrand.logoSrc: '/logo.svg'pour un logo image
| Fichier | Rôle |
|---|---|
views/HomeView.vue |
accueil : recherche, 4 sujets, sections « À la une » et « Populaires » |
views/CatalogueView.vue |
tous les sujets et leurs exercices |
views/TopicView.vue |
page d'un sujet (/catalogue/:topic) |
views/ExerciseView.vue |
page d'un exercice et bouton « Lancer l'exercice » (/exercices/:slug) |
views/PlaygroundView.vue |
terminal (xterm.js), compte à rebours, arrêt |
components/AppNavbar.vue |
barre noire : logo, Catalogue, À propos ; hamburger sous 992px |
components/TileGrid.vue / TileCard.vue |
grille de cartes de 200px ; variantes logo (sujet) et content (exercice) |
components/AppFooter.vue |
pied de page minimal |
Chaque exercice lance un container incus éphémère (image définie par l'exercice) : 30 min, 0,5 CPU, 512 Mo, sans Internet. Il n'y a pas de playground libre.
Dev (dans le container de dev, avec incus imbriqué) :
# une fois : incus admin init --preseed < infra/incus-preseed-dev.yaml
# ./infra/apply-profile.sh && ./infra/build-images.sh
cd server && npm install
sg incus-admin -c "COOKIE_SECRET=dev npx tsx watch src/index.ts" # API sur :3000
npm run dev -- --host 127.0.0.1 # front sur :5173 (proxy /api et /ws)| Dossier | Contenu |
|---|---|
server/ |
API Fastify + relais WebSocket vers incus exec (TypeScript) |
infra/ |
init incus, profil, fabrication des images, Caddy, systemd, scripts VPS |
src/views/ExerciseView.vue, PlaygroundView.vue |
lancement depuis un exercice, page du terminal (xterm.js) |
L'identifiant d'un exercice est son chemin : <sujet>/[<rubrique>/]<nom>, par exemple linux/commandes/ls ou git/conflits. Ce chemin sert à trois endroits :
- c'est son dossier dans
exercises/; - c'est la valeur envoyée à l'API ;
- c'est son URL, sous la forme
/catalogue/<id>.
L'exercice doit aussi être déclaré dans src/data/site.js avec :
topic,category(facultatif) etslug;- le titre, la durée et le niveau (
débutant,intermédiaireouavancé) ; command(facultatif) : le nom affiché en police mono dans l'index de la rubrique.
Les rubriques d'un sujet sont déclarées dans topics[].categories. Un sujet sans rubriques garde ses exercices à plat.
Un exercice devient lançable dès que son dossier existe :
exercises/linux/commandes/ls/
├─ exercise.json {"image": "pg-ubuntu", "setup": "setup.sh", "cwd": "/root/projet"}
├─ setup.sh lancé en root dans le container juste après sa création (prépare les fichiers)
└─ cours.md le cours, affiché à droite du terminal
exercise.json:image:pg-ubuntuoupg-alpine;setup(optionnel) : script lancé à la création ;cwd(optionnel) : dossier où s'ouvre le shell.
setup.sh: doit renvoyer 0, sinon l'environnement est supprimé et le visiteur reçoit une erreur. Le container n'a pas Internet, donc tout ce qui est nécessaire doit être dans l'image.cours.md: du Markdown classique.- Un
## Titrepar étape. - Les blocs
```bashreçoivent un bouton Essayer, qui tape la commande dans le terminal sans la valider. - Pour une réponse à déplier :
<details><summary>Voir la réponse</summary>…</details>.
- Un
- Redémarrer l'API après l'ajout d'un exercice : le catalogue est lu au démarrage.
Le plan des playgrounds (incus, backend, déploiement VPS) est dans docs/PLAN-playgrounds.md.