LHTML+ lhtml-site

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.

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