LHTML+ lhtml-site

Installer

Il vous faut : un terminalDurée : environ 2 minutes

lhtml-site est un programme Python. Il installe LHTML avec lui.

1. Python et pipx

Il vous faut Python 3.11 ou plus récent (python.org) et pipx, qui installe les commandes écrites en Python, chacune dans son propre environnement :

Système Installer pipx
macOS, avec Homebrew brew install pipx
macOS, sans Homebrew python3 -m pip install --user pipx
Debian, Ubuntu sudo apt install pipx
Windows py -m pip install --user pipx

Lancez ensuite pipx ensurepath (macOS sans Homebrew : python3 -m pipx ensurepath ; Windows : py -m pipx ensurepath), puis ouvrez un nouveau terminal.

2. lhtml-site

pipx install lhtml-site
lhtml-site --version

La seconde ligne affiche quelque chose comme lhtml-site 1.1.0 (LHTML 3.0.3).

3. Vérifier l'installation

lhtml-site doctor

liste ce qui est prêt. La ligne HTML pages and slides doit indiquer ready : vous pouvez continuer. Les autres lignes sont des fonctionnalités optionnelles (l'export PDF, les formules rendues à la construction, les vidéos) ; chacune dit ce qui lui manque encore, et elles peuvent attendre.

Plus tard, pipx upgrade lhtml-site le met à jour. Le paquet et ses versions : lhtml-site sur PyPI.

En cas de problème
  • pipx: command not found : installez d'abord pipx (étape 1).
  • lhtml-site: command not found après l'installation : lancez pipx ensurepath, puis ouvrez un nouveau terminal.
  • requires a different Python pendant l'installation : pipx utilise un Python antérieur à la 3.11. Installez-en un plus récent, puis indiquez-le : pipx install --python python3.12 lhtml-site.
  • Autre chose : lancez lhtml-site doctor et lisez ce qu'il signale comme manquant.

LHTML seul ?

Pour convertir des pages isolées, ou pour utiliser LHTML depuis votre propre code Python, installez le balisage seul :

pipx install lhtml-markup      # la commande lhtml

et, dans un projet Python, python -m pip install lhtml-markup dans son environnement virtuel, puis import lhtml. Le paquet s'appelle lhtml-markup sur PyPI, la commande et le module lhtml : lhtml-markup sur PyPI.

Ensuite, une première page, vos propres balises, Python et Jinja2 : Utiliser LHTML seul.

Optionnel : colorer LHTML dans VS Code

N'importe quel éditeur de texte convient. Si vous utilisez Visual Studio Code, l'extension LHTML colore les marques de LHTML (titres, éléments de liste, gras, blocs ::) et le HTML autour, replie les blocs et propose des extraits de code (snippets). Vous pouvez vous en passer et y revenir plus tard.

Une slide écrite en LHTML, colorée dans VS Code
Une slide dans VS Code avec l'extension LHTML
Comment l'installer (il faut git et Node.js)

L'extension n'est pas encore sur le Marketplace de VS Code : elle se construit depuis le dépôt de LHTML.

git clone https://github.com/drohmer/lhtml.git
cd lhtml/editors/vscode
npx @vscode/vsce package
code --install-extension lhtml-*.vsix

Elle s'applique aux fichiers *.l.html et aux pages index.html.j2 d'un projet lhtml-site. Son README (en anglais) détaille ce qu'elle colore et comment l'appliquer à d'autres fichiers.

Suite : vos premières slides.

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