Category: Architecture

  • Building a Git-Versioned Digital Garden with WordPress, Docker & Tailscale

    Building a Git-Versioned Digital Garden with WordPress, Docker & Tailscale

    A fast, Git-versioned, Markdown-first personal knowledge base and digital garden powered by WordPress, Docker, and Tailscale.


    Obsidian & Markdown Compatibility

    Write notes locally in your favorite editor (like Obsidian). All <a href="/wikilinks/" class="internal-link" data-slug="wikilinks">wikilinks</a>, callouts, code blocks, and math formulas automatically compile into this live site.


    🏗️ System Architecture (Mermaid.js Flowchart)

    Here is how local Markdown files automatically flow into this live site:

    graph TD
        A[📝 Local Markdown / Obsidian] -->|git commit & push| B[🐙 GitHub Repository]
        A -->|uv run scripts/sync.py| C[⚡ WP-CLI Engine]
        C -->|Auto-provision & Upsert| D[(🐬 MariaDB 11.4)]
        D -->|Render PHP 8.3 & HTML| E[🔒 Caddy Reverse Proxy]
        E -->|HTTPS / Tailscale| F[🌐 Reader / Web Browser]
    

    📐 Mathematical Equations (KaTeX LaTeX)

    Supports both inline equations like $E = mc^2$ and Euler’s formula $e^{i\pi} + 1 = 0$, as well as block LaTeX equations:

    $$\sum_{k=1}^{n} k^2 = \frac{n(n+1)(2n+1)}{6}$$


    🌿 Digital Garden Interconnections

    Explore connected notes and thoughts across the garden:
    – Read the Getting Started with Markdown guide.
    – Check out the About This Site page.


    Explore The Garden

    Use the 🗂️ Filetree Explorer on the left to browse all pages and articles, press Ctrl + K to search instantly, or explore the interactive force graph below!

🌐 Global Interactive Graph View
Fullscreen image