From 3ebed95496f66e8e87afa74aff0621bb18bce793 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Wed, 9 Sep 2026 12:15:33 +0200
Subject: [PATCH] Allow repository image symlink in previews

Related: https://github.com/ClickHouse/mintlify-docs-dev/pull/345
---
 .github/workflows/site-preview.yml | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/site-preview.yml b/.github/workflows/site-preview.yml
index eb9e78a48..69656cf10 100644
--- a/.github/workflows/site-preview.yml
+++ b/.github/workflows/site-preview.yml
@@ -136,13 +136,17 @@ jobs:
           path: site
           persist-credentials: false
 
-      - name: Reject symbolic links in uploaded source
+      - name: Reject unsafe symbolic links in uploaded source
         run: |
-          symlink="$(find site -type l -print -quit)"
-          if [[ -n "$symlink" ]]; then
-            echo "Fork and branch previews may not upload symbolic links: $symlink" >&2
+          while IFS= read -r -d '' symlink; do
+            relative_path="${symlink#site/}"
+            target="$(readlink "$symlink")"
+            if [[ "$relative_path" == "public/images" && "$target" == "../images" ]]; then
+              continue
+            fi
+            echo "Fork and branch previews may not upload symbolic links: $relative_path -> $target" >&2
             exit 1
-          fi
+          done < <(find site -type l -print0)
 
       - name: Verify the checked-out revision
         working-directory: site