commit e081dc4cd0b83050a007dd1f01984ce61304455d
Author: Nathaniel Chappelle <nathaniel@chappelle.dev>
Date: Wed, 4 Feb 2026 14:46:39 -0800
Init commit
Diffstat:
6 files changed, 601 insertions(+), 0 deletions(-)
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,2 @@
+content/
+dist/
diff --git a/Makefile b/Makefile
@@ -0,0 +1,30 @@
+# Makefile for framework
+
+.POSIX:
+
+all: build
+
+build:
+ ./build.sh
+
+clean:
+ rm -rf dist
+
+serve: build
+ @echo "Starting local server on http://localhost:8000"
+ @cd dist && python3 -m http.server 8000
+
+deploy: build
+ @echo "Deploy target not configured."
+ @echo "Edit this Makefile to add your deployment command."
+ @echo "Example: rsync -av --delete dist/ user@server:/var/www/"
+
+watch:
+ @echo "Watching for changes..."
+ @while true; do \
+ inotifywait -r -e modify,create,delete src templates sw.conf 2>/dev/null || \
+ sleep 2; \
+ make build; \
+ done
+
+.PHONY: all build clean serve deploy watch
diff --git a/build.sh b/build.sh
@@ -0,0 +1,497 @@
+#!/bin/sh
+# verso2 - suckless web framework
+# A minimal static site generator
+
+set -e
+
+# Load configuration
+if [ ! -f "./web.conf" ]; then
+ echo "Error: web.conf not found in current directory"
+ exit 1
+fi
+. ./web.conf
+
+# Helper functions
+log() {
+ printf "* %s\n" "$1"
+}
+
+error() {
+ printf "Error: %s\n" "$1" >&2
+ exit 1
+}
+
+# Extract metadata from markdown file
+# Supports simple YAML frontmatter between --- markers
+extract_meta() {
+ local file="$1"
+ local key="$2"
+
+ awk -v key="$key" '
+ /^---$/ { in_meta = !in_meta; next }
+ in_meta && $0 ~ "^" key ":" {
+ sub("^" key ": *", "")
+ print
+ exit
+ }
+ ' "$file"
+}
+
+# Extract first h1 title from markdown
+extract_title() {
+ local file="$1"
+ local meta_title
+
+ # Try frontmatter first
+ meta_title=$(extract_meta "$file" "title")
+ if [ -n "$meta_title" ]; then
+ echo "$meta_title"
+ return
+ fi
+
+ # Fall back to first # heading
+ grep '^# ' "$file" | head -n 1 | sed 's/^# *//' || echo "Untitled"
+}
+
+# Extract date from frontmatter or filename
+extract_date() {
+ local file="$1"
+ local meta_date
+ local basename_file
+
+ # Try frontmatter first
+ meta_date=$(extract_meta "$file" "date")
+ if [ -n "$meta_date" ]; then
+ echo "$meta_date"
+ return
+ fi
+
+ # Try to extract from filename (YYYY-MM-DD-title.md format)
+ basename_file=$(basename "$file")
+ echo "$basename_file" | grep -oE '^[0-9]{4}-[0-9]{2}-[0-9]{2}' || echo ""
+}
+
+extract_author() {
+ extract_meta "$1" "author"
+}
+
+# Substitute template variables
+substitute_vars() {
+ local template="$1"
+ local title="$2"
+ local content="$3"
+ local date="$4"
+ local nav="$5"
+ local author="$6"
+
+ # First pass: substitute simple variables
+ sed -e "s|{{TITLE}}|${title}|g" \
+ -e "s|{{SITE_TITLE}}|${SITE_TITLE}|g" \
+ -e "s|{{SITE_URL}}|${SITE_URL}|g" \
+ -e "s|{{SITE_DESCRIPTION}}|${SITE_DESCRIPTION}|g" \
+ -e "s|{{AUTHOR}}|${author}|g" \
+ -e "s|{{DATE}}|${date}|g" \
+ "$template" | while IFS= read -r line; do
+ # Handle {{NAV}} substitution
+ if echo "$line" | grep -q '{{NAV}}'; then
+ echo "$nav"
+ # Handle {{CONTENT}} substitution
+ elif echo "$line" | grep -q '{{CONTENT}}'; then
+ cat "$content"
+ else
+ echo "$line"
+ fi
+ done
+}
+
+# Calculate relative path back to root
+get_relpath() {
+ local path="$1"
+ local depth
+
+ depth=$(echo "$path" | grep -o "/" | wc -l)
+ if [ "$depth" -eq 0 ]; then
+ echo "."
+ else
+ printf '../%.0s' $(seq 1 "$depth") | sed 's/\/$//'
+ fi
+}
+
+# Build a single page
+build_page() {
+ local src="$1"
+ local dst="$2"
+ local rel_src
+ local title
+ local date
+ local nav
+ local tmpfile
+ local author
+
+ rel_src=$(echo "$src" | sed "s|^${INPUT_DIR}/||")
+ title=$(extract_title "$src")
+ date=$(extract_date "$src")
+ nav=$(generate_nav)
+ author=$(extract_author "$src")
+
+ [ -z "$author" ] && author="$AUTHOR"
+
+ # Create output directory
+ mkdir -p "$(dirname "$dst")"
+
+ # Strip frontmatter and render markdown to temp file
+ tmpfile=$(mktemp)
+ awk '
+ /^---$/ {
+ if (!seen_first) {
+ seen_first = 1;
+ in_meta = 1;
+ next
+ } else if (in_meta) {
+ in_meta = 0;
+ next
+ }
+ }
+ !in_meta { print }
+ ' "$src" | $MD_PROCESSOR $MD_FLAGS > "$tmpfile"
+
+ # Substitute and write output
+ substitute_vars "$TEMPLATE_DIR/header.html" "$title" "$tmpfile" "$date" "$nav" "$author" > "$dst"
+
+ # Add footer with substitution
+ sed -e "s|{{AUTHOR}}|${AUTHOR}|g" \
+ -e "s|{{SITE_TITLE}}|${SITE_TITLE}|g" \
+ "$TEMPLATE_DIR/footer.html" >> "$dst"
+
+ rm "$tmpfile"
+ log "Built: $rel_src -> $(echo "$dst" | sed "s|^${OUTPUT_DIR}/||")"
+}
+
+# Generate navigation menu
+generate_nav() {
+ local nav_html=""
+
+ # Add home link
+ nav_html="$nav_html <a href=\"/\">Home</a>"
+
+ # Find all items in root of INPUT_DIR (both files and directories)
+ (
+ # List markdown files (excluding index.md)
+ find "$INPUT_DIR" -maxdepth 1 -name "*.md" ! -name "index.md" -type f | while read f; do
+ title=$(extract_title "$f")
+ slug=$(basename "$f" .md)
+ echo "file|$slug|$title"
+ done
+
+ # List directories
+ find "$INPUT_DIR" -maxdepth 1 -type d ! -path "$INPUT_DIR" | while read d; do
+ dirname=$(basename "$d")
+ # Skip assets directory
+ [ "$dirname" = "assets" ] && continue
+
+ # Try to get title from index.md if it exists
+ if [ -f "$d/index.md" ]; then
+ title=$(extract_title "$d/index.md")
+ else
+ # Convert dirname to title (capitalize, replace hyphens/underscores)
+ title=$(echo "$dirname" | sed 's/[-_]/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
+ fi
+ echo "dir|$dirname|$title"
+ done
+ ) | sort -t'|' -k2 | while IFS='|' read type slug title; do
+ if [ "$CLEAN_URLS" = "yes" ]; then
+ nav_html="$nav_html <a href=\"/$slug/\">$title</a>"
+ else
+ if [ "$type" = "dir" ]; then
+ nav_html="$nav_html <a href=\"/$slug.html\">$title</a>"
+ else
+ nav_html="$nav_html <a href=\"/$slug.html\">$title</a>"
+ fi
+ fi
+ echo "$nav_html"
+ nav_html=""
+ done
+}
+
+# Generate automatic directory index
+generate_directory_index() {
+ local dir="$1"
+ local output="$2"
+ local dirname=$(basename "$dir")
+ local title
+ local index_md
+
+ # Convert dirname to title
+ title=$(echo "$dirname" | sed 's/[-_]/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
+
+ log "Auto-generating index for $dirname..."
+
+ index_md=$(mktemp)
+
+ echo "# $title" > "$index_md"
+ echo "" >> "$index_md"
+
+ # Find all markdown files in this directory (excluding index.md)
+ find "$dir" -maxdepth 1 -name "*.md" ! -name "index.md" -type f | sort | while read f; do
+ file_title=$(extract_title "$f")
+ date=$(extract_date "$f")
+ slug=$(basename "$f" .md)
+
+ if [ -n "$date" ]; then
+ echo "* $date [$file_title]($slug/)" >> "$index_md"
+ else
+ echo "* [$file_title]($slug/)" >> "$index_md"
+ fi
+ done
+
+ # Find subdirectories
+ find "$dir" -maxdepth 1 -type d ! -path "$dir" | sort | while read subdir; do
+ subdirname=$(basename "$subdir")
+ # Try to get title from subdir's index.md
+ if [ -f "$subdir/index.md" ]; then
+ subdir_title=$(extract_title "$subdir/index.md")
+ else
+ subdir_title=$(echo "$subdirname" | sed 's/[-_]/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
+ fi
+ echo "* [$subdir_title]($subdirname/)" >> "$index_md"
+ done
+
+ # Build the page
+ build_page "$index_md" "$output"
+
+ rm "$index_md"
+}
+
+extract_article_html() {
+ sed -n '/<article>/,/<\/article>/p' "$1"
+}
+
+# Generate blog index
+generate_blog_index() {
+ local blog_src="$INPUT_DIR/$BLOG_DIR"
+ local blog_dst="$OUTPUT_DIR/$BLOG_DIR"
+ local index_md
+
+ [ ! -d "$blog_src" ] && return
+
+ log "Generating blog index..."
+
+ index_md=$(mktemp)
+
+ echo "# Blog" > "$index_md"
+ echo "" >> "$index_md"
+ echo "[RSS Feed](feed.xml)" >> "$index_md"
+ echo "" >> "$index_md"
+
+ # Find all blog posts, sort by date descending
+ find "$blog_src" -name "*.md" ! -name "index.md" | while read f; do
+ date=$(extract_date "$f")
+ title=$(extract_title "$f")
+ slug=$(basename "$f" .md)
+
+ # Output: date|title|slug for sorting
+ echo "${date}|${title}|${slug}"
+ done | sort -r | while IFS='|' read date title slug; do
+ if [ "$CLEAN_URLS" = "yes" ]; then
+ echo "* $date [$title]($slug/)" >> "$index_md"
+ else
+ echo "* $date [$title]($slug.html)" >> "$index_md"
+ fi
+ done
+
+ # Build the index page
+ if [ "$CLEAN_URLS" = "yes" ]; then
+ build_page "$index_md" "$blog_dst/index.html"
+ else
+ build_page "$index_md" "$blog_dst.html"
+ fi
+
+ rm "$index_md"
+}
+
+# Generate RSS feed
+generate_rss() {
+ local rss_file="$OUTPUT_DIR/$BLOG_DIR/feed.xml"
+ local blog_src="$INPUT_DIR/$BLOG_DIR"
+
+ [ ! -d "$blog_src" ] && return
+ [ "$GENERATE_RSS" != "yes" ] && return
+
+ log "Generating RSS feed..."
+
+ mkdir -p "$(dirname "$rss_file")"
+
+ cat > "$rss_file" << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0">
+<channel>
+<title>${SITE_TITLE}</title>
+<link>${SITE_URL}</link>
+<description>${SITE_DESCRIPTION}</description>
+<language>en</language>
+EOF
+
+ # Add items
+ find "$blog_src" -name "*.md" ! -name "index.md" | while read f; do
+ date=$(extract_date "$f")
+ title=$(extract_title "$f")
+ slug=$(basename "$f" .md)
+ author=$(extra_author "$file")
+ [ -z "$author" ] && author="$AUTHOR"
+
+ echo "${date}|${title}|${slug}|${f}"
+done | sort -r | head -n 20 | while IFS='|' read date title slug file; do
+ if [ "$CLEAN_URLS" = "yes" ]; then
+ url="${SITE_URL}/${BLOG_DIR}/${slug}/"
+ else
+ url="${SITE_URL}/${BLOG_DIR}/${slug}.html"
+ fi
+
+ html_file="$OUTPUT_DIR/$BLOG_DIR/$slug/index.html"
+ body_html=$(extract_article_html "$html_file")
+
+ cat >> "$rss_file" << EOF
+<item>
+<title>${title}</title>
+<link>${url}</link>
+<guid>${url}</guid>
+<pubDate>${date}</pubDate>
+<dc:creator>${author}</dc:creator>
+<description><![CDATA[
+${body_html}
+]]></description>
+</item>
+EOF
+done
+
+ echo "</channel>" >> "$rss_file"
+ echo "</rss>" >> "$rss_file"
+}
+
+# Copy static assets
+copy_assets() {
+ log "Copying assets..."
+
+ for ext in $COPY_EXTENSIONS; do
+ find "$INPUT_DIR" -type f -name "*.$ext" | while read f; do
+ rel_path=$(echo "$f" | sed "s|^${INPUT_DIR}/||")
+ dst="$OUTPUT_DIR/$rel_path"
+
+ # Skip if matches ignore pattern
+ skip=0
+ for pattern in $IGNORE_PATTERNS; do
+ if echo "$rel_path" | grep -qE "$pattern"; then
+ skip=1
+ break
+ fi
+ done
+
+ [ $skip -eq 1 ] && continue
+
+ mkdir -p "$(dirname "$dst")"
+ cp "$f" "$dst"
+ log "Copied: $rel_path"
+ done
+ done
+}
+
+# Initialize output directory
+init_output() {
+ log "Initializing output directory..."
+ rm -rf "$OUTPUT_DIR"
+ mkdir -p "$OUTPUT_DIR"
+}
+
+# Build all pages
+build_all() {
+ log "Building pages..."
+
+ # First, build all existing markdown files
+ find "$INPUT_DIR" -type f -name "*.md" | while read f; do
+ rel_path=$(echo "$f" | sed "s|^${INPUT_DIR}/||" | sed 's/\.md$//')
+
+ # Skip if matches ignore pattern
+ skip=0
+ for pattern in $IGNORE_PATTERNS; do
+ if echo "$rel_path" | grep -qE "$pattern"; then
+ skip=1
+ break
+ fi
+ done
+
+ [ $skip -eq 1 ] && continue
+
+ # Handle index.md files specially (both root and subdirectory)
+ if echo "$rel_path" | grep -q '/index$'; then
+ # Subdirectory index: blog/index.md -> blog/index.html
+ dir_path=$(dirname "$rel_path")
+ if [ "$CLEAN_URLS" = "yes" ]; then
+ dst="$OUTPUT_DIR/$dir_path/index.html"
+ else
+ dst="$OUTPUT_DIR/$dir_path.html"
+ fi
+ elif [ "$rel_path" = "index" ]; then
+ # Root index: index.md -> index.html
+ dst="$OUTPUT_DIR/index.html"
+ elif [ "$CLEAN_URLS" = "yes" ]; then
+ dst="$OUTPUT_DIR/$rel_path/index.html"
+ else
+ dst="$OUTPUT_DIR/$rel_path.html"
+ fi
+
+ build_page "$f" "$dst"
+ done
+
+ # Now check for directories that need auto-generated indexes
+ find "$INPUT_DIR" -type d ! -path "$INPUT_DIR" | while read dir; do
+ rel_dir=$(echo "$dir" | sed "s|^${INPUT_DIR}/||")
+
+ # Skip assets directory
+ [ "$rel_dir" = "assets" ] && continue
+
+ # Skip if matches ignore pattern
+ skip=0
+ for pattern in $IGNORE_PATTERNS; do
+ if echo "$rel_dir" | grep -qE "$pattern"; then
+ skip=1
+ break
+ fi
+ done
+
+ [ $skip -eq 1 ] && continue
+
+ # Check if index.md exists
+ if [ ! -f "$dir/index.md" ]; then
+ # Generate auto-index
+ if [ "$CLEAN_URLS" = "yes" ]; then
+ dst="$OUTPUT_DIR/$rel_dir/index.html"
+ else
+ dst="$OUTPUT_DIR/$rel_dir.html"
+ fi
+
+ generate_directory_index "$dir" "$dst"
+ fi
+ done
+}
+
+# Main execution
+main() {
+ # Check for markdown processor
+ if ! command -v "$MD_PROCESSOR" > /dev/null 2>&1; then
+ error "Markdown processor '$MD_PROCESSOR' not found. Install it or change MD_PROCESSOR in web.conf"
+ fi
+
+ # Check templates exist
+ if [ ! -f "$TEMPLATE_DIR/header.html" ] || [ ! -f "$TEMPLATE_DIR/footer.html" ]; then
+ error "Templates not found in $TEMPLATE_DIR/"
+ fi
+
+ init_output
+ build_all
+ copy_assets
+ generate_rss
+
+ log "Done! Site built in $OUTPUT_DIR/"
+}
+
+main
diff --git a/templates/footer.html b/templates/footer.html
@@ -0,0 +1,7 @@
+<footer>
+ <div class="container">
+ <p>© 2026 {{AUTHOR}}. Built with <a href="https://git.chappelle.dev/verso2">verso2</a>.</p>
+ </div>
+ </footer>
+</body>
+</html>
diff --git a/templates/header.html b/templates/header.html
@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="author" content="{{AUTHOR}}">
+ <meta name="description" content="{{SITE_DESCRIPTION}}">
+ <title>{{TITLE}} - {{SITE_TITLE}}</title>
+ <link rel="stylesheet" href="/assets/style.css">
+ <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="/blog/feed.xml">
+</head>
+<body>
+ <header>
+ <div class="container">
+ <h1 class="site-title"><a href="/">{{SITE_TITLE}}</a></h1>
+ <nav>
+{{NAV}}
+ </nav>
+ </div>
+ </header>
+
+ <main class="container">
+ <article>
+ <header class="post-meta">
+ <h1>{{TITLE}}</h1>
+ <p class="meta">
+ <time>{{DATE}}</time>
+ ยท <span class="author">{{AUTHOR}}</span>
+ </p>
+ </header>
+ {{CONTENT}}
+ </article>
+ </main>
diff --git a/web.conf b/web.conf
@@ -0,0 +1,32 @@
+# web.conf - Configuration for sw web framework
+
+# Site metadata
+SITE_TITLE="Chappelle.dev"
+SITE_URL="https://chappelle.dev"
+SITE_DESCRIPTION="A simple website"
+AUTHOR="Nathaniel Chappelle"
+
+# Paths
+INPUT_DIR="content"
+OUTPUT_DIR="dist"
+TEMPLATE_DIR="templates"
+
+# Markdown processor (lowdown, cmark, markdown, discount, etc.)
+MD_PROCESSOR="lowdown"
+MD_FLAGS=""
+
+# File handling
+COPY_EXTENSIONS="jpg jpeg png gif svg pdf css js ico webp woff woff2 ttf"
+IGNORE_PATTERNS="^\. .*\.swp$ .*~$"
+
+# Features
+GENERATE_RSS="yes"
+GENERATE_SITEMAP="yes"
+CLEAN_URLS="yes" # page.md -> page/index.html
+
+# Date format
+DATE_FORMAT="%Y-%m-%d"
+
+# Blog settings
+BLOG_DIR="blog"
+POSTS_PER_PAGE="10"
