liquid-rust
Liquid templating for Rust
Usage
To include liquid in your project add the following to your Cargo.toml:
[]
= "0.16"
Now you can use the crate in your code:
extern crate liquid;
Example:
extern crate liquid;
let template = with_liquid
.build
.parse.unwrap;
let mut globals = new;
globals.insert;
let output = template.render.unwrap;
assert_eq!;
You can find a reference on Liquid syntax here.
Extending Liquid
Create your own filters
Creating your own filters is very easy. Filters are simply functions or
closures that take an input Value
and a Vec<Value>
of optional arguments
and return a Value
to be rendered or consumed by chained filters.
See
filters.rs
for what a filter implementation looks like. You can then register it by
calling liquid::ParserBuilder::filter
.
Create your own tags
Tags are made up of two parts, the initialization and the rendering.
Initialization happens when the parser hits a Liquid tag that has your
designated name. You will have to specify a function or closure that will
then return a Renderable
object to do the rendering.
See
include_tag.rs
for what a tag implementation looks like. You can then register it by calling liquid::ParserBuilder::tag
.
Create your own tag blocks
Blocks work very similar to Tags. The only difference is that blocks contain other
markup, which is why block initialization functions take another argument, a list
of Element
s that are inside the specified block.
See
comment_block.rs
for what a block implementation looks like. You can then register it by
calling liquid::ParserBuilder::block
.