LHTML+ lhtml-site

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

Une classe, puis deux
LHTML
<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.
::
Résultat
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

Un titre centré, et une section avec un id
LHTML
<style> .centered { text-align: center; color: #b4232c; } </style>
=(.centered) Sphères rebondissantes
==(#method) La méthode
Résultat
HTML 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

Un lien vers une partie de la page
LHTML
link::#exercise[Aller à l'exercice]

==(#exercise) Exercice
Calculer l'instant du premier rebond.
Résultat
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

Des touches du clavier
LHTML
<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.
Résultat
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 :

Un bouton, une image ronde
LHTML
<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;]
Résultat
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.

Les trois
LHTML
<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
::
Résultat
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.

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