68 lines
1.5 KiB
Markdown
68 lines
1.5 KiB
Markdown
+++
|
||
title = "Zola Cookbook"
|
||
description = "Snippets I've developed that I want to keep"
|
||
date = 2022-04-27T18:00:00+00:00
|
||
updated = 2022-04-27T18:00:00+00:00
|
||
template = "docs/section.html"
|
||
sort_by = "weight"
|
||
weight = 5
|
||
draft = false
|
||
[taxonomies]
|
||
documentation=["Reference"]
|
||
categories=["Web Development", "Static Site Generation", "Zola"]
|
||
+++
|
||
|
||
[Zola](../zola) is the static site generator I use for most of my websites that
|
||
don't require much dynamic functionality.
|
||
|
||
## Generating Nested Lists from Data
|
||
|
||
Example data:
|
||
|
||
```html
|
||
{
|
||
"definitions": [
|
||
{ "dt": "undefined", "dd": " the thing is undefined." },
|
||
{ "dt": "defined", "dd": " the thing is defined.", definitions: [
|
||
{ "dt": "truthy", "dd": "the defined thing is truthy" },
|
||
{ "dt": "falsy", "dd": "the defined thing is falsy" }
|
||
]}
|
||
]
|
||
}
|
||
```
|
||
|
||
Tera macro to render a nested list:
|
||
|
||
```
|
||
{% macro definition_body(source) %}
|
||
<dl>
|
||
{% for entry in source %}
|
||
<dt><kbd>{{ entry.dt | safe }}</kbd></dt>
|
||
<dd>
|
||
{{ entry.dd | safe }}
|
||
{% if entry.definitions %}
|
||
{{ self::definition_body(source=entry.definitions) }}
|
||
{% endif %}
|
||
</dd>
|
||
{% endfor %}
|
||
</dl>
|
||
{% endmacro %}
|
||
```
|
||
|
||
Zola shortcode to import the macro template into Markdown and start the render:
|
||
|
||
```
|
||
{%- import 'macros/definition_body.html' as renderer -%}
|
||
<div>
|
||
{% set content = load_data(path=source) %}
|
||
{{ renderer::definition_body(source=content.definitions) }}
|
||
</div>
|
||
```
|
||
|
||
Invocation in Markdown file, providing the data source:
|
||
|
||
```
|
||
{{ definition_list(source="@/docs/zola/definitions.json") }}
|
||
```
|
||
|