LHTML+ lhtml-site

Your own tags: macros

Writing the same style on every page is tiresome, and changing it later is worse. A macro declares a tag once; every page then writes it by name. The macros are a YAML file, macros.yaml:

note:
  class: note
  doc: 'A remark in gray: note:: ... ::'

and in any page:

note::
Remember to save before you build.
::

gives <div class="note"> ... </div>, with the lhtml command: lhtml -m macros.yaml page.l.html --title "Notes" -o page.html. Its look comes from your stylesheet (--css style.css).

A macro takes a group like any block: note::(.important) adds the class important to its own (Classes and ids).

In lhtml-site, the same definitions go under design: macros: in configure.yaml, and a macro may carry its CSS, which lhtml-site writes into the site (LHTML alone rejects the css field):

design:
  macros:
    note:
      class: note
      doc: 'A remark in gray: note:: ... ::'
      css: '.note { color: gray; border-left: 3px solid #ccc; padding-left: 10px; }'

Slide themes come with their own macros (gap::, small::, cols::, box::...): see Themes.

Next: build something, such as A course website, and every rule in the Syntax reference.

Built with lhtml-site, the docs theme. Part of ScholarTools.