Liens et images
Liens
Voir link::https://scholartools.fr[ScholarTools] pour d'autres outils.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 :
link::https://example.org
ou link::https://example.org[un libellé en **gras**]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
img::https://scholartools.fr/favicon.svg[width:64px;]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 :
img::https://scholartools.fr/favicon.svg[width:64px;]{alt="Le logo de ScholarTools"}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.
link::https://scholartools.fr[img::https://scholartools.fr/favicon.svg[width:48px;]{alt="ScholarTools"}]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.
video::https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4[width:320px;]{controls}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.
videoplay::https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4[width:320px;]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.