LHTML+ lhtml-site

Un exposé avec des vidéos

Les vidéos sont le point faible des outils de slides habituels. Dans lhtml-site, une vidéo tient en une ligne.

Il vous faut : lhtml-site installé ; en option, ffmpeg pour convertir les vidéos (étape 3)Durée : 20 minVous obtenez : des slides dans le navigateur, dans .site/, avec des vidéos lues par tous les navigateurs

Ce que vous obtiendrez

Une slide avec du texte à gauche et une figure à droite
La mise en page side : le texte à gauche, la figure ou la vidéo à droite. Cliquez pour ouvrir l'exposé de départ, et avancez avec les flèches du clavier.

1. Créer l'exposé

lhtml-site init my-talk --theme slides
cd my-talk

init écrit quatre slides pour démarrer, de src/01_title/ à src/04_image/. Une slide est un répertoire de src/ ; ajoutez-en un pour la vidéo, avec la vidéo à côté, dans assets/ :

my-talk/
  configure.yaml
  src/
    01_title/ ... 04_image/
    05_ik/index.html.j2
    05_ik/assets/ik.mp4

2. Une slide avec une vidéo

Dans src/05_ik/index.html.j2 :

---
layout: side
---
= Cinématique inverse

* Décrire la position des effecteurs terminaux
* Calculer les angles des articulations

media::
videoplay::assets/ik.mp4
credit:: Animation : MiloScerny ::
::

Construisez avec lhtml-site et ouvrez .site/index.html : la vidéo se lance sur la cinquième slide.

  • Les lignes entre --- tout en haut forment l'en-tête YAML de la slide (front matter) : layout: side place le texte à gauche et la vidéo à droite, ajustée à la colonne, sans largeur à écrire. Les slides de départ font le même choix avec {% set layout = 'side' %} sur leur première ligne ; les deux formes fonctionnent, prenez celle que vous voulez.
  • media:: ... :: contient les figures que la mise en page place et dimensionne ; credit:: ... :: est la petite légende en dessous. Ce sont deux macros des thèmes de slides : voyez Ce qu'apportent les thèmes de slides.
  • videoplay:: se lance tout seul, en boucle, sans son : la forme adaptée à une animation. video:: ne se lance pas tout seul et n'affiche pas de boutons : écrivez video::assets/ik.mp4{controls} pour une vidéo que vous lancez vous-même (Liens et images).

3. Des vidéos lisibles par tous les navigateurs

Une vidéo tout droit sortie d'un téléphone ou d'un logiciel de capture d'écran utilise souvent un codec que certains navigateurs ne lisent pas : un iPhone filme en HEVC (H.265), que Safari lit et que beaucoup de navigateurs sous Windows ou Linux ne lisent pas. lhtml-site peut faire deux copies de chaque vidéo, une fois pour toutes : un WebM (VP9) et un MP4 (H.264). Le navigateur choisit alors celle qu'il sait lire.

Dans configure.yaml, retirez le # devant cette ligne :

cache_video_directory: 'cache_video/'

La conversion a besoin de ffmpeg (brew install ffmpeg sur macOS, sudo apt install ffmpeg sur Debian ou Ubuntu) et de ffpb, une barre de progression pour ffmpeg :

  • lhtml-site installé avec pipx : pipx inject --include-apps lhtml-site ffpb ;
  • installé avec pip, dans un environnement virtuel : pip install ffpb dans cet environnement.

La ligne Videos in several codecs de lhtml-site doctor indique ready quand les deux sont trouvés.

La construction produit alors les copies manquantes de chaque vidéo, les garde dans cache_video/, et chaque vidéo reçoit une <source> par copie. Les constructions suivantes réutilisent le cache : une vidéo n'est convertie qu'une fois. La construction lit les fichiers .mp4, .webm et .mkv ; convertissez d'abord un .mov, par exemple ffmpeg -i clip.mov clip.mp4.

4. Une image d'affiche

L'image affichée avant le début de la vidéo est un attribut :

video::assets/ik.mp4{controls poster="assets/ik.jpg"}

ffmpeg en tire une de la première image de la vidéo : ffmpeg -i assets/ik.mp4 -frames:v 1 assets/ik.jpg, dans le répertoire de la slide.

5. Des mises en page pour les vidéos

Mise en page Pour
side le texte à gauche, la vidéo à droite
stack le texte, puis la vidéo en dessous, aussi grande que la slide le permet
stack avec media::(.row) plusieurs vidéos côte à côte

Pour deux vidéos côte à côte :

---
layout: stack
---
= Deux allures

media::(.row)
videoplay::assets/walk.mp4
videoplay::assets/run.mp4
::

6. Présenter l'exposé

Ouvrez .site/index.html dans le navigateur : il fonctionne depuis le disque, sans réseau ni serveur. Vous pouvez donc copier .site/ sur une clé USB ou sur l'ordinateur de la salle. Une slide qui montre une page web chargeant ses propres fichiers (un modèle 3D, une démo) demande un serveur : lhtml-site --serve (Un modèle 3D dans une slide).

  • Slide suivante : flèche droite ou bas, la molette de la souris, ou un glissement du doigt sur un écran tactile. Slide précédente : flèche gauche ou haut.
  • Plein écran : le plein écran du navigateur, F11 sous Windows et Linux, Ctrl+Cmd+F sous macOS (Échap pour en sortir).
  • Aller à une slide : cliquez sur le menu en haut de la slide pour afficher la liste des slides.

En cas de problème

  • La vidéo reste noire ou absente dans un navigateur : son codec n'y est pas lu ; activez cache_video_directory (étape 3) et reconstruisez.
  • lhtml-site doctor n'indique pas ready pour les vidéos : installez ce qu'il nomme (ffmpeg, ffpb).
  • Du texte ou une figure dépasse en bas de la slide : lhtml-site --layout écrit dans .layout/ un rapport des blocs qui débordent ou se chevauchent (il demande l'export PDF installé, voyez la recette suivante ; pour le lire : Vérifier vos slides automatiquement).

Ensuite : le même exposé en PDF, où chaque vidéo est représentée par l'une de ses images, ou la mise en ligne.

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