LHTML+ lhtml-site

Vos slides en PDF

Pour les organisateurs d'une conférence, pour les étudiants, ou pour imprimer : les mêmes slides, en PDF. Cette recette part d'un exposé, comme celui que crée lhtml-site init my-talk --theme slides. Pour un cours en plusieurs jeux de slides, un par chapitre, voyez Un cours en plusieurs chapitres à la fin.

Il vous faut : lhtml-site installé ; Playwright et son Chromium, environ 200 Mo, téléchargés une fois (étape 1)Durée : 10 minVous obtenez : slides.pdf et une image de chaque slide

1. Installer l'export PDF, une fois

L'export pilote Chromium à travers Playwright : deux paquets Python et un navigateur, sans Node.js. Après pipx install lhtml-site :

pipx inject lhtml-site pypdf
pipx inject --include-apps lhtml-site playwright
playwright install --only-shell chromium
lhtml-site doctor

La ligne PDF export de lhtml-site doctor indique ready quand tout est trouvé ; sinon, elle donne la commande à lancer.

  • Chromium est téléchargé une fois, environ 200 Mo.
  • Dans un environnement virtuel plutôt qu'avec pipx : pip install "lhtml-site[pdf]", puis python -m playwright install --only-shell chromium.
  • Sous Linux, Playwright peut aussi demander les bibliothèques système de Chromium : playwright install-deps chromium.

2. Changer de thème

Dans configure.yaml, remplacez la ligne theme: 'slides' par :

theme: 'slides-pdf'

lhtml-site écrit alors slides.pdf, et images/ avec une image de chaque slide (slide_000.jpg, ..., 3840 px de large). Avec ce seul thème, les deux arrivent à côté de configure.yaml, pas dans .site/ : il n'y a pas de .site/ du tout. Quelques secondes pour quelques slides. Un exemple : le PDF de la présentation de départ.

L'export attend que chaque slide soit prête (polices, formules, images, une image de chaque vidéo) avant de l'imprimer. Avec ce thème, le HTML des slides n'est qu'une étape vers le PDF : remettez theme: 'slides' pour travailler sur les slides dans le navigateur, ou construisez les deux.

3. Les deux à chaque construction

Pour obtenir les slides dans le navigateur et le PDF avec une seule commande, retirez la ligne theme: et déclarez deux cibles à la place (theme: et targets: ensemble sont une erreur) :

targets:
  html: {theme: slides}
  pdf: {theme: slides-pdf}

Avec des cibles, tout arrive dans .site/ :

.site/html/index.html     les slides, dans le navigateur
.site/slides.pdf          le PDF
.site/images/             une image de chaque slide

lhtml-site --target html ne construit que les slides, pendant que vous écrivez.

Un cours en plusieurs chapitres

Un cours, c'est souvent plusieurs jeux de slides (des decks), un par chapitre, chacun voulu en slides et en PDF. Avec decks: directories, chaque répertoire de src/ devient un deck à part entière, construit pour chaque cible :

decks: directories        # src/01_procedural/, src/02_rigid/, ...
targets:
  html: {theme: slides}
  pdf: {theme: slides-pdf}
.site/01_procedural/html/index.html
.site/01_procedural/01_procedural.pdf
.site/01_procedural/images/

Chaque répertoire de chapitre contient ses slides en sous-répertoires (src/01_procedural/01_intro/, ...). lhtml-site --only 01_procedural reconstruit un seul chapitre. Plus de détails dans Decks and targets (en anglais).

En cas de problème

  • La ligne PDF export de lhtml-site doctor n'indique pas ready : lancez la commande qu'elle affiche.
  • Sous Linux, Chromium ne démarre pas (une bibliothèque .so manquante) : playwright install-deps chromium.
  • Une slide est coupée dans le PDF : elle déborde aussi dans le navigateur ; lhtml-site --layout liste dans .layout/ les blocs qui sortent de la slide (Vérifier vos slides automatiquement).
  • theme: et targets: ensemble sont une erreur : n'en gardez qu'un.

Ensuite : mettre en ligne les slides et le PDF.

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