LHTML+ lhtml-site

Votre premier site web

Il vous faut : lhtml-site installéDurée : environ 5 minutes

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 sites web sont des projets distincts

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.

Une page du thème webpage-frame
webpage-frame : le site de départ de lhtml-site init
Le projet de départ du thème docs
docs : le projet de départ de lhtml-site init --theme docs

Chaque 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.

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