Votre premier site web
Un site web est un nouveau projet, à côté de votre présentation, avec ses propres pages. Elles s'écrivent dans le même LHTML que les slides ; le thème leur donne un menu au lieu d'une mise en page de slide.
1. Un site web avec un menu
lhtml-site init my-site cd my-site lhtml-site --serve --watch
construit le site et le sert : ouvrez http://127.0.0.1:8000/ dans votre navigateur. Comme pour les slides, chaque enregistrement reconstruit le site ; rafraîchissez la page pour voir la modification, et appuyez sur Ctrl+C pour arrêter.
Ouvrez src/01_welcome/index.html.j2 dans votre éditeur, modifiez son texte, enregistrez et
rafraîchissez. Pour ajouter une page, dupliquez l'un des dossiers de src/, comme pour une slide.
Le thème est webpage-frame : un menu de navigation, des pages de toute longueur, adapté à un cours.
2. Un site de documentation
lhtml-site init my-docs --theme docs
produit un site comme celui-ci : une barre supérieure avec une recherche, un menu par section et par
groupe, « Sur cette page », page précédente et suivante, modes clair et sombre. Ses pages de départ
sont en Markdown (index.md.j2) ; une page en LHTML (index.html.j2) fonctionne tout aussi bien.
La recherche a besoin d'un index, construit après le site : voir
Mettre en ligne.
Chaque page indique sa place dans le menu dans son en-tête YAML (front matter), en haut du fichier :
--- title: Dessiner un maillage section: Guides pratiques group: Formes ---
Changer de thème
Le thème est la ligne theme: de configure.yaml :
| Thème | Pour |
|---|---|
webpage-frame |
Des pages web avec un menu de navigation : un cours |
docs |
Un site de documentation avec une recherche |
slides |
Des slides dans le navigateur |
slides-pdf |
Les mêmes slides, en PDF |
slides et slides-pdf lisent les mêmes pages : passez de l'un à l'autre à tout moment. En
revanche, une présentation ne devient pas un site web en changeant de thème : ses slides utilisent
des macros du thème slides (cols::, media::, box::...) que les thèmes de site web n'ont
pas. Pour un site web, créez un nouveau projet comme ci-dessus, et recopiez-y le texte dont vous
avez besoin.

webpage-frame : le site de départ de lhtml-site init
docs : le projet de départ de lhtml-site init --theme docsChaque image ouvre le vrai site : le site de départ, et le projet de départ du thème docs, recherche comprise.
Suite : apprendre LHTML, une courte page par notion.