gioiazheng.github.io

Source for gioiazheng.github.io — personal technical site. Static, content-first, no analytics, no trackers.

Stack

• Astro v7, content collections + Markdown
• Vanilla CSS, no UI framework
• Deployed to GitHub Pages via the official actions/deploy-pages action

Quickstart

Requires Node >=22.12.0 (pinned to 22.14.0 in .nvmrc).

git clone https://github.com/GioiaZheng/GioiaZheng.github.io.git
cd GioiaZheng.github.io

npm install
npm run dev      # local server on http://localhost:4321
npm run build    # production build into ./dist
npm run preview  # serve ./dist locally

Expected output:

Local: http://localhost:4321/

Editing content

Content lives under src/content/ as Markdown with frontmatter — the schema is in src/content.config.ts.

• Projects → src/content/projects/<slug>.md. Required fields: title, summary, order, status, optional repo / featured / tags.
• Writing → src/content/writing/<slug>.md. Required fields: title, summary, status (draft / planned / published).

Adding a file is enough — the routes at /projects/<slug>/ and /writing/<slug>/ are generated from the collection.

Site structure

src/
  layouts/Base.astro           # html wrapper, header, footer
  components/                  # Nav, Footer
  pages/
    index.astro                # home
    projects/index.astro       # projects list
    projects/[slug].astro      # one project per markdown file
    writing/index.astro        # writing list
    writing/[slug].astro       # one note per markdown file
    contact.astro
  content.config.ts            # collection schemas
  content/
    projects/*.md
    writing/*.md
  styles/global.css            # all site styles
public/
  cv/Gioia_Zheng_CV.pdf        # served at /cv/Gioia_Zheng_CV.pdf

Deployment

Push to main. The workflow in .github/workflows/deploy.yml builds the site and publishes the dist/ artifact to Pages.

Repository setting required once: Settings → Pages → Source → GitHub Actions.