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.
slides.pdf et une image de chaque slide1. 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]", puispython -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 doctorn'indique pas ready : lancez la commande qu'elle affiche. - Sous Linux, Chromium ne démarre pas (une bibliothèque
.somanquante) :playwright install-deps chromium. - Une slide est coupée dans le PDF : elle déborde aussi dans le navigateur ;
lhtml-site --layoutliste dans.layout/les blocs qui sortent de la slide (Vérifier vos slides automatiquement). theme:ettargets:ensemble sont une erreur : n'en gardez qu'un.
Ensuite : mettre en ligne les slides et le PDF.