v3.0.2 ready

Author: rudolfjs

.changes/v3.0.2.md

@@ -0,0 +1,5 @@
+## v3.0.2 - 2025-10-01
+### Changed
+* README updated to reflect changes to GitHub actions
+### Removed
+* rust and `typst` install on GitHub actions

.github/workflows/hugo.yml

@@ -44,17 +44,6 @@ jobs:
           && sudo dpkg -i ${{ runner.temp }}/hugo.deb
       - name: Install Dart Sass
         run: sudo snap install dart-sass
-      - name: Install Rust and Typst
-        run: |
-          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
-          source "$HOME/.cargo/env"
-          cargo install --locked typst-cli
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-      - name: Render Typst code blocks
-        run: |
-          if [ -f scripts/render-typst.sh ]; then
-            bash scripts/render-typst.sh
-          fi
       - name: Build with Hugo (panic on warnings)
         env:
           HUGO_ENVIRONMENT: production
@@ -73,12 +62,6 @@ jobs:
           && sudo dpkg -i ${{ runner.temp }}/hugo.deb
       - name: Install Dart Sass
         run: sudo snap install dart-sass
-      - name: Install Rust and Typst
-        run: |
-          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
-          source "$HOME/.cargo/env"
-          cargo install --locked typst-cli
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
       - name: Checkout
         uses: actions/checkout@v4
         with:
@@ -89,11 +72,6 @@ jobs:
         uses: actions/configure-pages@v5
       - name: Install Node.js dependencies
         run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
-      - name: Render Typst code blocks
-        run: |
-          if [ -f scripts/render-typst.sh ]; then
-            bash scripts/render-typst.sh
-          fi
       - name: Build with Hugo
         env:
           HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache

CHANGELOG.md

@@ -6,6 +6,12 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 and is generated by [Changie](https://github.com/miniscruff/changie).
 
 
+## v3.0.2 - 2025-10-01
+### Changed
+* README updated to reflect changes to GitHub actions
+### Removed
+* rust and `typst` install on GitHub actions
+
 ## v3.0.1 - 2025-10-01
 ### Changed
 * Fixed .gitignore to allowed rendered PDFs for posts

README.md

@@ -49,17 +49,21 @@ Control how code blocks are displayed vs rendered using attributes:
 
 #### Rendering Typst Outputs
 
-To generate PNG images for Typst code blocks marked with `{.render}` or `{.side-by-side}`:
+**IMPORTANT: Typst rendering MUST be done locally before pushing to GitHub.**
+
+GitHub Actions does NOT render Typst files. You must generate and commit the PNG outputs locally.
+
+To generate PNG/PDF files for Typst code blocks marked with `{.render}` or `{.side-by-side}`:
 
 ```bash
 bash scripts/render-typst.sh
 ```
 
 This script will:
 - Scan all markdown files for Typst code blocks that need rendering
-- Compile them using the Typst CLI to PNG images
-- Save outputs to `static/rendered/typst/{page-slug}/typst-{hash}.png`
-- Cache previously rendered images (won't re-render if unchanged)
+- Compile them using the Typst CLI to PNG or PDF files (PDF for multi-page documents)
+- Save outputs to `static/rendered/typst/{page-slug}/typst-{hash}.png` or `.pdf`
+- Cache previously rendered files (won't re-render if unchanged)
 
 ## Content Publishing Workflow
 
@@ -71,7 +75,7 @@ This script will:
    # Edit the file, add Typst code blocks with {.render} or {.side-by-side}
    ```
 
-2. **Generate Typst PNG outputs:**
+2. **Generate Typst PNG/PDF outputs:**
    ```bash
    bash scripts/render-typst.sh
    ```
@@ -97,7 +101,8 @@ This script will:
 3. Commit and push
 
 ### Important Notes:
-- **Always commit the generated PNG files** - They must be in the repository for GitHub Pages to serve them
+- **REQUIRED: Render Typst locally before pushing** - GitHub Actions does NOT have Typst installed
+- **Always commit the generated PNG/PDF files** - They must be in the repository for GitHub Pages to serve them
 - The render script uses caching - only re-renders changed content
 - Raw Typst code blocks (` ```typst `) don't need the script, they just show syntax-highlighted code
 - Mermaid diagrams work without scripts (rendered client-side)