Écrivez vos slides et vos sites web de cours en texte brut
Écrivez quelques courts fichiers texte ; obtenez des slides dans le navigateur, un PDF ou un site web de cours avec un menu. LHTML est le balisage : quelques symboles pour les titres, les listes, le gras et les encadrés. lhtml-site est le programme qui transforme un dossier de telles pages en résultat. Aucune compétence en développement web n'est nécessaire.
Utilisé dans de vrais cours : des slides de cours, leurs PDF et des sites de TP à l'École polytechnique et à l'EPITA. Les voir →
Un texte, trois résultats
Une page est un court fichier texte. Les mêmes sources produisent, selon le thème :
Chaque image ci-dessus ouvre un exemple en direct. Ce site est lui-même construit avec lhtml-site, à partir de pages Markdown et LHTML.
En LHTML, tout ce que vous écrivez est du HTML. Seuls quelques symboles sont lus et
convertis : = pour les titres, * pour les listes, ** et __
pour le gras et l'italique, :: pour les blocs, les liens et les images. Tout le reste passe
tel quel : tout ce que permettent HTML, CSS et JavaScript reste à portée de main, une
<table>, une <video>, un <script>, votre propre feuille
de style. Vous ne perdez jamais la puissance du HTML ; vous en tapez simplement moins.
À quoi ressemble LHTML
Chaque exemple de ce site montre la source à côté de son résultat. Le résultat est calculé par LHTML à chaque construction du site : il correspond toujours à la version actuelle.
= Sphères rebondissantes
* **Objectif** : une sphère qui rebondit sur le sol
** Sa hauteur : \(z(t) = z_0 - \tfrac{1}{2} g t^2\)
** Elle touche le sol quand \(z(t) = 0\)
* __Indice__ : commencer par une seule sphère et un seul rebond
* Pour aller plus loin : link::https://fr.wikipedia.org/wiki/Chute_libre_(physique)[chute libre]HTML produit
<h1>Sphères rebondissantes</h1>
<ul>
<li>
<strong>Objectif</strong> : une sphère qui rebondit sur le sol
<ul>
<li>
Sa hauteur : \(z(t) = z_0 - \tfrac{1}{2} g t^2\)
</li>
<li>
Elle touche le sol quand \(z(t) = 0\)
</li>
</ul>
</li>
<li>
<em>Indice</em> : commencer par une seule sphère et un seul rebond
</li>
<li>
Pour aller plus loin : <a href="https://fr.wikipedia.org/wiki/Chute_libre_(physique)">chute libre</a>
</li>
</ul>Pourquoi pas Markdown ? Voir LHTML ou Markdown ?
Pourquoi pas reveal.js ? Voir lhtml-site, reveal.js ou Quarto ?
Deux outils, une même famille
| LHTML | lhtml-site | |
|---|---|---|
| Quoi | Le langage de balisage : du texte en entrée, du HTML en sortie | Le générateur : un dossier de pages en entrée, un site en sortie |
| Pour | Une page, ou du HTML dans votre propre outil Python | Des slides, un PDF, un site web de cours ou de documentation |
| Installation | pipx install lhtml-markup | pipx install lhtml-site (inclut LHTML) |
| Commencer | Utiliser LHTML seul | Premiers pas |
| Code | drohmer/lhtml | drohmer/lhtml-site |
| Paquet | lhtml-markup sur PyPI | lhtml-site sur PyPI |
Par où commencer
Une seule commande avec pipx, sous macOS, Linux ou Windows.
Quatre slides pour démarrer, dans votre navigateur, puis une slide à vous.
Un nouveau projet avec un menu, pour un cours ou un site de documentation.
Titres, listes, texte, blocs, liens, images et code, une courte page pour chacun.


