fixup! fixup! feat(ci): add lychee broken link test

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

Author: skjnldsv

.github/workflows/sphinxbuild.yml

@@ -44,7 +44,6 @@ jobs:
         sudo chown -R $(id -u):$(id -g) /tmp/apt/cache/archives
 
   build:
-
     name: Build ${{ matrix.manual.name }}
     runs-on: ubuntu-latest
     needs: setup-latex-cache
@@ -170,98 +169,96 @@ jobs:
       version_name: ${{ steps.branch.outputs.version_name }}
 
     steps:
-    - name: Cache git metadata
-      uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
-      with:
-        path: .git
-        key: git-metadata-${{ github.sha }}
-        restore-keys: |
-          git-metadata-${{ github.sha }}
-          git-metadata
+      - name: Download all artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: artifacts/
+
+      - name: Get branch name and find latest stable
+        id: branch
+        run: |
+          current_branch="${GITHUB_REF#refs/heads/}"
+
+          # Find the highest numbered stable branch from the remote
+          highest_stable=$(git ls-remote --heads origin | sed -n 's?.*refs/heads/stable\([0-9]\{2\}\)$?\1?p' | sort -n | tail -1)
+          highest_stable_branch="stable${highest_stable}"
+
+          echo "Current branch: $current_branch"
+          echo "Highest stable branch found: $highest_stable_branch"
+
+          # Map actual branch names to deployment folder names
+          case "$current_branch" in
+            "master")
+              echo "branch_name=latest" >> $GITHUB_OUTPUT
+              ;;
+            "$highest_stable_branch")
+              echo "branch_name=stable" >> $GITHUB_OUTPUT
+              # Also record the numeric version so we can publish to server/<number>/ too
+              echo "version_name=${highest_stable}" >> $GITHUB_OUTPUT
+              ;;
+            *)
+              # Remove stable prefix for current branch
+              current_branch="${current_branch#stable}"
+              echo "branch_name=$current_branch" >> $GITHUB_OUTPUT
+              ;;
+          esac
+
+          echo "Deployment folder name: ${{ steps.branch.outputs.branch_name }}"
+          echo "Version name for additional deployment (if applicable): ${{ steps.branch.outputs.version_name }}"
+
+      - name: Merge ${{ steps.branch.outputs.branch_name }} documentation artifacts into gh-pages
+        run: |
+          # List artifacts
+          ls -la artifacts/*/
+
+          # Cleanup old documentation
+          rm -rf ${{ steps.branch.outputs.branch_name }}
+          rm -rf server/${{ steps.branch.outputs.branch_name }}
+          mkdir -p server/${{ steps.branch.outputs.branch_name }}
+
+          # Copy all built documentation into dedicated subdirectories
+          for artifact in artifacts/*; do
+            if [ -d "$artifact" ]; then
+              manual_name="$(basename "$artifact")"
+              mkdir -p "server/${{ steps.branch.outputs.branch_name }}/$manual_name"
+              cp -r "$artifact/"* "server/${{ steps.branch.outputs.branch_name }}/$manual_name/"
+            fi
+          done
+
+          # Move pdf files to the root of the branch_name
+          mv server/${{ steps.branch.outputs.branch_name }}/*/*.pdf server/${{ steps.branch.outputs.branch_name }}/ || true
+
+          # If this is the highest stable branch, also deploy to its versioned folder
+          if [ -n "${{ steps.branch.outputs.version_name }}" ]; then
+            rm -rf server/${{ steps.branch.outputs.version_name }}
+            cp -r server/${{ steps.branch.outputs.branch_name }} server/${{ steps.branch.outputs.version_name }}
+          fi
+
+          # Cleanup
+          find . -type d -empty -delete
+          rm -rf artifacts
+
+      - name: Add various redirects for go.php and user_manual english version
+        run: |
+          # Fetch source branches so git checkout origin/... works from the gh-pages checkout
+          git fetch origin ${{ github.event.repository.default_branch }} ${{ github.ref_name }}
+
+          # Generate go.php redirect from main branch
+          git checkout origin/${{ github.event.repository.default_branch }} -- go.php/index.html
+          mkdir -p server/${{ steps.branch.outputs.branch_name }}/go.php
+          mv go.php/index.html server/${{ steps.branch.outputs.branch_name }}/go.php/index.html
+
+          # Generate user_manual english redirect
+          git checkout origin/${{ github.ref_name }} -- user_manual/index.html
+          mkdir -p server/${{ steps.branch.outputs.branch_name }}/user_manual
+          mv user_manual/index.html server/${{ steps.branch.outputs.branch_name }}/user_manual/index.html
+
+      - name: Upload staged site
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
+        with:
+          name: staged-site
+          path: server/
 
-    - name: Checkout gh-pages (for redirect sources)
-      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      with:
-        ref: gh-pages
-        fetch-depth: 0
-        token: ${{ secrets.COMMAND_BOT_PAT }}
-
-    - name: Download all ${{ needs.build.outputs.branch_name }} artifacts
-      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-      with:
-        path: artifacts/
-
-    - name: Get branch name and find latest stable
-      id: branch
-      run: |
-        current_branch="${GITHUB_REF#refs/heads/}"
-
-        # Find the highest numbered stable branch from the remote
-        highest_stable=$(git ls-remote --heads origin | sed -n 's?.*refs/heads/stable\([0-9]\{2\}\)$?\1?p' | sort -n | tail -1)
-        highest_stable_branch="stable${highest_stable}"
-
-        echo "Current branch: $current_branch"
-        echo "Highest stable branch found: $highest_stable_branch"
-
-        # Map actual branch names to deployment folder names
-        case "$current_branch" in
-          "master")
-            echo "branch_name=latest" >> $GITHUB_OUTPUT
-            ;;
-          "$highest_stable_branch")
-            echo "branch_name=stable" >> $GITHUB_OUTPUT
-            # Also record the numeric version so we can publish to server/<number>/ too
-            echo "version_name=${highest_stable}" >> $GITHUB_OUTPUT
-            ;;
-          *)
-            # Remove stable prefix for current branch
-            current_branch="${current_branch#stable}"
-            echo "branch_name=$current_branch" >> $GITHUB_OUTPUT
-            ;;
-        esac
-
-        echo "Deployment folder name: ${{ steps.branch.outputs.branch_name }}"
-        echo "Version name for additional deployment (if applicable): ${{ steps.branch.outputs.version_name }}"
-
-    - name: Merge ${{ steps.branch.outputs.branch_name }} documentation artifacts into gh-pages
-      run: |
-        # Remove old documentation for this branch
-        rm -rf server/${{ steps.branch.outputs.branch_name }}
-        mkdir -p server/${{ steps.branch.outputs.branch_name }}
-        
-        # Move each manual's HTML output into the branch directory structure
-        mv artifacts/user_manual/* server/${{ steps.branch.outputs.branch_name }}/ || true
-        mv artifacts/admin_manual/* server/${{ steps.branch.outputs.branch_name }}/ || true
-        mv artifacts/developer_manual/* server/${{ steps.branch.outputs.branch_name }}/com/ || true
-        
-        # If this is the highest stable branch, also deploy to versioned folder (e.g., server/28/)
-        if [ -n "${{ steps.branch.outputs.version_name }}" ]; then
-          rm -rf server/${{ steps.branch.outputs.version_name }}
-          cp -r server/${{ steps.branch.outputs.branch_name }} server/${{ steps.branch.outputs.version_name }}
-        fi
-        
-        # Clean up empty directories and artifacts
-        find . -type d -empty -delete
-        rm -rf artifacts
-
-    - name: Add various redirects for go.php and user_manual english version
-      run: |
-        # Fetch default branch to get base redirect files
-        git fetch origin ${{ github.event.repository.default_branch }}
-        
-        # Checkout both redirect files from default branch
-        git checkout origin/${{ github.event.repository.default_branch }} -- go.php/index.html user_manual/index.html
-        
-        # Create deployment directories and move redirects into place
-        mkdir -p server/${{ steps.branch.outputs.branch_name }}/{go.php,user_manual}
-        mv go.php/index.html server/${{ steps.branch.outputs.branch_name }}/go.php/
-        mv user_manual/index.html server/${{ steps.branch.outputs.branch_name }}/user_manual/
-
-    - name: Upload staged site
-      uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
-      with:
-        name: staged-site
-        path: server/
 
   check:
     name: Check staged documentation
@@ -283,15 +280,14 @@ jobs:
         jobSummary: true
         args: |
           --offline --no-progress --verbose
-          --remap "https://docs.nextcloud.com/server/${{ needs.stage.outputs.branch_name }} file://$(pwd)/server/${{ needs.stage.outputs.branch_name }}"
+          --remap "https://docs.nextcloud.com/server/${{ needs.stage.outputs.branch_name }} file://$(pwd)/server/${{ needs.stage.outputs.branch_name }}/"
           'server/${{ needs.stage.outputs.branch_name }}/**/*.html'
 
-
   deploy:
     name: Deploy documentation to gh-pages
     needs: [stage, check]
     runs-on: ubuntu-latest
-    if: github.event_name == 'push'
+    # if: github.event_name == 'push'
 
     permissions:
       contents: write
@@ -335,7 +331,7 @@ jobs:
 
         find . -type d -empty -delete
 
-        # QUickly log the directory structure for debugging purposes
+        # Quickly log the directory structure for debugging purposes
         echo "Directory structure after applying staged site:"
         find server -type d -print