Switch from Cactus to PaperMod theme with Hugo Modules

- Replace Cactus git submodule with PaperMod via Hugo Modules
- Modernize GitHub Actions workflow to use native Pages deployment
- Convert projects list from data/projects.json to content/projects.md
- Update hugo.toml with PaperMod params (dark theme, social icons, etc.)
- Add AGENTS.md and CLAUDE.md for project guidance

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: inkless

.github/workflows/gh-pages.yml

@@ -1,34 +1,76 @@
-name: github pages
+name: Deploy Hugo to GitHub Pages
 
 on:
   push:
     branches:
-      - main # Set a branch to deploy
-  pull_request:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
 
 jobs:
-  deploy:
-    runs-on: ubuntu-22.04
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}
+  build:
+    runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: "0.155.2"
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
         with:
-          submodules: true # Fetch Hugo themes (true OR recursive)
-          fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
+          go-version: "1.23"
 
       - name: Setup Hugo
-        uses: peaceiris/actions-hugo@v2
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb
+          sudo dpkg -i ${{ runner.temp }}/hugo.deb
+
+      - name: Cache Hugo modules
+        uses: actions/cache@v4
         with:
-          hugo-version: "0.119.0"
-          extended: true
+          path: /tmp/hugo_cache
+          key: ${{ runner.os }}-hugomod-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-hugomod-
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
 
-      - name: Build
-        run: hugo --minify
+      - name: Build with Hugo
+        env:
+          HUGO_CACHEDIR: /tmp/hugo_cache
+          HUGO_ENVIRONMENT: production
+          TZ: America/Los_Angeles
+        run: |
+          hugo \
+            --gc \
+            --minify \
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
 
-      - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
-        if: github.ref == 'refs/heads/main'
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./public
+          path: ./public
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,2 +1,3 @@
 .hugo_build.lock
 public/
+.claude/*.local.*

.gitmodules

@@ -0,0 +1,30 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Personal blog/website at [guangda.me](https://guangda.me), built with Hugo using the PaperMod theme (dark mode). Deployed to GitHub Pages via GitHub Actions.
+
+## Commands
+
+- **Setup** (first time after clone): `hugo mod get`
+- **Dev server**: `hugo server -D` (includes drafts)
+- **Build**: `hugo --minify`
+- **New post**: `hugo new posts/<slug>.md`
+
+## Architecture
+
+- **Hugo version**: 0.155.2 (extended), pinned in `.github/workflows/gh-pages.yml`
+- **Theme**: PaperMod, installed via Hugo Modules (no git submodule)
+- **Content**: Markdown files in `content/` using `+++` TOML front matter (not `---` YAML)
+- **Projects list**: `content/projects.md` — a standalone markdown page listing projects
+- **Static assets**: `static/images/` for images, `static/CNAME` for custom domain
+- **Deployment**: Pushing to `main` triggers a GitHub Actions workflow that builds with Hugo and deploys directly to GitHub Pages (no `gh-pages` branch). Source: `actions/configure-pages` + `actions/deploy-pages`.
+
+## Content Conventions
+
+- Posts use TOML front matter with `title`, `author`, `date`, `lastmod`, `categories`, `draft` fields
+- The `about.md` page lives at `content/about.md` (not in posts)
+- Date format: `2006-01-02` (Go reference time)
+- Code highlighting: Dracula style with line numbers

AGENTS.md

@@ -0,0 +1 @@
+@AGENTS.md

CLAUDE.md

@@ -0,0 +1,15 @@
++++
+title = "Projects"
+date = 2021-07-06T23:17:00-07:00
+lastmod = 2025-01-27T00:00:00-07:00
+draft = false
++++
+
+- [Keevo](https://www.keevowallet.com/) — A crypto currency wallet
+- [Dotfiles](https://github.com/inkless/dotfiles) — My dotfiles
+- [Node.js U2F](https://github.com/inkless/u2f-host-node) — A node.js implementation of u2f protocol
+- [React starter kit](https://github.com/inkless/react-starter-kit) — Yet another react starter kit
+- [Electron starter](https://github.com/inkless/electron-react-redux-typescript) — A electron boilerplate with TypeScript, React, and redux
+- [WE framework](https://webenergy.github.io) — A FE framework used by shanda online
+- [Dragger](https://github.com/inkless/dragger) — A drag and drop library for PC and mobile
+- [Static sites](https://slides.guangda.me) — A collection of static sites/slides

content/projects.md

@@ -0,0 +1,5 @@
+module github.com/inkless/guangda.me
+
+go 1.25.7
+
+require github.com/adityatelange/hugo-PaperMod v0.0.0-20260125152547-3bb0ca281fd1 // indirect

go.mod

@@ -0,0 +1,2 @@
+github.com/adityatelange/hugo-PaperMod v0.0.0-20260125152547-3bb0ca281fd1 h1:nS0GAIWJZIxy1YWwGce18ePQHB7v1Y1sxUTOOrBAIeA=
+github.com/adityatelange/hugo-PaperMod v0.0.0-20260125152547-3bb0ca281fd1/go.mod h1:HCHxNMKYdGafUYjVV3ICiAqznZK2yH0iI53jqcDFDdQ=

go.sum

@@ -1,33 +1,41 @@
 baseURL = "https://guangda.me"
 languageCode = "en-us"
 title = "Guangda Zhang's space - 无墨阁"
-theme = "cactus"
 copyright = "Guangda Zhang"
 
+[module]
+  [[module.imports]]
+    path = "github.com/adityatelange/hugo-PaperMod"
+
+[[menu.main]]
+  name = "Home"
+  url = "/"
+  weight = 1
+
 [[menu.main]]
-name = "Home"
-url = "/"
-weight = 1
+  name = "Writings"
+  url = "/posts"
+  weight = 2
 
 [[menu.main]]
-name = "Writings"
-url = "/posts"
-weight = 2
+  name = "Projects"
+  url = "/projects"
+  weight = 3
 
 [[menu.main]]
-name = "Tags"
-url = "/tags"
-weight = 3
+  name = "Tags"
+  url = "/tags"
+  weight = 4
 
 [[menu.main]]
-name = "Categories"
-url = "/categories"
-weight = 4
+  name = "Categories"
+  url = "/categories"
+  weight = 5
 
 [[menu.main]]
-name = "About"
-url = "/about"
-weight = 5
+  name = "About"
+  url = "/about"
+  weight = 6
 
 [markup]
   [markup.tableOfContents]
@@ -41,46 +49,37 @@ weight = 5
     lineNoStart = 1
     lineNos = true
     lineNumbersInTable = false
-    noClasses = true
+    noClasses = false
     style = "dracula"
     tabWidth = 4
 
 [params]
-
-  colortheme = "dark" # dark, light, white, or classic
-  rss = true # generate rss feed. default value is false
-  googleAnalyticsAsync = true # use asynchronous tracking. Synchronous tracking by default
-  showAllPostsArchive = false # default
-  # gravatar = "zhangxiaoyu9350@gmail.com"
-
-  # Home page settings
+  defaultTheme = "dark"
+  ShowReadingTime = true
+  ShowShareButtons = false
+  ShowPostNavLinks = true
+  ShowBreadCrumbs = true
+  ShowCodeCopyButtons = true
+  DateFormat = "2006-01-02"
   description = "Welcome to my space, I will share my thoughts, life here."
-  mainSection = "posts" # your main section
-  showAllPostsOnHomePage = false # default
-  postsOnHomePage = 5 # this option will be ignored if showAllPostsOnHomePage is set to true
-  tagsOverview = true # show tags overview by default.
-  showProjectsList = true # show projects list by default (if projects data file exists).
-  projectsUrl = "https://github.com/inkless" # title link for projects list
-
-  # https://gohugo.io/functions/format/#hugo-date-and-time-templating-reference
-  dateFormat = "2006-01-02" # default
+  author = "Guangda Zhang"
+  mainSections = ["posts"]
 
-  # Post page settings
-  show_updated = true # default
-  showReadTime = true # default
+  [params.homeInfoParams]
+    Title = "Hi, I'm Guangda Zhang"
+    Content = "Welcome to my space, I will share my thoughts, life here."
 
-  [params.comments]
-    enabled = false # default
-    engine = "disqus" # more supported engines will be added.
+  [params.assets]
+    disableHLJS = true
 
-  # the value of name should be an valid font awesome icon name (brands type)
-  # https://fontawesome.com/icons?d=gallery&s=brands
-  [[params.social]]
+  [[params.socialIcons]]
     name = "github"
-    link = "https://github.com/inkless"
-  [[params.social]]
+    url = "https://github.com/inkless"
+
+  [[params.socialIcons]]
     name = "linkedin"
-    link = "https://www.linkedin.com/in/guangda-zhang/"
-  [[params.social]]
+    url = "https://www.linkedin.com/in/guangda-zhang/"
+
+  [[params.socialIcons]]
     name = "email"
-    link = "g@guangda.me"  # no need for "mailto:" in the head
+    url = "mailto:hi@guangda.me"