LHTML+ lhtml-site

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 build produit 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 --layout ouvre 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.md dit ce qui est résolu et ce qui a bougé.
  • lhtml-site --lint liste 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 slides de 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.

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