feat: add 404 page and tag listing generation

Detect content/_404.md as special page (underscore
prefix convention), store in SiteManifest.page_404,
render to 404.html in output root.

Add collect_tags() grouping all tagged content into
BTreeMap for deterministic output. render_tag_page()
renders through tags/default.html template.

Add 5 tests. Test suite: 78 → 83, all passing.
This commit is contained in:
Timothy DeHerrera
2026-02-14 16:03:30 -07:00
parent 53463b3d8b
commit e7809e1ce2
6 changed files with 307 additions and 13 deletions

9
docs/content/_404.md Normal file
View File

@@ -0,0 +1,9 @@
+++
title = "Page Not Found"
+++
# Page Not Found
The page you're looking for doesn't exist or has been moved.
[Return to the homepage](/)

View File

@@ -126,14 +126,14 @@ Items validated by codebase investigation:
- [x] Add tests: alias redirect generation (valid HTML, correct target URL)
3. **Phase 3: 404 & Tag Pages** — new content generation features
- [ ] Detect `content/404.md` in content discovery, treat as special page
- [ ] Render `404.md` to `404.html` in output root
- [ ] Collect all unique tags across content items during build
- [ ] Create `tags/default.html` template in `docs/templates/`
- [ ] Generate `/tags/<tag>.html` for each unique tag with list of tagged items
- [x] Detect `content/_404.md` in content discovery, treat as special page
- [x] Render `_404.md` to `404.html` in output root
- [x] Collect all unique tags across content items during build
- [x] Create `tags/default.html` template in `docs/templates/`
- [x] Generate `/tags/<tag>.html` for each unique tag with list of tagged items
- [ ] Add tag listing page entries to sitemap (if enabled)
- [ ] Add tests: 404 page generation
- [ ] Add tests: tag listing page generation (correct paths, correct items per tag)
- [x] Add tests: 404 page generation
- [x] Add tests: tag listing page generation (correct paths, correct items per tag)
- [ ] End-to-end: build `docs/` site and verify all outputs
## Verification
@@ -145,7 +145,7 @@ Items validated by codebase investigation:
- [ ] End-to-end: build `docs/` site with `cargo run`, verify:
- [ ] `public/sitemap.xml` exists (default enabled)
- [ ] `public/atom.xml` exists (default enabled)
- [ ] `public/404.html` exists (with 404.md in docs/content)
- [ ] `public/404.html` exists (with \_404.md in docs/content)
- [ ] Templates use `config.nav.nested` (not `config.nested_nav`)
- [ ] Templates use `config.base_url` (not bare `base_url`)
- [ ] No `section/features.html` or `homepage.html` templates remain

15
docs/templates/tags/default.html vendored Normal file
View File

@@ -0,0 +1,15 @@
{% extends "base.html" %} {% block content %}
<article class="section-index">
<h1>Tagged: {{ tag }}</h1>
<nav class="section-nav">
{% for item in items %}
<a href="{{ prefix }}{{ item.path }}" class="section-link">
<strong>{{ item.frontmatter.title }}</strong>
{% if item.frontmatter.description %}
<span>{{ item.frontmatter.description }}</span>
{% endif %}
</a>
{% endfor %}
</nav>
</article>
{% endblock content %}