E-mails are templates used for rendering e-mails. The template is parsed using a context processor to complete variable references and execute control statements.
Inside Peering Manager, templates use the Jinja2 syntax which allows for complex logic building. By default, a single trailing newline is stripped if present other whitespace (spaces, tabs, newlines etc.) is returned unchanged. You can tweak this behavior by enabling/disabling the trim and lstrip options.
Examples of e-mails are provided in the Peering Manager's templating documentation.
For each e-mail that you create, the following properties can be configured (n.b. some are optional):
Name
: human-readable name attached to a template.Slug
: unique configuration and URL friendly name; most of the time it is automatically generated from the template's name.Subject
: subject's template, formatted using Jinja2 syntax.Template
: body's template, formatted using Jinja2 syntax.Jinja2 trim
: if enabled, the first newline after a template tag is removed automatically.Jinja2 lstrip
: if enabled, tabs and spaces from the beginning of a line to the start of a block will be removed.Comments
: text to explain what the template is for. Can use Markdown formatting.Tags
: list of tags to help identifying and searching for a template.