Merge pull request #4822 from ClickHouse/Blargian-patch-253677

Translations: modification to account for running script in General Translation ag…

Author: Blargian

scripts/autogenerate-table-of-contents.sh

@@ -10,7 +10,7 @@ set +e
 
 # Function to cleanup on exit
 cleanup() {
-    if [ -d "venv" ]; then
+    if [ "$USE_VENV" = true ]; then
         deactivate 2>/dev/null || true
         rm -rf venv
     fi
@@ -19,21 +19,36 @@ cleanup() {
 # Set trap to cleanup on exit (success or failure)
 trap cleanup EXIT
 
-# Check if virtual environment exists
+USE_VENV=false
+
+# Try to create a venv, if that fails fall back to installing packages
 if [ ! -d "venv" ]; then
     echo "Creating virtual environment..."
-    python3 -m venv venv
+    if python3 -m venv venv 2>/tmp/venv_err.log; then
+        USE_VENV=true
+    else
+        echo "Warning: could not create venv, falling back to user site-packages."
+        cat /tmp/venv_err.log
+        rm -rf venv
+    fi
+else
+    USE_VENV=true
 fi
 
-source venv/bin/activate
-pip install -r scripts/table-of-contents-generator/requirements.txt
+if [ "$USE_VENV" = true ]; then
+    . venv/bin/activate
+    pip install -r scripts/table-of-contents-generator/requirements.txt
+else
+    # No working venv, install deps
+    python3 -m pip install --user -r scripts/table-of-contents-generator/requirements.txt
+fi
 
 # Define all TOC generation commands
 COMMANDS=(
     '--dir="knowledgebase" --single-toc --out="static" --ignore images'
-    '--verbose --single-toc --dir="docs/operations/system-tables" --md="docs/operations/system-tables/index.md"'
-    '--verbose --single-toc --dir="docs/operations/settings" --md="docs/operations/settings/index.md"'
-    '--verbose --single-toc --dir="docs/engines/database-engines" --md="docs/engines/database-engines/index.md"'
+    '--single-toc --dir="docs/operations/system-tables" --md="docs/operations/system-tables/index.md"'
+    '--single-toc --dir="docs/operations/settings" --md="docs/operations/settings/index.md"'
+    '--single-toc --dir="docs/engines/database-engines" --md="docs/engines/database-engines/index.md"'
     '--single-toc --dir="docs/engines/table-engines/mergetree-family" --md="docs/engines/table-engines/mergetree-family/index.md"'
     '--single-toc --dir="docs/engines/table-engines/integrations" --md="docs/engines/table-engines/integrations/index.md"'
     '--single-toc --dir="docs/engines/table-engines/special" --md="docs/engines/table-engines/special/index.md"'