Un site de cours
Un cours de plusieurs semaines : une page d'accueil, une page par semaine, un menu qui les liste, et le code du cours tiré de son dépôt git.
git pour l'étape 5Durée : 30 minVous obtenez : un site de cours avec un menu, dans .site/Ce que vous obtiendrez
Plutôt des slides de cours que des pages web, un jeu de slides par chapitre, en slides et en PDF ? Voyez Un cours en plusieurs chapitres dans la recette PDF.
1. Créer le site
lhtml-site init my-course cd my-course
Le thème est webpage-frame : un menu de navigation, des pages de n'importe quelle longueur. init
écrit aussi deux pages pour démarrer, src/01_welcome/ et src/02_writing/ : lisez-les, puis
supprimez-les pour faire place aux semaines :
rm -r src/01_welcome src/02_writing
2. Un répertoire par semaine
my-course/
configure.yaml
src/
index.html.j2 la page d'accueil
01_week-1/index.html.j2
02_week-2/index.html.j2
02_week-2/assets/scene.png les images d'une semaine, à côté de sa page
Les pages suivent l'ordre de leurs chemins : les numéros gardent les semaines dans l'ordre, et une
nouvelle semaine est un nouveau répertoire. src/index.html.j2 vient en premier : c'est la page
d'accueil, en haut du menu.
3. Une semaine
= Semaine 2 : animation procédurale
== Objectifs
* Animer une sphère qui tombe sous l'effet de la gravité
* Gérer la collision avec le sol
== Exercice
::[background:#f3f6ff; padding:8px 12px; border-radius:6px;]
**Exercice 1.** Calculez l'instant où la sphère touche le sol.
::
<details><summary>Solution</summary>
Résolvez \(h - \frac{1}{2} g t^2 = 0\) : \(t = \sqrt{2h/g}\).
</details>HTML produit
<h1>Semaine 2 : animation procédurale</h1>
<h2>Objectifs</h2>
<ul>
<li>
Animer une sphère qui tombe sous l'effet de la gravité
</li>
<li>
Gérer la collision avec le sol
</li>
</ul>
<h2>Exercice</h2>
<div style="background:#f3f6ff; padding:8px 12px; border-radius:6px;">
<strong>Exercice 1.</strong> Calculez l'instant où la sphère touche le sol.
</div>
<details><summary>Solution</summary>
Résolvez \(h - \frac{1}{2} g t^2 = 0\) : \(t = \sqrt{2h/g}\).
</details><details>est du HTML ordinaire : la solution reste cachée jusqu'à ce que l'étudiant l'ouvre.- LHTML garde les formules telles qu'elles sont écrites ; les thèmes de lhtml-site les affichent avec KaTeX, comme dans le résultat ci-dessus.
- Le titre
=est le nom de la page dans le menu.
4. Des valeurs communes à toutes les pages
Écrivez-les une fois dans configure.yaml (les lignes keywords: y sont déjà, derrière un #) :
keywords: course: 'Computer Animation' year: 2026
et utilisez-les dans le texte de n'importe quelle page :
Bienvenue dans {{ course }} ({{ year }}). Gardez-les hors des titres = : le
menu affiche un titre tel qu'il est écrit, avant Jinja.
5. Le code du cours
Le plugin code_include.py, fourni avec lhtml-site, insère du code depuis un dépôt git, pour que la
page et le code ne se contredisent jamais. Dans configure.yaml, donnez au dépôt un nom court
de votre choix, suivi de son URL :
plugin: ['plugins/code_include.py'] plugin_arg: includeadv: {course-code: 'https://github.com/me/course-code'}
Ici le nom est course-code ; ce pourrait être cg ou td. La construction clone le dépôt dans
code/course-code/, et chaque filepath commence par ce nom, quel que soit le nom du dépôt sur
GitHub.
Puis, dans une page, nommez un fichier du dépôt, sans espace après filepath: :
code::[python]
includeadv::{filepath:'course-code/src/gravity.py'}
code::[-]
La page montre le fichier comme un bloc de code coloré. research:'def fall' après le filepath
n'insère que la première ligne qui contient ce texte. Chaque construction clone le dépôt dans
code/, à côté de configure.yaml, ou le met à jour (git pull) : il faut git.
6. Prévisualiser et publier
lhtml-site --serve --watch
Ouvrez http://127.0.0.1:8000/ : chaque enregistrement reconstruit le site, rafraîchissez le
navigateur pour le voir. Ctrl+C arrête le serveur. Le site est dans .site/.
En cas de problème
- Une commande est introuvable, ou une fonction dit qu'il lui manque quelque chose :
lhtml-site doctorliste ce qui est installé et donne la commande pour le reste. - La construction échoue sur un fichier manquant sous
code/: vérifiez que lefilepathcommence par le nom choisi dansplugin_arg, et quegitpeut cloner l'URL (un dépôt privé demande vos identifiants git). - Une valeur Jinja s'affiche telle quelle dans le menu : gardez
{{ ... }}hors des titres=.
Ensuite : mettez-le en ligne, ou ajoutez des slides pour les cours magistraux.
