lhtml-site, reveal.js ou Quarto ?
Beaucoup d'outils transforment du texte en slides, et tous montrent un exposé dans un navigateur ou en PDF. Ils diffèrent moins par les effets à l'écran, que des extensions peuvent ajouter, que par la manière dont les slides sont rangées, écrites et vérifiées. lhtml-site est fait pour des slides qui vivent des années : reprises d'un exposé à l'autre, écrites à plusieurs, et vérifiées avant d'être montrées, par vous ou par un agent d'IA.
En un coup d'œil
| lhtml-site | La plupart des autres outils | Ce que vous y gagnez | |
|---|---|---|---|
| Une slide est | un répertoire : son texte, ses images, ses réglages | une partie d'un fichier par exposé | copier une slide dans un autre exposé, la reprendre d'une année sur l'autre |
| On écrit | du LHTML : du HTML et du CSS, en plus court | du Markdown, avec le HTML en exception | tout le HTML et le CSS, sans leur longueur |
| Le résultat | une page HTML brute par slide, lisible sans JavaScript | une page, ou une application, montrée par JavaScript | elle s'ouvre partout, est indexée et liée, et dure |
| À installer | uniquement Python | Node.js, une commande à part, ou LaTeX | un seul pipx install ; des figures calculées en Python |
| À plusieurs | un fichier par slide | un fichier par exposé | des diffs courts, aucun conflit dans git |
| La vérification | chaque slide mesurée, les valeurs écrites à la main listées | à l'œil | les problèmes trouvés avant l'exposé, par vous ou par un agent d'IA |
Les sections ci-dessous détaillent chaque ligne. Un autre outil peut mieux convenir à votre cas : voyez Quand choisir lequel, en fin de page.
1. Une slide, un répertoire
Chaque slide est un répertoire : sa source, ses images et vidéos, et ses réglages.
src/
03_ik/
index.html.j2 la slide
config.yaml ses réglages, comme les crédits de ses images
assets/
arm.mp4
chain.svg
Pour reprendre une slide dans un autre exposé, copiez son répertoire : rien ne reste derrière.
Sans copie, un deck (deck.yaml) peut aussi lister des slides d'autres projets, montrer deux fois
la même slide avec d'autres paramètres, et prévoir des slides qui n'existent pas encore. Corrigez
une slide une fois, et tous les exposés qui la montrent ont la correction.
Les autres outils rangent un exposé dans un fichier. Ils peuvent en charger une partie depuis un
autre fichier (le Markdown de reveal.js, src: dans Slidev, include dans Quarto, \input dans
Beamer), mais les images restent là où on les a mises, et ce que l'on déplace est un morceau de
texte, pas une slide.
2. Le HTML et le CSS, écrits nativement
LHTML part du HTML : ce que vous écrivez est du HTML, et seuls quelques symboles sont lus et
raccourcis. Une classe, un style ou un attribut se met sur n'importe quel bloc, span ou image en
une ligne, et une ligne de HTML brut, un <style> ou un <script> est gardé tel quel. Rien à
apprendre pour aller au-delà de la syntaxe : c'est le HTML et le CSS que vous connaissez.
Le texte à gauche, une figure à droite. Dans reveal.js, les colonnes s'écrivent en HTML et CSS :
<section> <h2>Cinématique directe</h2> <div style="display:flex; gap:40px;"> <ul style="flex:1;"> <li>Chaque angle d'articulation est réglé à la main</li> <li>Les rotations sont interpolées</li> </ul> <img src="fk.jpg" style="flex:1; max-width:50%;"> </div> </section>
Dans lhtml-site, la mise en page side du thème les place, et la figure est ajustée à sa colonne :
{% set layout = 'side' %}
= Cinématique directe
* Chaque angle d'articulation est réglé à la main
* Les rotations sont interpolées
media::
img::assets/fk.jpg
::
Et quand le thème n'a pas de mise en page pour ce que vous voulez, le HTML reste là : un bloc ouvert par
::[display:flex; gap:40px;] et fermé par ::. Les outils fondés sur Markdown acceptent aussi le HTML, mais comme
une exception : le Markdown à l'intérieur d'un bloc HTML n'est lu qu'entre des lignes vides.
LHTML ou Markdown ? compare les deux en détail.
3. Du HTML brut en résultat
Chaque slide est construite en sa propre page HTML, avec son adresse et son titre. Le texte, les
listes, les images et les formules sont écrits dans cette page (les formules sont rendues par
KaTeX à la construction quand quickjs est installé, sinon dans le navigateur). Le JavaScript ne
fait que passer d'une slide à la suivante, ouvrir le menu et mettre la slide à l'échelle de
l'écran : quatre petits scripts, 8,5 Ko en tout. Avec JavaScript désactivé, la slide s'affiche en
entier, formules comprises quand elles sont rendues à la construction.
- Compatible : n'importe quel navigateur l'affiche, et n'importe quel serveur web l'héberge : GitHub Pages, le serveur de votre université, un dossier ouvert depuis le disque.
- Indexé et lié : chaque slide a sa propre adresse et son propre
<title>. Un moteur de recherche trouve la slide sur la cinématique inverse ; un courriel renvoie à la slide 12. - Simple, et durable : le résultat est du HTML et du CSS que l'on peut lire, sans application à faire tourner. Il s'ouvrira dans dix ans comme il s'ouvre aujourd'hui.
Les autres font d'autres choix :
- reveal.js : l'exposé est une seule page HTML, chaque slide en est une
<section>, montrée en slides par son JavaScript (Reveal.initialize()) ; son Markdown est lu par une extension JavaScript au chargement de la page. - Slidev :
slidev buildproduit une application d'une seule page (SPA) en JavaScript ; les slides y ont leurs propres chemins. - Quarto : ses slides HTML sont une présentation reveal.js.
- Marp : le plus proche de lhtml-site sur ce point. Son HTML est statique, du HTML et du CSS, avec un gabarit sans JavaScript ; mais tout l'exposé tient dans un seul fichier.
4. Uniquement Python
pipx install lhtml-site, et tout l'outil est là : pas de Node.js, pas de npm install, pas de
node_modules dans le projet. L'export PDF et le rapport de mise en page téléchargent Chromium une
fois ; les formules rendues à la construction ajoutent pipx inject lhtml-site quickjs. Marp et Slidev tournent sur Node.js (Marp a aussi un binaire autonome) ; Quarto est une
commande à part ; Beamer demande LaTeX. reveal.js ne demande rien pour montrer un exposé, et
Node.js pour le développer.
5. Des figures calculées en Python
Être en Python ne sert pas qu'à l'installation : une figure peut être un script Python à côté de sa slide, exécuté par la construction.
assets/ plot.svg.py écrit plot.svg, avec matplotlib ou numpy diagram.svg.tex une figure TikZ, compilée en diagram.svg
Changez le script ou un fichier à côté de lui, et la construction suivante refait la figure (pour
des données lues ailleurs, effacez .figures/). Quarto va
plus loin sur ce point : il exécute le code de tout le document et y met ses résultats.
6. Fait pour git et pour le travail à plusieurs
Une slide est un fichier : la modification d'une slide est un diff court et lisible, et deux
auteurs qui modifient deux slides ne touchent pas au même fichier, donc n'ont aucun conflit à
résoudre. L'ordre de l'exposé est dans deck.yaml, à part des slides. Avec un fichier par exposé,
chaque modification touche ce fichier, et deux personnes qui le modifient en même temps doivent
souvent le fusionner à la main. Découper un exposé en fichiers est possible ailleurs, à la main ;
ici, c'est la manière dont un projet est fait.
7. Un design vérifié automatiquement, prêt pour un agent d'IA
Les thèmes de slides ont un design : des mises en page (side, stack, section), des macros
(gap::, small::, media::) et des tokens. Une slide dit ce qu'elle montre, le thème décide
où ; un exposé de 80 slides reste cohérent, et un changement du thème les atteint toutes. Deux
commandes le vérifient :
lhtml-site --layoutouvre chaque slide dans un vrai navigateur, mesure ce qui est dessiné, et liste ce qui ne va pas : un texte caché sous une figure, deux blocs l'un sur l'autre, un bloc qui dépasse, une image agrandie au point d'être floue, une étiquette de figure barrée par un trait. Chaque constat donne la ligne de la source à modifier ; après une modification,changes.mddit ce qui est résolu et ce qui a bougé.lhtml-site --lintliste chaque taille ou position écrite à la main, avec la macro ou la mise en page qui la remplace.
Les autres outils ne documentent pas de telle vérification : reveal.js met chaque slide à l'échelle
de l'écran, Quarto propose .smaller et .scrollable à appliquer à la main, LaTeX avertit des
boîtes trop pleines. On vérifie à l'œil, slide par slide.
C'est ce qui rend lhtml-site adapté à un agent d'IA. Un agent qui écrit des slides ne les voit
pas : ici, il les mesure et lit le résultat. Chaque construction écrit la procédure pour lui
(.structure/agents.md), le design de votre thème (design.md), et le rapport sous une forme
qu'un programme lit ; vos commentaires sur une slide dans le navigateur (lhtml-site --serve)
donnent le fichier et la ligne du bloc. L'agent modifie, mesure de nouveau, et s'arrête quand le
rapport est propre. Slidev a un serveur MCP par lequel un agent lit et modifie les slides ; il ne
les mesure pas. Vérifier vos slides automatiquement montre
toute la boucle sur une vraie slide.
Aussi : les mêmes sources se construisent en slides dans le navigateur et en PDF en une commande, et le même outil fait le site du cours autour d'elles, ou un site de documentation comme celui-ci. Quarto partage cette idée ; reveal.js, Marp et Slidev font des exposés.
Ce que les autres font mieux
- Présenter. reveal.js, Slidev et l'export HTML de Marp ont une vue orateur, des apparitions
progressives et des transitions entre slides, et reveal.js et Slidev de nombreuses extensions. Le
thème
slidesde lhtml-site montre une slide à la fois, avec les flèches, la molette ou un glissement du doigt, et un menu. - La maturité. reveal.js est très utilisé ; Quarto est fait par Posit. lhtml-site est jeune et a un seul mainteneur.
- Exécuter du code. Quarto exécute le code d'un document (Python, R, Julia) et y met ses tableaux et ses graphiques, avec citations et renvois.
- PowerPoint. Marp, Quarto et Slidev exportent en
.pptx. lhtml-site exporte en HTML et en PDF.
Côte à côte
| reveal.js | Quarto | Marp | Slidev | Beamer | lhtml-site | |
|---|---|---|---|---|---|---|
| Une slide est | une <section> de la page |
une partie du fichier .qmd |
une partie du fichier Markdown | une partie du fichier Markdown, ou un fichier importé avec src: |
une frame du fichier .tex |
un répertoire, avec ses images et ses réglages |
| On écrit | du HTML, ou du Markdown | du Markdown | du Markdown | du Markdown et du Vue | du LaTeX | du LHTML (du HTML et du CSS, en plus court), ou du Markdown |
| Le résultat en HTML | une page, montrée par JavaScript | une page reveal.js | un fichier HTML statique pour l'exposé | une application JavaScript (SPA) | aucun (PDF) | une page HTML par slide, lisible sans JavaScript |
| À installer | rien pour montrer ; Node.js pour développer | la commande quarto |
Node.js, ou un binaire | Node.js | LaTeX | Python |
| Mise en page vérifiée automatiquement | non | non | non | non | avertissements de boîtes trop pleines | oui, avec la ligne à corriger |
| Valeurs écrites à la main listées | non | non | non | non | non | oui (--lint) |
| Pour un agent d'IA | non | non | non | un serveur MCP, pour lire et modifier | non | un guide à chaque construction, et le rapport mesuré |
Les outils se combinent aussi : Quarto fait ses slides HTML avec reveal.js, et une page de lhtml-site peut contenir n'importe quel HTML ou JavaScript, une présentation reveal.js comprise.
Quand choisir lequel
| Votre cas | L'outil qui convient |
|---|---|
| Un exposé, avec des transitions et des apparitions progressives | reveal.js, Slidev |
| Des slides depuis du Markdown en deux minutes, aussi en PowerPoint | Marp |
| Un document qui exécute du code et cite une bibliographie | Quarto |
| Des co-auteurs qui n'écrivent qu'en LaTeX, un PDF attendu | Beamer |
| Un cours : des slides reprises d'un exposé à l'autre et d'une année sur l'autre | lhtml-site |
| Des slides écrites à plusieurs, ou par un agent d'IA, et vérifiées automatiquement | lhtml-site |
Suite : les recettes, d'un répertoire vide jusqu'au résultat, ou installer lhtml-site.