🔧 Fix GitHub Pages deployment

DeepPythonist · DeepPythonist · commit 79acfe6354b1 · 2025-06-26T03:33:48.000+03:30
- Add index.html redirect page
- Simplify GitHub Actions workflow
- Remove unnecessary environment validation
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -3,26 +3,24 @@ name: Build and Deploy Documentation
 on:
   push:
     branches: [ main ]
-  pull_request:
-    branches: [ main ]
 
 permissions:
   contents: read
   pages: write
   id-token: write
 
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
 jobs:
-  build:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     
     steps:
-    - uses: actions/checkout@v4
+    - name: Checkout
+      uses: actions/checkout@v4
     
-    - name: Set up Python
+    - name: Setup Python
       uses: actions/setup-python@v4
       with:
         python-version: '3.11'
@@ -37,6 +35,8 @@ jobs:
       run: |
         cd docs
         sphinx-build -b html . _build/html
+        # Copy index.html to root for GitHub Pages
+        cp index.html _build/html/ || true
     
     - name: Setup Pages
       uses: actions/configure-pages@v4
@@ -45,16 +45,7 @@ jobs:
       uses: actions/upload-pages-artifact@v3
       with:
         path: docs/_build/html
-
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    if: github.ref == 'refs/heads/main'
     
-    steps:
     - name: Deploy to GitHub Pages
       id: deployment
       uses: actions/deploy-pages@v4 
diff --git a/docs/index.html b/docs/index.html
@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>PyHetznerServer Documentation</title>
+    <meta http-equiv="refresh" content="0; url=./_build/html/index.html">
+    <link rel="canonical" href="./_build/html/index.html">
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            height: 100vh;
+            margin: 0;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            text-align: center;
+        }
+        .container {
+            background: rgba(255, 255, 255, 0.1);
+            padding: 2rem;
+            border-radius: 10px;
+            backdrop-filter: blur(10px);
+        }
+        .spinner {
+            border: 3px solid rgba(255, 255, 255, 0.3);
+            border-top: 3px solid white;
+            border-radius: 50%;
+            width: 40px;
+            height: 40px;
+            animation: spin 1s linear infinite;
+            margin: 0 auto 1rem;
+        }
+        @keyframes spin {
+            0% { transform: rotate(0deg); }
+            100% { transform: rotate(360deg); }
+        }
+        a {
+            color: white;
+            text-decoration: underline;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="spinner"></div>
+        <h1>🚀 PyHetznerServer Documentation</h1>
+        <p>Redirecting to documentation...</p>
+        <p>If you're not redirected automatically, <a href="./_build/html/index.html">click here</a>.</p>
+        
+        <div style="margin-top: 2rem; font-size: 0.9rem;">
+            <p>📚 A modern, type-safe Python library for Hetzner Cloud Server management</p>
+            <p>⚡ Complete API coverage • 🛡️ Type safety • 🧪 Dry-run mode</p>
+        </div>
+    </div>
+    
+    <script>
+        // Fallback redirect
+        setTimeout(() => {
+            window.location.href = './_build/html/index.html';
+        }, 2000);
+    </script>
+</body>
+</html> 
