Merge pull request 'Add Forgejo Actions and documentation' (#1) from feature/add-github-actions into main

Reviewed-on: #1

.forgejo/workflows/build.yml

@@ -0,0 +1,33 @@
+name: Build Site
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: self-hosted
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      
+      - name: Setup Hugo
+        uses: https://github.com/peaceiris/actions-hugo@v3
+        with:
+          hugo-version: 'latest'
+          extended: true
+      
+      - name: Build Hugo site
+        run: hugo --minify
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: hugo-build
+          path: public/
+          retention-days: 7

.forgejo/workflows/deploy.yml

@@ -0,0 +1,37 @@
+name: Deploy to S3
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: self-hosted
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      
+      - name: Setup Hugo
+        uses: https://github.com/peaceiris/actions-hugo@v3
+        with:
+          hugo-version: 'latest'
+          extended: true
+      
+      - name: Build Hugo site
+        run: hugo --minify
+      
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws-region: us-east-1
+      
+      - name: Deploy to S3
+        run: |
+          aws s3 sync public/ s3://${{ secrets.S3_BUCKET_NAME }} --delete --no-cli-pager

CLAUDE.md

@@ -0,0 +1,74 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Hugo static site generator project for "The Angry Michigander" blog. The site uses the Lynx theme (github.com/jpanther/lynx) via Hugo modules.
+
+## Development Commands
+
+- **Local development**: `hugo server -D` (serves locally with drafts)
+- **Build for production**: `hugo --minify` (outputs to `public/` directory)
+- **Build regular**: `hugo` (outputs to `public/` directory)
+
+## Architecture
+
+- **Framework**: Hugo static site generator with Go modules
+- **Theme**: Lynx theme (github.com/jpanther/lynx v1.4.0) imported as Hugo module
+- **Configuration**: hugo.yaml (main config file)
+- **Content**: Markdown files in `content/` directory
+- **Static assets**: `static/` directory for static files
+- **Build output**: `public/` directory (generated, not tracked in git)
+
+## Key Files and Directories
+
+- `hugo.yaml` - Main Hugo configuration
+- `go.mod` - Go module dependencies for Hugo modules
+- `content/` - Markdown content files
+- `archetypes/` - Content templates (default.md, post.md)
+- `layouts/partials/` - Custom layout overrides
+- `static/` - Static assets
+- `assets/` - Source assets (CSS, images)
+
+## CI/CD
+
+The project has dual CI/CD setup:
+- **GitHub Actions**: `.github/workflows/` (ubuntu-latest runner)
+- **Forgejo Actions**: `.forgejo/workflows/` (self-hosted runner)
+
+Both include build and deploy workflows that:
+1. Check out code with submodules
+2. Set up Hugo extended version
+3. Build with `hugo --minify`
+4. Upload artifacts to `public/` directory
+
+## Forgejo Integration
+
+This project uses Forgejo for source control. Use the `tea` CLI tool (https://gitea.com/gitea/tea) for Forgejo operations instead of `gh` CLI:
+
+- **Setup**: `tea login add` (first-time setup)
+- **List pull requests**: `tea pulls` or `tea pulls list`
+- **Create pull request**: `tea pulls create`
+- **View pull request**: `tea pulls [PR index]`
+- **Merge pull request**: `tea pulls merge [PR index]`
+- **List issues**: `tea issues` or `tea issues list`
+- **Create issue**: `tea issues create`
+- **View issue**: `tea issues [issue index]`
+
+Always prefer `tea` commands over `gh` commands when working with this repository's Forgejo instance.
+
+## Theme Customization
+
+The Lynx theme is used via Hugo modules. Custom overrides can be placed in:
+- `layouts/` - Layout overrides
+- `assets/css/custom.css` - Custom CSS
+- `static/` - Static file overrides
+
+## Content Creation
+
+Use archetypes for new content:
+- `archetypes/default.md` - Default content template
+- `archetypes/post.md` - Blog post template with extensive frontmatter options
+
+Create new posts with: `hugo new posts/my-post.md`