feat(templates): add Tera runtime template engine

Lay groundwork for user-editable templates by adding Tera as a
runtime template engine alongside the existing maud templates.

Changes:
- Add tera dependency
- Create TemplateEngine struct with render methods
- Add TemplateLoad/TemplateRender error variants
- Add section_type/template fields to Frontmatter
- Create templates/ directory with base, page, section, and content templates

Dead code warnings are expected; TemplateEngine will be wired
in to replace maud in subsequent commits.
This commit is contained in:
Timothy DeHerrera
2026-01-31 14:59:49 -07:00
parent 1bf265f14b
commit 3df7fda26a
14 changed files with 647 additions and 1 deletions

25
templates/base.html Normal file
View File

@@ -0,0 +1,25 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{ title }} | {{ config.title }}</title>
<link rel="canonical" href="{{ config.base_url | trim_end_matches(pat='/') }}{{ page_path }}">
<link rel="alternate" type="application/atom+xml" title="Atom Feed" href="{{ config.base_url | trim_end_matches(pat='/') }}/feed.xml">
<link rel="stylesheet" href="{{ prefix }}/style.css">
</head>
<body>
<nav>
<a href="{{ prefix }}/index.html">{{ config.title }}</a>
{% for item in nav %}
<a href="{{ prefix }}{{ item.path }}">{{ item.label }}</a>
{% endfor %}
</nav>
<main>
{% block content %}{% endblock content %}
</main>
<footer>
<p>© {{ config.author }}</p>
</footer>
</body>
</html>

View File

@@ -0,0 +1,13 @@
{% extends "base.html" %}
{% block content %}
<article>
<h1>{{ page.title }}</h1>
{% if page.description %}
<p class="description">{{ page.description }}</p>
{% endif %}
<section class="content">
{{ content | safe }}
</section>
</article>
{% endblock content %}

View File

@@ -0,0 +1,25 @@
{% extends "base.html" %}
{% block content %}
<article class="post">
<header>
<h1>{{ page.title }}</h1>
{% if page.date %}
<time class="date">{{ page.date }}</time>
{% endif %}
{% if page.description %}
<p class="description">{{ page.description }}</p>
{% endif %}
{% if page.tags %}
<ul class="tags">
{% for tag in page.tags %}
<li><a href="{{ prefix }}/tags/{{ tag }}.html">{{ tag }}</a></li>
{% endfor %}
</ul>
{% endif %}
</header>
<section class="content">
{{ content | safe }}
</section>
</article>
{% endblock content %}

13
templates/homepage.html Normal file
View File

@@ -0,0 +1,13 @@
{% extends "base.html" %}
{% block content %}
<section class="hero">
<h1>{{ page.title }}</h1>
{% if page.description %}
<p class="tagline">{{ page.description }}</p>
{% endif %}
</section>
<section class="content">
{{ content | safe }}
</section>
{% endblock content %}

10
templates/page.html Normal file
View File

@@ -0,0 +1,10 @@
{% extends "base.html" %}
{% block content %}
<article class="page">
<h1>{{ page.title }}</h1>
<section class="content">
{{ content | safe }}
</section>
</article>
{% endblock content %}

View File

@@ -0,0 +1,20 @@
{% extends "base.html" %}
{% block content %}
<h1>{{ section.title }}</h1>
<ul class="post-list">
{% for item in items %}
<li>
<a href="./{{ item.slug }}.html">
<span class="title">{{ item.frontmatter.title }}</span>
{% if item.frontmatter.date %}
<time class="date">{{ item.frontmatter.date }}</time>
{% endif %}
</a>
{% if item.frontmatter.description %}
<p class="description">{{ item.frontmatter.description }}</p>
{% endif %}
</li>
{% endfor %}
</ul>
{% endblock content %}

View File

@@ -0,0 +1,15 @@
{% extends "base.html" %}
{% block content %}
<h1>{{ section.title }}</h1>
<ul class="item-list">
{% for item in items %}
<li>
<a href="./{{ item.slug }}.html">{{ item.frontmatter.title }}</a>
{% if item.frontmatter.description %}
<p>{{ item.frontmatter.description }}</p>
{% endif %}
</li>
{% endfor %}
</ul>
{% endblock content %}

View File

@@ -0,0 +1,24 @@
{% extends "base.html" %}
{% block content %}
<h1>{{ section.title }}</h1>
<ul class="project-cards">
{% for item in items %}
<li class="card">
{% if item.frontmatter.link_to %}
<a href="{{ item.frontmatter.link_to }}" target="_blank" rel="noopener">
<h2>{{ item.frontmatter.title }}</h2>
{% if item.frontmatter.description %}
<p>{{ item.frontmatter.description }}</p>
{% endif %}
</a>
{% else %}
<h2>{{ item.frontmatter.title }}</h2>
{% if item.frontmatter.description %}
<p>{{ item.frontmatter.description }}</p>
{% endif %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endblock content %}