Zmpl is a templating language for Zig 🦎
- Use Zig code directly in templates for control flow.
- Simple and intuitive DSL for building flexible, JSON-compatible data objects.
- Compiles to Zig code for syntax and type validation.
- Used by the Jetzig web framework.
Visit the Jetzig Documentation page to see detailed Zmpl documentation with usage examples.
Syntax highlighters are currently community-sourced. Please get in touch if you have created a plugin for your editor of choice and we will gladly list it here.
- VSCode by Zackary Housend
- NeoVim syntax highlighting can be achieved by using the above VSCode grammar with the nvim-textmate plugin. You may need to use this fork if you have issues compiling the UTF-8 extension.
See src/templates for more examples.
<!-- Zig mode for template logic -->
@zig {
if (std.mem.eql(u8, "zmpl is simple", "zmpl" ++ " is " ++ "simple")) {
<span>Zmpl is simple!</span>
}
}
<!-- Easy data lookup syntax -->
<div>Email: {{.user.email}}</div>
<div>Token: {{.auth.token}}</div>
<!-- Partials -->
@partial example_partial
<!-- Partials with positional args -->
@partial mailto(.user.email, "Welcome to Jetzig!")
<!-- Partials with keyword args --->
@partial mailto(email: .user.email, subject: "Welcome to Jetzig!")
<!-- Partials with slots --->
@partial mailto(email: .user.email, subject: "Welcome to Jetzig!") {
<a href="https://example.com/auth/{{.auth.token}}">Sign in</a>
<a href="https://example.com/unsubscribe/{{.auth.token}}">Unsubscribe</a>
}
@markdown {
# Built-in markdown support
* [jetzig.dev](https://www.jetzig.dev/)
}
@args email: *ZmplValue, subject: []const u8
<a href="mailto:{{email}}?subject={{subject}}">{{email}}</a>
@zig {
for (slots, 0..) |slot, slot_index| {
<div class="slot-{{slot_index}}">{{slot}}</div>
}
}
<!-- Zig mode for template logic -->
<span>Zmpl is simple!</span>
<!-- Easy data lookup syntax -->
<div>Email: [email protected]</div>
<div>Token: abc123-456-def</div>
<!-- Partials -->
<span>An example partial</span>
<!-- Partials with positional args -->
<a href="mailto:[email protected]?subject=Welcome to Jetzig!">[email protected]</a>
<!-- Partials with keyword args --->
<a href="mailto:[email protected]?subject=Welcome to Jetzig!">[email protected]</a>
<!-- Partials with slots --->
<a href="mailto:[email protected]?subject=Welcome to Jetzig!">[email protected]</a>
<div class="slot-0"><a href="https://example.com/auth/abc123-456-def">Sign in</a></div>
<div class="slot-1"><a href="https://example.com/unsubscribe/abc123-456-def">Unsubscribe</a></div>
<div><h1>Built-in markdown support</h1>
<ul><li><a href="https://www.jetzig.dev/">jetzig.dev</a></li></ul></div>
Default template path is src/templates
. Use -Dzmpl_templates_path=...
to set an alternative (relative or absolute) path.
const std = @import("std");
const zmpl = @import("zmpl");
test "readme example" {
var data = zmpl.Data.init(std.testing.allocator);
defer data.deinit();
var body = try data.object();
var user = try data.object();
var auth = try data.object();
try user.put("email", data.string("[email protected]"));
try auth.put("token", data.string("abc123-456-def"));
try body.put("user", user);
try body.put("auth", auth);
if (zmpl.find("example")) |template| {
const output = try template.render(&data);
defer std.testing.allocator.free(output);
try std.testing.expectEqualStrings(
\\<!-- Zig mode for template logic -->
\\ <span>Zmpl is simple!</span>
\\
\\
\\<!-- Easy data lookup syntax -->
\\<div>Email: [email protected]</div>
\\<div>Token: abc123-456-def</div>
\\
\\<!-- Partials -->
\\<span>An example partial</span>
\\<!-- Partials with positional args -->
\\<a href="mailto:[email protected]?subject=Welcome to Jetzig!">[email protected]</a>
\\<!-- Partials with keyword args --->
\\<a href="mailto:[email protected]?subject=Welcome to Jetzig!">[email protected]</a>
\\<!-- Partials with slots --->
\\<a href="mailto:[email protected]?subject=Welcome to Jetzig!">[email protected]</a>
\\ <div class="slot-0"><a href="https://example.com/auth/abc123-456-def">Sign in</a></div>
\\ <div class="slot-1"><a href="https://example.com/unsubscribe/abc123-456-def">Unsubscribe</a></div>
\\
\\<div><h1>Built-in markdown support</h1>
\\<ul><li><a href="https://www.jetzig.dev/">jetzig.dev</a></li></ul></div>
, output);
} else {
try std.testing.expect(false);
}
}
Templ - inspiration for template layout.