Guard Pages workflow on github.server_url (#6)

katexOptions omitted `output`, though the option spread already honours it. A site can now ask for "htmlAndMathml" so screen readers get MathML; the default stays "html".

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

.github/workflows/ci.yaml

@@ -11,7 +11,7 @@ jobs:
   build-and-test:
     strategy:
       matrix:
-        os: [ubuntu-latest]
+        os: [docker]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4

.github/workflows/quartz-pages.yml

@@ -33,7 +33,11 @@ jobs:
           repository: GameCult/GameCult-Quartz
           path: GameCult-Quartz
 
+      # Pages actions exist only on GitHub: the forge runner resolves actions
+      # from data.forgejo.org, which has no actions/configure-pages, so the job
+      # failed there. Build always; touch Pages only on the GitHub mirror.
       - name: Configure Pages
+        if: github.server_url == 'https://github.com'
         uses: actions/configure-pages@v5
 
       - name: Setup Node
@@ -56,11 +60,13 @@ jobs:
           --outputDir "${{ inputs.output-dir }}"
 
       - name: Upload Pages artifact
+        if: github.server_url == 'https://github.com'
         uses: actions/upload-pages-artifact@v3
         with:
           path: ${{ inputs.output-dir }}
 
   deploy:
+    if: github.server_url == 'https://github.com'
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}

quartz/plugins/emitters/ogImage.tsx

@@ -98,7 +98,7 @@ async function generateSocialImage(
     imageBase64,
   })
 
-  const svg = await satori(imageComponent, {
+  const svg = await satori(imageComponent as unknown as Parameters<typeof satori>[0], {
     width,
     height,
     fonts,

quartz/plugins/transformers/latex.ts

@@ -12,7 +12,8 @@ import { Options as TypstOptions } from "@myriaddreamin/rehype-typst"
 interface Options {
   renderEngine: "katex" | "mathjax" | "typst"
   customMacros: MacroType
-  katexOptions: Omit<KatexOptions, "macros" | "output">
+  // `output` defaults to "html"; "htmlAndMathml" adds MathML for screen readers (KaTeX hides it visually).
+  katexOptions: Omit<KatexOptions, "macros">
   mathJaxOptions: Omit<MathjaxOptions, "macros">
   typstOptions: TypstOptions
 }