Overview

This site is generated using a minimal static pipeline built on pandoc and shell scripting.

The goal is to maintain a system that is: - simple - reproducible - compatible with older hardware and browsers - free of unnecessary dependencies

Architecture

• Source: Markdown files
• Renderer: pandoc
• Build: shell script
• Output: static HTML
• Hosting: sdf.org

Design Constraints

• No JavaScript
• No build frameworks
• No external dependencies beyond pandoc
• Must render cleanly on legacy systems
• Must remain readable as raw HTML

Structure

• content/ → source markdown
• templates/ → HTML layout
• static/ → styling
• build.sh → compilation

Key Decisions

• Use pandoc templates instead of manual HTML injection
• Use include files for navigation and footer
• Use root-relative paths for navigation stability
• Introduce base tag to normalize path resolution
• Preserve directory structure during build

Build Process

The site is generated via a shell script which:

1. Locates all markdown files
2. Converts them using pandoc
3. Applies a shared template
4. Injects navigation and footer
5. Writes output to the web directory

Notes

This system is intentionally minimal.

Complexity is avoided unless it provides clear and lasting value.

Log

2026-03-23
- Implemented pandoc template system
- Introduced include-based navigation and footer
- Resolved pathing issues via base URL handling
- Converted site to directory-aware structure
- Eliminated manual HTML duplication

2026-03-23 (later)
- Refined CSS for readability and compatibility
- Introduced projects as structured content