Add complete markdown-to-HTML compilation pipeline and automated sync orchestrator: - docs-compile.sh: Compiles markdown to HTML with .docignore filtering, version naming (docs-v0.9.0_20260324), and automatic index generation - docs-sync.cron.sh: Orchestrator for automated daily sync (05:00 UTC): git pull, compile, validate, atomic symlink swap, cleanup old versions (30-day retention) - VERSIONING.md: Architecture guide explaining symlink-based zero-downtime deployments with instant rollback capability - DOCUMENTATION-POLICY.md: Policy establishing markdown as single source of truth, git rules, sync procedures, monitoring guidelines - .docignore: Filtering rules excluding internal/sensitive docs from public sites - .sync-metadata.json: Metadata tracking for sync automation and monitoring - Pre-commit hook: Appended documentation validation checks No external dependencies required (no pandoc/pandoc). HTML wrapper uses pure shell with simple markdown syntax conversion. Tested with 28 markdown source files. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> --- Build: pass | Tests: FAIL — Tests 2 failed | 487 passed | 10 skipped (499) |
||
|---|---|---|
| .. | ||
| clawdie | ||
| docs-clawdie-si | ||
| osa | ||
| README.md | ||
HTML Website Sources
This directory contains the source files for Clawdie-hosted websites.
Structure
html/
├── clawdie/ # https://clawdie.si
│ ├── index.html
│ ├── css/
│ ├── docs/
│ └── screenshots/
└── osa/ # https://osa.smilepowered.org
└── index.html
Deployment
Files are deployed manually to nginx webroots:
# Deploy clawdie.si
cp html/clawdie/index.html /usr/local/www/clawdie/
cp -r html/clawdie/screenshots /usr/local/www/clawdie/
# Deploy osa.smilepowered.org
cp html/osa/index.html /usr/local/www/osa/
Future: Astro Migration
These hand-edited HTML files will be migrated to Astro components.
See .agent/skills/astro/SKILL.md for the migration plan.
site/directory will contain the Astro projectnpm run buildwill output to/usr/local/www/clawdie/- This
html/directory will become a reference/archive
Notes
- Both sites share similar CSS structure (Cormorant Garamond + DM Mono)
- clawdie.si: Dark theme (
--cream: #0d1117) - osa.smilepowered.org: Light theme (
--cream: #f5f0e8)