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.