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 :
div::[color:#b4232c; font-size:120%;]
Ce texte est grand et rouge.
::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.
::[padding:10px 14px; background:#eef6ee; border-radius:8px;]
Un encadré vert, son style en une ligne.
::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) :
Le résultat est span::[color:#0b7a75; font-weight:bold;] correct :: dans tous les cas.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 dansspan::(.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 : dansspan::(.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::.
span::[background:#ffe9a8;] espacé :: et span::[background:#ffe9a8;]serré:: et span::[background:#ffe9a8;] avant une virgule ::, fini.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
::(.note #first)[background:#fff7e6; padding:6px 12px; border-radius:6px;]{title="L'attribut title : une infobulle"}
Survolez cet encadré : son attribut title s'affiche.
::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'attributstyle.{...}: 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 :
::[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 ::
::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 :
En C++, std::vector est un conteneur ; en Python, a[::2] prend un élément sur deux.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.