LHTML+ lhtml-site

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.

Il vous faut : lhtml-site installé ; git pour l'étape 5Durée : 30 minVous obtenez : un site de cours avec un menu, dans .site/

Ce que vous obtiendrez

Une page d'un site de cours construit avec le thème webpage-frame
Un site du thème webpage-frame : le menu à gauche, une page par semaine. Cliquez pour l'ouvrir.

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

src/02_week-2/index.html.j2
LHTML
= 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>
Résultat
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 doctor liste ce qui est installé et donne la commande pour le reste.
  • La construction échoue sur un fichier manquant sous code/ : vérifiez que le filepath commence par le nom choisi dans plugin_arg, et que git peut 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.

Construit avec lhtml-site, thème docs. Fait partie de ScholarTools.