Blog Site - Technical Overview
Welcome to the technical documentation for the IoT Blog project. This site covers the architecture, setup, and features of our decoupled blogging system.
🏗️ 4-Repository Architecture
Section titled “🏗️ 4-Repository Architecture”The project is split into four separate repositories to ensure clean separation of concerns:
- System Architecture - Deep dive into how the repos interact.
- blog-code - The UI Engine & Theme.
- blog-content - Private blog posts and assets.
- blog-comments - Stores blog user comment entries “abusing” github discussions.
- blog-docs - Universal repo for this and other project (e.g. railroad) documentation. Called
blog-docs(rather than justdocs) for historic reasons.
📚 Feature Documentation
Section titled “📚 Feature Documentation”- Installation & Setup - How to get the theme engine running.
- Deployment Pipeline - Native Astro automated build and deployment process.
- Cloudflare Authentication - Zero Trust hierarchical access control.
- Comments - GitHub Discussions-backed Giscus integration.
- Search - Privacy-preserving static site search.
- Client-Side Translation - On-demand translation features.
- VSCode Image Paste - Seamless image authoring workflow.
- Jupyter Notebooks - Writing posts using Jupyter.
🛠️ Development & Authoring
Section titled “🛠️ Development & Authoring”- Environment Variables - Full list of supported configuration variables.
- Authoring Guide - How to add and edit these docs.