fix: rewrite nginx config to support production GH pages URLs

Related: #1997

Author: B4nan

nginx.conf

@@ -1,54 +1,69 @@
+# Map Accept headers to Markdown flag
 map $http_accept $wants_markdown {
-  default 0;
-  "~*text/markdown" 1;
-  "~*text/plain"    1;
+    default 0;
+    "~*text/markdown" 1;
+    "~*text/plain"    1;
+}
+
+# Define named upstream for local dev
+upstream local_docs {
+    server 127.0.0.1:3000;
+}
+
+# Map host to upstream
+map $host $docs_upstream {
+    "docs.apify.com" https://apify.github.io/apify-docs;  # production
+    default          http://local_docs;                  # local dev
 }
 
 server {
-  listen 0.0.0.0:8080;
-  server_name 'docs.apify.com';
+    listen 0.0.0.0:8080;
+    server_name docs.apify.loc docs.apify.com;
 
-  # homepage: only rewrite to internal proxy when client wants markdown
-  location = / {
-    if ($wants_markdown) {
-      # use 'last' to force a new location lookup so /__proxy/ handler runs
-      rewrite ^ /__proxy/llms.txt last;
+    # Homepage: llms.txt fallback
+    location = / {
+        if ($wants_markdown) {
+            rewrite ^ /__proxy/llms.txt last;
+        }
+        proxy_pass $docs_upstream;
+        proxy_redirect https://apify.github.io/ https://apify.github.io/apify-docs/;
     }
-    proxy_pass https://apify.github.io/apify-docs/;
-  }
 
-  # direct llms.txt files, serve with markdown content type
-  location /llms.txt {
-    proxy_pass https://apify.github.io/apify-docs/llms.txt;
-    proxy_hide_header Content-Type;
-    add_header Content-Type "text/markdown; charset=utf-8" always;
-  }
-  location /llms-full.txt {
-    proxy_pass https://apify.github.io/apify-docs/llms-full.txt;
-    proxy_hide_header Content-Type;
-    add_header Content-Type "text/markdown; charset=utf-8" always;
-  }
+    # Direct llms.txt files
+    location = /llms.txt {
+        proxy_pass $docs_upstream/llms.txt;
+        proxy_hide_header Content-Type;
+        add_header Content-Type "text/markdown; charset=utf-8" always;
+        proxy_redirect https://apify.github.io/ https://apify.github.io/apify-docs/;
+    }
 
-  # generic docs fallback: rewrite clean URLs to .md when client wants markdown
-  location / {
-    if ($wants_markdown) {
-      # rewrite to internal proxy path; use last so new location is matched
-      rewrite ^(/[^.]+)$ /__proxy$1.md last;
+    location = /llms-full.txt {
+        proxy_pass $docs_upstream/llms-full.txt;
+        proxy_hide_header Content-Type;
+        add_header Content-Type "text/markdown; charset=utf-8" always;
+        proxy_redirect https://apify.github.io/ https://apify.github.io/apify-docs/;
     }
-    proxy_pass https://apify.github.io/apify-docs/;
-  }
 
-  # internal proxy handler that actually forces the markdown header
-  location ^~ /__proxy/ {
-    internal;
+    # Generic Markdown fallback
+    location / {
+        if ($wants_markdown) {
+            rewrite ^(/.*\.md)$ /__proxy$1 last;
+            rewrite ^(/[^./]+)/*$ /__proxy$1.md last;
+        }
+        proxy_pass $docs_upstream;
+        proxy_redirect https://apify.github.io/ https://apify.github.io/apify-docs/;
+    }
 
-    # strip the /__proxy prefix so upstream sees the real path
-    rewrite ^/__proxy(/.*)$ $1 break;
+    # Internal proxy for Markdown handling
+    location ^~ /__proxy/ {
+        internal;
+        rewrite ^/__proxy/(.*)$ /$1 break;
 
-    proxy_pass https://apify.github.io/apify-docs/;
-    proxy_hide_header Content-Type;
-    add_header Content-Type "text/markdown; charset=utf-8" always;
-  }
+        proxy_pass $docs_upstream;
+        proxy_hide_header Content-Type;
+        add_header Content-Type "text/markdown; charset=utf-8" always;
+        proxy_redirect https://apify.github.io/ https://apify.github.io/apify-docs/;
+    }
 
   # proxies to other repositories
   location /api/client/js {