Templates

Sturdy uses the battle-tested minijinja library for templating.

Your templates reside in resource/template. minijinja is language agnostic, so you may use .html, .md or any other type of file you'd like.

 

Rendering Templates

async fn handle(
    &self,
    app: &App,
    request: HttpRequest,
) -> Result<Box<dyn Responsable>, HttpError> {
    // project-root/resource/template/user.html
    let result = app.template("user.html", Some(context! { name: "John Doe" }));

    match result {
        Ok(rendered) => Ok(Box::new(rendered)),
        Err(error) => Err(HttpError::new(500, error.to_string())),
    }
}

Read more: minijinja::context.

 

Template Interpolation

You may replace tokens in your templates for variable values.

<p>Name: {{ user.name }}</p>

 

Comments

<p>This will be rendered.</p>
{# This will not be rendered. #}

 

Control Flow

Control if content is displayed, loop over iterators.

 

If / elif / else

<p>
    Role:
    {% if user.is_admin %}
        Admin
    {% elif user.is_mod %}
        Moderator
    {% else %}
        Member
    {% endif %}
</p>

 

Loops

Assuming type: Vec<String>:

<ul>
    {% for todo in todos %}
        <li>{{ todo }}</li>
    {% endfor %}
</ul>

Assuming type: HashMap<String, User>:

<ul>
    {% for slug, post in posts|items %}
        <li>{{ post.title }}</li>
    {% endfor %}
</ul>
<ul>
    {% for id, user in posts|dictsort %}
        <li>{{ user.title }}</li>
    {% endfor %}
</ul>

Note the |items modifier after posts.

 

Template inheritance

Extend layouts for easy repetition and reuse.

Parent template base.html:

<!doctype html>
<html>
<head>
    {% block head %}
        <title>My Awesome Website</title>
    {% endblock %}
</head>
<body>
{% block content %}{% endblock %}
</body>
</html>

Child template my-page.html:

{% extends "base.html" %}
{% block head %}
    <title>My Awesome Page</title>
{% endblock %}
{% block content %}
    <p>Hello world!</p>
{% endblock %}

 

Links:

Next steps: