Classes et id
Une classe nomme une sorte d'élément : une remarque, un avertissement, un bouton. Un id
nomme un élément précis de la page, pour y faire un lien ou pour un script. En LHTML, les deux
s'écrivent entre parenthèses juste après le :: d'un élément (ou le = d'un titre), comme en
CSS : . devant une classe, # devant un id.
::(.note) une classe ::(.note .warning) deux classes ::(.note.warning) la même chose, collée ::(#tip) un id ::(.note #tip) une classe et un id
L'apparence d'une classe se définit dans une feuille de style. Les exemples de cette page
apportent leur propre <style> : c'est du HTML, donc LHTML le garde tel quel. Dans lhtml-site, la
feuille de style a sa place à elle (plus bas).
Une remarque, puis un avertissement
<style>
.note { border-left: 4px solid #2f6fdb; background: #eef4ff; padding: 6px 12px; margin: 6px 0; }
.warning { border-color: #d97706; background: #fff7e6; }
</style>
::(.note)
Une remarque : la classe lui donne son apparence.
::
::(.note .warning)
Un avertissement : une remarque, avec une deuxième classe qui change ses couleurs.
::HTML produit
<style>
.note { border-left: 4px solid #2f6fdb; background: #eef4ff; padding: 6px 12px; margin: 6px 0; }
.warning { border-color: #d97706; background: #fff7e6; }
</style>
<div class="note">
Une remarque : la classe lui donne son apparence.
</div>
<div class="note warning">
Un avertissement : une remarque, avec une deuxième classe qui change ses couleurs.
</div>Deux classes s'additionnent : .warning ne dit que ce qui change par rapport à .note.
Sur un titre
<style> .centered { text-align: center; color: #b4232c; } </style>
=(.centered) Sphères rebondissantes
==(#method) La méthodeHTML produit
<style> .centered { text-align: center; color: #b4232c; } </style>
<h1 class="centered">Sphères rebondissantes</h1>
<h2 id="method">La méthode</h2>Le groupe d'un titre vient juste après son =, avant l'espace.
Un id, et un lien vers lui
link::#exercise[Aller à l'exercice]
==(#exercise) Exercice
Calculer l'instant du premier rebond.HTML produit
<a href="#exercise">Aller à l'exercice</a>
<h2 id="exercise">Exercice</h2>
Calculer l'instant du premier rebond.L'id nomme l'endroit, et link::#exercise[...] y mène. Un id est unique dans sa page. Dans
lhtml-site, chaque titre reçoit déjà un id tiré de son texte ; écrivez-en un à la main pour une
ancre courte, qui ne change pas quand le titre change.
Dans une phrase : un span
<style>
.key { font: 13px ui-monospace, monospace; border: 1px solid #bbb; border-bottom-width: 3px;
border-radius: 4px; padding: 0 4px; }
</style>
Appuyez sur span::(.key)Ctrl:: + span::(.key)S:: pour enregistrer.HTML produit
<style>
.key { font: 13px ui-monospace, monospace; border: 1px solid #bbb; border-bottom-width: 3px;
border-radius: 4px; padding: 0 4px; }
</style>
Appuyez sur <span class="key">Ctrl</span> + <span class="key">S</span> pour enregistrer.Sur un lien ou une image
Le groupe vient après l'URL :
<style>
.button { display: inline-block; background: #2f6fdb; color: #fff; padding: 6px 14px;
border-radius: 6px; text-decoration: none; }
.round { border-radius: 50%; object-fit: cover; }
</style>
link::https://example.org(.button)[Chapitre suivant →]
img::../../assets/img/slide-title.jpg(.round)[width:110px; height:110px;]HTML produit
<style>
.button { display: inline-block; background: #2f6fdb; color: #fff; padding: 6px 14px;
border-radius: 6px; text-decoration: none; }
.round { border-radius: 50%; object-fit: cover; }
</style>
<a class="button" href="https://example.org">Chapitre suivant →</a>
<img class="round" style="width:110px; height:110px;" src="../../assets/img/slide-title.jpg" alt="../../assets/img/slide-title.jpg">Classe, style et attributs ensemble
Les trois groupes se suivent dans cet ordre : (...) les classes et l'id, [...] le style,
{...} les autres attributs.
<style> .card { border: 1px solid #ddd; border-radius: 8px; padding: 8px 12px; } </style>
::(.card #week-1)[max-width:320px;]{data-week="1"}
**Semaine 1** : splines et images clés
::HTML produit
<style> .card { border: 1px solid #ddd; border-radius: 8px; padding: 8px 12px; } </style>
<div class="card" id="week-1" style="max-width:320px;" data-week="1">
<strong>Semaine 1</strong> : splines et images clés
</div>Une classe pour ce que plusieurs éléments partagent, un style pour un ajustement ponctuel, des
attributs pour le reste (title, target, data-...).
Quels éléments prennent un groupe
| Élément | Exemple |
|---|---|
Un bloc, div:: ou :: |
::(.note) ... :: |
| Un span | span::(.key)Ctrl:: |
| Un titre | ==(#method) La méthode |
| Un lien | link::page.html(.button)[Suivant] |
| Une image, une vidéo | img::photo.jpg(.round), videoplay::clip.mp4(.wide) |
| Une macro | note::(.important) ... :: : sa classe et celle-ci s'additionnent |
Les autres éléments HTML prennent leur classe en HTML, comme d'habitude : <p class="lead">,
<ul class="checklist">, <table class="results">. Un nom devant :: est une balise intégrée
(div, span, link, img, video, videoplay) ou l'une de vos macros : p:: ou article::
restent du texte. Un élément de liste * ne prend pas de groupe : pour une liste stylée, mettez-la
dans un bloc (::(.checklist) ... ::) et stylez .checklist li dans la feuille de style.
Dans lhtml-site : où mettre le CSS
Deux endroits, du plus partagé au plus local :
-
Une macro, dans
configure.yaml: sa classe et son CSS ensemble, écrits dans le site pour toutes les pages.note::remplace alors::(.note)(Vos propres balises : les macros).design: macros: note: class: note css: '.note { border-left: 4px solid #2f6fdb; background: #eef4ff; padding: 6px 12px; }'
-
La page elle-même : un
<style>en haut de la page, ou un<link rel="stylesheet" href="...">. C'est du HTML, comme dans les exemples ci-dessus.
Avec LHTML seul, une macro n'a pas de CSS (la commande lhtml rejette le champ css) : le CSS va
dans une feuille de style donnée avec --css style.css, ou dans un <style> de la page.
Suivant : Liens et images. Toutes les règles : Référence de la syntaxe.