How hung2124/blog works
Project type and purpose
• This is a static site generator project: a content-first AI blog template built with the Astro framework.
• Purpose: Manage Markdown/MDX content, render it through reusable components & layouts, style via Tailwind, and deploy a high-performance, SEO-optimized blog.
File structure
• Top-level:
• public/ – purely static assets (images, favicon).
• src/ – source code, subdivided into:
– content/ (Markdown posts & spec pages)
– components/ (UI building blocks, subfolders: control, misc, widget)
– layouts/ (page scaffolding)
– pages/ (Astro route files generating URLs)
– plugins/ (remark/rehype/Expressive-Code extensions)
– styles/ (global, markdown, themes)
– utils/, constants/, types/ (helper functions, TS types)
– i18n/ (multi-language translations)
– config.ts (site, navigation, profile settings)
• Config/build files:
• astro.config.mjs, package.json, tailwind.config.cjs, tsconfig.json, .github/workflows/static.yml.
README for additional insights
• Architecture is centered around Static Site Generation (SSG) using Astro + Vite/ESBuild.
• Features: content pipeline (Markdown → syntax highlighting → KaTeX → HTML), styling (Tailwind), search (Pagefind), CI/CD (GitHub Actions → GitHub Pages/Vercel).
Detail, not over-complication
• Every essential directory as a logical component (Content, Components, Styles, Plugins).
• Plugin chain (remark → rehype → KaTeX) as a sub-pipeline.
• Hosting targets (GitHub Pages, Vercel) under deployment.