Installer
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.
pipx: command not found: installez d'abord pipx (étape 1).lhtml-site: command not foundaprès l'installation : lancezpipx ensurepath, puis ouvrez un nouveau terminal.requires a different Pythonpendant 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 doctoret 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.
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.
