Vos propres balises : les macros
Écrire le même style sur chaque page est fastidieux, et le modifier ensuite l'est encore plus. Une
macro déclare une balise une seule fois ; chaque page l'écrit ensuite par son nom. Les
macros sont un fichier YAML, macros.yaml :
note: class: note doc: 'Une remarque en gris : note:: ... ::'
et dans n'importe quelle page :
note:: Pensez à enregistrer avant de construire le site. ::
donne <div class="note"> ... </div>, avec la commande lhtml :
lhtml -m macros.yaml page.l.html --title "Notes" -o page.html. Son apparence vient de votre
feuille de style (--css style.css).
Une macro prend un groupe comme tout bloc : note::(.important) ajoute la classe important à la
sienne (Classes et id).
Dans lhtml-site, les mêmes définitions vont sous design: macros: dans configure.yaml, et une
macro peut porter son CSS, que lhtml-site écrit dans le site (LHTML seul rejette le champ css) :
design: macros: note: class: note doc: 'Une remarque en gris : note:: ... ::' css: '.note { color: gray; border-left: 3px solid #ccc; padding-left: 10px; }'
Les thèmes de slides viennent avec leurs propres macros (gap::, small::, cols::, box::...) :
voir Thèmes.
Suivant : construisez quelque chose, par exemple Un site de cours, et retrouvez chaque règle dans la Référence de la syntaxe.