LHTML+ lhtml-site

Blocs et styles

Le système :: est le cœur de LHTML. Il écrit un bloc (div) ou un span, avec ses classes, son style et ses attributs, en une ligne. Un bloc avec un style :

Un div avec un style
LHTML
div::[color:#b4232c; font-size:120%;]
Ce texte est grand et rouge.
::
Résultat
HTML produit
<div style="color:#b4232c; font-size:120%;">
Ce texte est grand et rouge.
</div>

div:: ouvre le bloc, [...] donne son CSS, et un :: seul le ferme. La forme générale est :

tagName::(.classes #id)[css style]{html attributes} content ::

Chaque groupe est facultatif. Sans nom, l'élément est un div. Un :: seul ferme le dernier élément ouvert.

Le nom est l'un de ceux de LHTML : div et span ; link, img, video et videoplay pour les liens et images ; code pour les blocs de code ; ::nl pour un espace. Ou c'est l'une de vos macros. Tout autre élément s'écrit en HTML.

Sans nom : un div

Le nom peut être omis : ::[...] est un div.

Un div anonyme
LHTML
::[padding:10px 14px; background:#eef6ee; border-radius:8px;]
Un encadré vert, son style en une ligne.
::
Résultat
HTML produit
<div style="padding:10px 14px; background:#eef6ee; border-radius:8px;">
Un encadré vert, son style en une ligne.
</div>

En ligne : sur une seule ligne

Un élément peut se fermer sur la ligne où il s'ouvre : terminez son contenu par ::. Un span fermé ainsi reste au milieu de sa phrase (un div fermé ainsi reste un bloc, sur une ligne à lui dans la page) :

Un span dans une phrase
LHTML
Le résultat est span::[color:#0b7a75; font-weight:bold;] correct :: dans tous les cas.
Résultat
HTML produit
Le résultat est <span style="color:#0b7a75; font-weight:bold;"> correct </span> dans tous les cas.

Le :: de fermeture ne compte que s'il est détaché du contenu :

  • La forme recommandée : une espace avant le :: de fermeture, comme dans span::(.key) S ::. Après lui peuvent venir une espace, la fin de la ligne ou une ponctuation : span::(.key) S ::, est fermé.
  • Un seul mot collé aux groupes ferme aussi, si une espace ou la fin de la ligne suit le :: : span::(.key)Ctrl:: + ... est fermé. Avec une ponctuation juste après, il ne l'est pas : span::(.key)S::, n'est jamais fermé, et LHTML le signale.
  • Un :: collé à un mot après une espace est du texte : dans span::(.key) S:: ..., le span n'est jamais fermé.

Les espaces autour du contenu restent dans le span : span::(.key) S :: donne <span class="key"> S </span>. Sur du texte coloré, elles ne se voient pas ; sur un span avec un fond ou une bordure, si. Pour un span serré, collez un seul mot : span::(.key)Ctrl::.

Les espaces dans le span
LHTML
span::[background:#ffe9a8;] espacé :: et span::[background:#ffe9a8;]serré:: et span::[background:#ffe9a8;] avant une virgule ::, fini.
Résultat
HTML produit
<span style="background:#ffe9a8;"> espacé </span> et <span style="background:#ffe9a8;">serré</span> et <span style="background:#ffe9a8;"> avant une virgule </span>, fini.

Classes, id et attributs

Tous les groupes
LHTML
::(.note #first)[background:#fff7e6; padding:6px 12px; border-radius:6px;]{title="L'attribut title : une infobulle"}
Survolez cet encadré : son attribut title s'affiche.
::
Résultat
HTML produit
<div class="note" id="first" style="background:#fff7e6; padding:6px 12px; border-radius:6px;" title="L'attribut title : une infobulle">
Survolez cet encadré : son attribut title s'affiche.
</div>
  • (...) : des classes avec ., un id avec #, comme en CSS ; Classes et id montre à quoi ils servent, sur chaque sorte d'élément.
  • [...] : le CSS de l'attribut style.
  • {...} : tous les autres attributs HTML.

Des blocs dans des blocs

Chaque :: ferme le dernier élément encore ouvert. Ouvrez le bloc extérieur, puis les blocs intérieurs, et fermez-les dans l'ordre inverse :

Deux colonnes
LHTML
::[display:flex; gap:12px;]
::[flex:1; background:#f6f6f6; padding:8px;]
Colonne de gauche,
sur deux lignes
::
::[flex:1; background:#f6f6f6; padding:8px;] Colonne de droite ::
::
Résultat
HTML produit
<div style="display:flex; gap:12px;">
<div style="flex:1; background:#f6f6f6; padding:8px;">
Colonne de gauche,
sur deux lignes
</div>
<div style="flex:1; background:#f6f6f6; padding:8px;"> Colonne de droite </div>
</div>

Quand ce n'est pas une balise

Une balise n'est lue que si elle est détachée : collé au mot qui le précède, :: est du texte. Du code écrit dans une phrase reste tel quel :

Des deux-points qui ne sont pas des balises
LHTML
En C++, std::vector est un conteneur ; en Python, a[::2] prend un élément sur deux.
Résultat
HTML produit
En C++, std::vector est un conteneur ; en Python, a[::2] prend un élément sur deux.
  • Un nom qui n'est ni une balise de LHTML ni une macro ne fait pas de balise : p:: texte :: reste du texte, et son :: ne ferme rien.
  • Rien n'est une balise dans du code en ligne : `div::` s'affiche tel qu'écrit.

Les avertissements

Un élément jamais fermé, ou un :: qui ne ferme rien, donne un avertissement, par la commande lhtml comme par lhtml-site. Pour un fichier notes.l.html dont la ligne 2 ouvre un div:: que rien ne ferme :

notes.l.html:2:1: warning: div:: is never closed (near 'div::[color:gray;]')

Il se lit fichier:ligne:colonne: niveau: message : le fichier, la ligne et la colonne où le problème commence (ici ligne 2, colonne 1), son niveau, puis ce qui ne va pas, avec le texte concerné. Les messages sont en anglais. Un avertissement n'arrête pas la conversion : la page est écrite, et ici le div court jusqu'à sa fin.

Vos propres balises : les macros

Quand le même style revient sur chaque page, déclarez-le une fois comme une balise à vous, note:: : voir Vos propres balises : les macros.

Suivant : Classes et id. Toutes les règles : Référence de la syntaxe.

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