LHTML+ lhtml-site

Liens et images

Liens

LHTML
Voir link::https://scholartools.fr[ScholarTools] pour d'autres outils.
Résultat
HTML produit
Voir <a href="https://scholartools.fr">ScholarTools</a> pour d'autres outils.

L'URL vient juste après link::, le libellé entre crochets. Le libellé peut contenir du gras, de l'italique ou du code en ligne ; sans libellé, le lien affiche son URL :

Un lien sans libellé, un libellé en gras
LHTML
link::https://example.org
ou link::https://example.org[un libellé en **gras**]
Résultat
HTML produit
<a href="https://example.org">https://example.org</a>
ou <a href="https://example.org">un libellé en <strong>gras</strong></a>

Une classe se place entre parenthèses après l'URL : link::page.html(.nav)[Retour à l'accueil]. Un lien vers une partie de la page s'écrit link::#exercise[...] (voir Classes et id).

Images

Une image, sa largeur dans le style
LHTML
img::https://scholartools.fr/favicon.svg[width:64px;]
Résultat
HTML produit
<img style="width:64px;" src="https://scholartools.fr/favicon.svg" alt="https://scholartools.fr/favicon.svg">

Un chemin relatif, comme img::assets/photo.jpg, part de la page. Le texte alt, lu par les lecteurs d'écran et affiché quand l'image manque, est par défaut le chemin de l'image. Donnez-en un meilleur sous forme d'attribut :

Une image et son texte alt
LHTML
img::https://scholartools.fr/favicon.svg[width:64px;]{alt="Le logo de ScholarTools"}
Résultat
HTML produit
<img style="width:64px;" alt="Le logo de ScholarTools" src="https://scholartools.fr/favicon.svg">

Une image comme lien

Placez l'image dans le libellé du lien : un clic sur l'image ouvre la page.

Une image cliquable
LHTML
link::https://scholartools.fr[img::https://scholartools.fr/favicon.svg[width:48px;]{alt="ScholarTools"}]
Résultat
HTML produit
<a href="https://scholartools.fr"><img style="width:48px;" alt="ScholarTools" src="https://scholartools.fr/favicon.svg"></a>

Vidéos

video:: affiche une vidéo sans ses boutons : ajoutez l'attribut controls pour la lancer et la mettre en pause.

Une vidéo avec ses boutons
LHTML
video::https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4[width:320px;]{controls}
Résultat
HTML produit
<video controls style="width:320px;">
	<source src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4" type="video/mp4">
	 Cannot play video https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4
</video>

Une affiche (poster), l'image montrée avant le début de la vidéo, est aussi un attribut : video::clip.mp4{controls poster="clip.jpg"}. LHTML n'en cherche pas : écrivez-la.

videoplay se lance toute seule, en boucle et sans le son : la forme adaptée à une animation dans une slide.

Une animation
LHTML
videoplay::https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4[width:320px;]
Résultat
HTML produit
<video autoplay loop muted playsinline style="width:320px;">
	<source src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4" type="video/mp4">
	 Cannot play video https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4
</video>

Tous les navigateurs ne lisent pas tous les formats. lhtml-site peut convertir les vidéos : indiquez cache_video_directory: dans configure.yaml, et la construction produit les variantes des vidéos du dossier assets/ de chaque page, chacune ajoutée comme <source> de sa vidéo. lhtml-site doctor indique si les outils nécessaires sont installés.

Suivant : Code. Toutes les règles : Référence de la syntaxe.

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