maud/docs/content/partials.md

Partials

Maud does not have a built-in concept of partials or sub-templates. Instead, you can compose your markup with any function that returns Markup.

The following example defines a header and footer function. These functions are combined to form the final page.

use maud::{DOCTYPE, html, Markup};

/// A basic header with a dynamic `page_title`.
fn header(page_title: &str) -> Markup {
    html! {
        (DOCTYPE)
        meta charset="utf-8";
        title { (page_title) }
    }
}

/// A static footer.
fn footer() -> Markup {
    html! {
        footer {
            a href="rss.atom" { "RSS Feed" }
        }
    }
}

/// The final Markup, including `header` and `footer`.
///
/// Additionally takes a `greeting_box` that's `Markup`, not `&str`.
pub fn page(title: &str, greeting_box: Markup) -> Markup {
    html! {
        // Add the header markup to the page
        (header(title))
        body {
            h1 { "Hello World" }
            (greeting_box)
        }
        // Add the footer markup to the page
        (footer())
    }
}

Using the page function will return the markup for the whole page. Here's an example:

page("Hello!", html! {
    div { "Greetings, Maud." }
});