refactor: pass site-dir between actions and use mv for built site

- Add site-dir output to build-docs action
- Add site-dir input to deploy-to-gh-pages action
- Use mv instead of cp for built site
- Move touch .nojekyll next to git add

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: TaiSakuma

.github/actions/build-docs/action.yml

@@ -6,12 +6,17 @@ inputs:
     description: Subdirectory to deploy to (e.g., dev, 1.0.0, pr/3)
     required: true
 
+outputs:
+  site-dir:
+    description: Path to the built site
+    value: /tmp/built-site
+
 runs:
   using: composite
   steps:
     - shell: bash
       run: |
         uv run --group docs python .github/scripts/override_site_url.py "${{ inputs.subdir }}"
         uv run --group docs zensical build --clean
-        cp -r site /tmp/built-site
+        mv site /tmp/built-site
         git checkout -- zensical.toml

.github/actions/deploy-to-gh-pages/action.yml

@@ -2,6 +2,9 @@ name: Deploy to gh-pages
 description: Deploy built docs to a subdirectory on gh-pages
 
 inputs:
+  site-dir:
+    description: Path to the built site
+    required: true
   target:
     description: Subdirectory to deploy to
     required: true
@@ -31,10 +34,10 @@ runs:
           git rm -rf .
           git clean -fd
         fi
-        touch .nojekyll
         rm -rf "$TARGET"
         mkdir -p "$(dirname "$TARGET")"
-        cp -r /tmp/built-site "$TARGET"
+        cp -r "${{ inputs.site-dir }}" "$TARGET"
+        touch .nojekyll
         git add .nojekyll "$TARGET"
         git diff --cached --quiet || git commit -m "${{ inputs.commit-message }}"
         git push origin gh-pages

.github/workflows/docs-pr-preview.yml

@@ -21,12 +21,14 @@ jobs:
       - uses: astral-sh/setup-uv@v7
 
       - uses: ./.github/actions/build-docs
+        id: build
         with:
           subdir: pr/${{ github.event.number }}
 
       - uses: ./.github/actions/deploy-to-gh-pages
         id: deploy
         with:
+          site-dir: ${{ steps.build.outputs.site-dir }}
           target: pr/${{ github.event.number }}
           commit-message: "Deploy PR #${{ github.event.number }} preview"
 

.github/workflows/docs-release.yml

@@ -32,19 +32,21 @@ jobs:
       - uses: astral-sh/setup-uv@v7
 
       - uses: ./.github/actions/build-docs
+        id: build
         with:
           subdir: ${{ steps.version.outputs.version }}
 
       - uses: ./.github/actions/deploy-to-gh-pages
         with:
+          site-dir: ${{ steps.build.outputs.site-dir }}
           target: ${{ steps.version.outputs.version }}
           commit-message: Deploy docs for v${{ steps.version.outputs.version }}
 
       - name: Update latest and index.html
         run: |
           TARGET="${{ steps.version.outputs.version }}"
           rm -rf latest
-          cp -r /tmp/built-site latest
+          cp -r "${{ steps.build.outputs.site-dir }}" latest
           # Generate root index.html
           REPO_NAME="${{ github.event.repository.name }}"
           {

.github/workflows/docs.yml

@@ -21,10 +21,12 @@ jobs:
       - uses: astral-sh/setup-uv@v7
 
       - uses: ./.github/actions/build-docs
+        id: build
         with:
           subdir: dev
 
       - uses: ./.github/actions/deploy-to-gh-pages
         with:
+          site-dir: ${{ steps.build.outputs.site-dir }}
           target: dev
           commit-message: Deploy dev docs