Move zk cards to docs/zk/ for documentation restructuring (#84)
## Summary - Move all existing zettelkasten cards from `docs/` to `docs/zk/` as a temporary holding area - Update `zk-docs` mise task to look in the new location - Add `docs/README.md` explaining the Diataxis-based restructuring plan and target audiences ## Context This is phase 1 of a multi-phase documentation restructuring effort. The goal is to reorganize docs to follow the Diataxis framework while serving multiple audiences: 1. Erich (owner) - knowledge graph/zk 2. Claude/AI agents - memory and context enrichment 3. New external readers - high-level overview 4. Potential operators/contributors - onboarding 5. Replicators - people wanting to duplicate the approach ## Testing - [x] Verified `mise run zk-docs` still works with the new path - [x] Updated obsidian.nvim config (in ~/.config/nvim) to point to new path ## Note The obsidian.nvim config change is outside this repo but was made as part of this work. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/84
This commit is contained in:
parent
737371ab59
commit
b8104d75ad
30 changed files with 529 additions and 3 deletions
52
containers/quartz/Dockerfile
Normal file
52
containers/quartz/Dockerfile
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
# Quartz Static Site Server
|
||||
# Downloads and serves a Quartz-built static site from a release bundle
|
||||
#
|
||||
# Configuration (via environment):
|
||||
# DOCS_RELEASE_URL - URL to download the static site tarball
|
||||
#
|
||||
# The container downloads the tarball on startup, extracts it, and serves with nginx.
|
||||
|
||||
FROM nginx:alpine
|
||||
|
||||
# Install curl for downloading release assets
|
||||
RUN apk add --no-cache curl
|
||||
|
||||
# Copy startup script
|
||||
COPY start.sh /start.sh
|
||||
RUN chmod +x /start.sh
|
||||
|
||||
# Custom nginx config for SPA routing
|
||||
RUN cat > /etc/nginx/conf.d/default.conf << 'EOF'
|
||||
server {
|
||||
listen 80;
|
||||
server_name _;
|
||||
root /usr/share/nginx/html;
|
||||
index index.html;
|
||||
|
||||
# Enable gzip compression
|
||||
gzip on;
|
||||
gzip_types text/plain text/css application/json application/javascript text/xml application/xml text/javascript;
|
||||
|
||||
# Cache static assets
|
||||
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
|
||||
# SPA fallback - serve index.html for client-side routing
|
||||
location / {
|
||||
try_files $uri $uri/ $uri.html /index.html;
|
||||
}
|
||||
|
||||
# Health check endpoint
|
||||
location /healthz {
|
||||
access_log off;
|
||||
return 200 "ok\n";
|
||||
add_header Content-Type text/plain;
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
EXPOSE 80
|
||||
|
||||
CMD ["/start.sh"]
|
||||
31
containers/quartz/start.sh
Normal file
31
containers/quartz/start.sh
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
#!/bin/sh
|
||||
set -e
|
||||
|
||||
HTML_DIR="/usr/share/nginx/html"
|
||||
|
||||
# Check for required environment variable
|
||||
if [ -z "$DOCS_RELEASE_URL" ]; then
|
||||
echo "Error: DOCS_RELEASE_URL environment variable is required"
|
||||
echo "Set it to the URL of the static site tarball to serve"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "Downloading docs from: $DOCS_RELEASE_URL"
|
||||
|
||||
# Download the tarball
|
||||
if ! curl -fsSL "$DOCS_RELEASE_URL" -o /tmp/docs.tar.gz; then
|
||||
echo "Error: Failed to download docs from $DOCS_RELEASE_URL"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Clear existing content and extract
|
||||
rm -rf "${HTML_DIR:?}"/*
|
||||
echo "Extracting docs to $HTML_DIR"
|
||||
tar -xzf /tmp/docs.tar.gz -C "$HTML_DIR"
|
||||
rm /tmp/docs.tar.gz
|
||||
|
||||
echo "Docs extracted successfully"
|
||||
echo "Starting nginx..."
|
||||
|
||||
# Start nginx in foreground
|
||||
exec nginx -g "daemon off;"
|
||||
Loading…
Add table
Add a link
Reference in a new issue