Rocket/contrib/dyn_templates/README.md

dyn_templates

This crate adds support for dynamic template rendering to Rocket. It automatically discovers templates, provides a Responder to render templates, and automatically reloads templates when compiled in debug mode. At present, it supports Handlebars and Tera.

Usage

1. Enable the rocket_dyn_templates feature corresponding to your templating engine(s) of choice:

   [dependencies.rocket_dyn_templates]
   version = "0.1.0-rc.1"
   features = ["handlebars", "tera"]
   

2. Write your template files in Handlebars (.hbs) and/or Tera (.tera) in the configurable template_dir directory (default: {rocket_root}/templates).

3. Attach Template::fairing() and return a Template using Template::render(), supplying the name of the template file minus the last two extensions:

   use rocket_dyn_templates::{Template, context};
   
   #[get("/")]
   fn index() -> Template {
       Template::render("template-name", context! { field: "value" })
   }
   
   #[launch]
   fn rocket() -> _ {
       rocket::build().attach(Template::fairing())
   }
   

See the crate docs for full details.