Module partials

Using partials

To use {% include %} or {% render %} tags in a template, you first need to compile these included files as template partials.

Example:

# common.liquid
Number: {{ i }}

use liquid::ParserBuilder;
use liquid::partials::{EagerCompiler, InMemorySource, PartialSource};

// Build template partials using an eager, in-memory source compiler.
// Other compilation policies also exist depending on specific needs.
type Partials = EagerCompiler<InMemorySource>;

let partials = {
  let mut partials = Partials::empty();

  let filepath = String::from("common.liquid");
  //let contents = std::fs::read_to_string(&filepath).unwrap();
  let contents = "Number: {{ i }}";

  partials.add(filepath, contents);
  partials
};

// Compile and render the main template, which uses the "common" partial.
let parser = ParserBuilder::with_stdlib().partials(partials).build().unwrap();
let rendered = {
    let globals = liquid::object!({ "num": 42 });
    parser
        .parse("Liquid! {% render \"common\", i: num %}").unwrap()
        .render(&globals).unwrap()
};

assert_eq!(rendered, "Liquid! Number: 42");

Structs

EagerCompiler

An eagerly-caching compiler for PartialSource.

InMemorySource

In-memory collection of partial-template source code.

LazyCompiler

An lazily-caching compiler for PartialSource.

OnDemandCompiler

An on-demand compiler for PartialSource.

Traits

PartialCompiler

Compile a PartialSource into a PartialStore of Renderables.

PartialSource

Partial-template source repository.