Askama 模板引擎使用教程

1. 项目介绍

Askama 是一个基于 Rust 的模板渲染引擎，灵感来源于 Jinja。它通过在编译时生成 Rust 代码来实现模板渲染，从而提供了类型安全和高效的性能。Askama 支持多种 Web 框架，如 Actix、Axum、Rocket 和 warp，并且具有调试功能，帮助开发者在模板开发过程中进行调试。

2. 项目快速启动

2.1 安装依赖

首先，在 Cargo.toml 文件中添加 Askama 依赖：

[dependencies]
askama = "0.11"

2.2 创建模板文件

在项目的根目录下创建一个名为 templates 的目录，并在其中创建一个名为 hello.html 的模板文件，内容如下：

Hello, {{ name }}!

2.3 编写 Rust 代码

在 Rust 文件中编写以下代码：

use askama::Template;

#[derive(Template)]
#[template(path = "hello.html")]
struct HelloTemplate<'a> {
    name: &'a str,
}

fn main() {
    let hello = HelloTemplate { name: "world" };
    println!("{}", hello.render().unwrap());
}

2.4 运行项目

使用以下命令编译并运行项目：

cargo run

运行后，控制台将输出：

Hello, world!

3. 应用案例和最佳实践

3.1 在 Web 框架中使用

Askama 可以与多种 Rust Web 框架集成，例如 Actix、Axum、Rocket 和 warp。以下是一个在 Actix 中使用 Askama 的示例：

use actix_web::{web, App, HttpServer, Responder};
use askama::Template;

#[derive(Template)]
#[template(path = "hello.html")]
struct HelloTemplate<'a> {
    name: &'a str,
}

async fn index(info: web::Path<String>) -> impl Responder {
    let template = HelloTemplate { name: &info };
    template.render().unwrap()
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new().route("/hello/{name}", web::get().to(index))
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

3.2 最佳实践

• 模板继承：Askama 支持模板继承，可以通过 {% extends "base.html" %} 语法来实现。
• 自定义过滤器：可以通过实现 askama::Filter 特性来创建自定义过滤器。
• 调试：使用 #[template(debug = true)] 属性来启用调试模式，帮助定位模板中的问题。

4. 典型生态项目

4.1 Actix

Actix 是一个强大的 Rust Web 框架，Askama 可以与其无缝集成，提供高效的模板渲染功能。

4.2 Axum

Axum 是另一个流行的 Rust Web 框架，Askama 同样支持与 Axum 的集成，帮助开发者快速构建 Web 应用。

4.3 Rocket

Rocket 是一个以开发者友好著称的 Rust Web 框架，Askama 可以与其配合使用，提供类型安全的模板渲染。

4.4 warp

warp 是一个基于 hyper 和 tokio 的 Rust Web 框架，Askama 可以与其集成，提供高效的异步模板渲染。

通过以上内容，您可以快速上手 Askama 模板引擎，并在实际项目中应用它。