0.1.3	~~Mar 9, 2022~~
0.1.2	~~Jul 7, 2021~~
0.1.1	~~Jul 7, 2021~~
0.0.1	~~Jun 23, 2021~~

#29 in #rsx

MIT license

4KB

yate

yate is a simple, idiomatic, combined html template engine and static site generator.

`lib.rs`:

yate is a simple, idiomatic, combined html template engine and static site generator.

Templating is done through composing html macro generated string chunks that can be returned by Rust functions. The macro, powered by syn-rsx, supports arbitrary Rust syntax in braced blocks in various html positions which unlocks using regular language features without being limited by specialized template syntax. The fact that the composed content is just a string makes it very flexible and allows e.g. serving it with a webserver or write it as static content.

Embedded Rust code in braced blocks inside the html! macro must return something that implements std::fmt::Display. More information about supported syntax can be found here.

Example

# async {
use yate::html;

fn content() -> String {
    html! { <div>"content"</div> }
}

fn index() -> String {
    html! {
        <!DOCTYPE html>
        <html>
            <head></head>
            <body>
                {content()}
            </body>
        </html>
    }
}

std::fs::write("index.html", index())?;
#
# Ok::<(), Box<dyn std::error::Error>>(()) };

Html escaping

There is syntax sugar available that passes expressions in braced blocks into html_escape::escape_text(). Works like this:

let div = yate::html! { <div>{%= "<uwu>" %}</div> };
assert_eq!(div, "<div>&lt;uwu&gt;</div>")

Dependencies

~1.5MB
~40K SLoC