This package is to generate data-driven HTML output. # Directives Each directive begins with an `@` sign. Some directives begin contains a `{}` block, others only have `''` (string) parameters. More on the directives itself. Newlines on the beginning and end are ignored in `{}` blocks, otherwise this (see [if](##if) for this syntax): ```html @if bool_val { This is shown if bool_val is true } ``` would result in: ```html This is shown if bool_val is true ``` which could result in unreadable output. ## if The if directive consists of three parts, the `@if` tag, the condition (same syntax like in V) and the `{}` block where you can write html which will be rendered if the condition is true: ``` @if {} ``` ### Example ```html @if bool_val { This is shown if bool_val is true } ``` One-liner: ```html @if bool_val { This is shown if bool_val is true } ``` The first example would result in: ```html This is shown if bool_val is true ``` while the one-liner results in: ```html This is shown if bool_val is true ``` ## for The for directive consists of three parts, the `@for` tag, the condition (same syntax like in V) and the `{}` block where you can write html which will be rendered for each loop: ``` @for {} ``` ### Example ```html @for i, val in my_vals { $i - $val } ``` One-liner: ```html @for i, val in my_vals { $i - $val } ``` The first example would result in: ```html 0 - "First" 1 - "Second" 2 - "Third" ... ``` while the one-liner results in: ```html 0 - "First" 1 - "Second" 2 - "Third" ... ``` You can also write (and all other for condition syntaxes that are allowed in V): ```html @for i = 0; i < 5; i++ { $i } ``` ## include The include directive is for including other html files (which will be processed as well) and consists of two parts, the `@include` tag and a following `''` string. The path parameter is relative to the `/templates` directory in the corresponding project. ### Example Files ``` Project root /templates - index.html /headers - base.html ``` `index.html` ```html
@include 'header/base'
``` > Note that there shouldn't be a file suffix, it is automatically appended and only allows `html` files. # Variables All variables which are declared before can be used through the `@{my_var}` syntax. It's also possible to use properties of structs here like `@{my_struct.prop}`.