Macros

Macros are special markup which add functionality to DarkGlass. A macro call is written $macro if the macro takes no arguments, or $macro{arg_1_,…,arg_n_} if it does. Commas in macro arguments must be escaped with backslashes. Unwanted arguments may be omitted.

Macros are evaluated after Markdown is converted to HTML.

FIXME: Documentation of some macros is missing. The documentation should really be extracted from the code.

$page

The site-relative path of the current page.

$pagename

The name of the current page (the last path component of $page).

$lastmodified

The date on which the current page was last modified.

$url{_path_}

Make a URL from a site-relative path.

$include{_file_}

Inserts the contents of the given file from the templates directory, or nothing if the file cannot be read.

$link{_url_,_description_,_class_}

Produces a link to the given URL whose displayed text is _description_ (set to the URL if not given). If the _class_ argument is supplied, it is used to set the class attribute of the a element.

$email{_text_}

Makes _text_ a link to send mail to the administrator (see Configuration).

---

Last updated 2024/10/09