ci(website): automates Hugo build and deployment

Introduces a GitHub Actions workflow to build the wiki and deploy it to the project's GitHub Pages repository. Ensures the live site stays in sync with changes in the main repository while keeping build artifacts out of version control. Provides documentation on the deployment process and necessary repository secrets.

Author: jackfromeast

.github/workflows/deploy-website.yml

@@ -0,0 +1,45 @@
+name: Deploy Website
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'website/**'
+      - '.github/workflows/deploy-website.yml'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v4
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: '0.161.1'
+          extended: true
+
+      - name: Build wiki
+        run: |
+          cd website/source
+          hugo --baseURL="/wiki/" --destination="../wiki"
+
+      - name: Stage publish directory
+        run: |
+          mkdir -p _publish
+          cp -r website/index.html website/img website/wiki _publish/
+          if [ -f website/README.md ]; then cp website/README.md _publish/; fi
+
+      - name: Deploy to class-pollution.github.io
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          personal_token: ${{ secrets.DEPLOY_TOKEN }}
+          external_repository: class-pollution/class-pollution.github.io
+          publish_branch: main
+          publish_dir: ./_publish
+          force_orphan: true
+          user_name: 'github-actions[bot]'
+          user_email: 'github-actions[bot]@users.noreply.github.com'
+          commit_message: 'Deploy website from python-class-pollution@${{ github.sha }}'

.gitignore

@@ -17,4 +17,7 @@ output/**
 node_modules
 .claude
 .vscode
-dataset/github/python-20141001-20241001-star-100-1K.json
+dataset/github/python-20141001-20241001-star-100-1K.json
+
+# Generated wiki output (built from website/source/ by Hugo CI)
+website/wiki/

website/README.md

@@ -40,3 +40,12 @@ hugo --baseURL="/wiki/" --destination="../wiki"
 ```
 
 This generates the static site under `website/wiki/`.
+
+## Deployment
+
+The site is deployed to <https://class-pollution.github.io> via the GitHub Actions workflow at `.github/workflows/deploy-website.yml`. On every push to `main` that touches `website/`, the workflow:
+
+1. Builds the wiki with Hugo into `website/wiki/`
+2. Pushes `index.html`, `img/`, and `wiki/` to the `class-pollution/class-pollution.github.io` repo
+
+The workflow uses a `DEPLOY_TOKEN` repository secret (a fine-grained PAT with write access to the target repo).