Askama

Askama 实现了一个基于 Jinja 的模板渲染引擎。它在编译时根据用户定义的 struct 来保存模板的上下文，从您的模板生成 Rust 代码。请参阅下面的示例，或阅读文档。

"非常令人兴奋。我很想现在就使用它。" -- Jinja 的创造者 Armin Ronacher

欢迎所有反馈。请随时在问题追踪器上提交错误报告、文档请求和任何其他反馈，或在 Twitter 上联系我。

Askama 由 Dirkjan Ochtman 创建并维护。如果您有能力支持持续维护和进一步开发，或在营利环境中使用它，请考虑在 Patreon 上支持我的开源工作。

功能亮点

• 使用熟悉、易用的语法构建模板
• 受益于 Rust 类型系统提供的安全性
• 模板代码被编译到您的 crate 中，以获得最佳性能
• 可选的内置支持 Actix、Axum、Rocket 和 warp Web 框架
• 调试功能，协助您进行模板开发
• 模板必须是有效的 UTF-8 格式，并在渲染时生成 UTF-8 输出
• JetBrains 产品提供 IDE 支持
• 可在稳定版 Rust 上运行

模板支持的功能

• 模板继承
• 循环、if/else 语句和 include 支持
• 宏支持
• 变量（不允许可变性）
• 一些内置过滤器，以及使用自定义过滤器的能力
• 使用 '-' 标记抑制空白
• 可选的 HTML 转义
• 语法自定义

如何开始

首先，将 Askama 依赖项添加到您的 crate 的 Cargo.toml 中：

cargo add askama

现在在您的 crate 根目录下创建一个名为 templates 的目录。 在其中，创建一个名为 hello.html 的文件，内容如下：

Hello, {{ name }}!

在您 crate 内的任何 Rust 文件中，添加以下内容：

use askama::Template; // 引入 trait 到作用域

#[derive(Template)] // 这将生成代码...
#[template(path = "hello.html")] // 使用此路径的模板，相对于 crate 根目录的 `templates` 目录
struct HelloTemplate<'a> { // 结构体的名称可以是任何名称
    name: &'a str, // 字段名称应与模板中的变量名匹配
}

fn main() {
    let hello = HelloTemplate { name: "world" }; // 实例化您的结构体
    println!("{}", hello.render().unwrap()); // 然后渲染它
}

现在您应该能够编译并运行此代码了。

查看测试用例以获取更多示例。