fix(docs): use GitHub URLs for out-of-tree wiki links

MkDocs strict mode fails on relative links to repo-root files; point
openapi, protocols, SECURITY, and env example links at GitHub instead.

Author: iPmartNetwork

docs/wiki/_mkdocs_sanitize.py

@@ -8,6 +8,7 @@
 
 ROOT = Path(__file__).resolve().parent
 LANGS = ("en", "fa", "ar", "tr")
+GITHUB = "https://github.com/iPmartNetwork/VortexUI/blob/master"
 
 ALERT_MAP = {
     "NOTE": "note",
@@ -90,6 +91,21 @@ def fix_admonition_quotes(text: str) -> str:
     return "\n".join(out)
 
 
+def fix_external_links(text: str) -> str:
+    """Point repo-root references at GitHub (outside docs_dir)."""
+    replacements = {
+        "../../openapi.yaml": f"{GITHUB}/docs/openapi.yaml",
+        "../../protocols.md": f"{GITHUB}/docs/protocols.md",
+        "../../../.env.example": f"{GITHUB}/.env.example",
+        "../../../SECURITY.md": f"{GITHUB}/SECURITY.md",
+        "../../../CONTRIBUTING.md": f"{GITHUB}/CONTRIBUTING.md",
+        "../../../CHANGELOG.md": f"{GITHUB}/CHANGELOG.md",
+    }
+    for old, new in replacements.items():
+        text = text.replace(old, new)
+    return text
+
+
 def simplify_nav_line(text: str) -> str:
     # MkDocs has sidebar; drop redundant breadcrumb nav lines
     text = re.sub(
@@ -178,6 +194,7 @@ def sanitize_chapter(path: Path) -> None:
     text = github_alerts_to_material(text)
     text = fix_admonition_quotes(text)
     text = simplify_nav_line(text)
+    text = fix_external_links(text)
     text = ensure_table_spacing(text)
     text = re.sub(r"\n{3,}", "\n\n", text).strip() + "\n"
     path.write_text(text, encoding="utf-8")

docs/wiki/ar/02-installation.md

@@ -164,7 +164,7 @@ VORTEX_CORE_BIN=/usr/local/bin/xray
 | `VORTEX_TELEGRAM_TOKEN` | — | رمز بوت Telegram |
 | `VORTEX_CF_API_TOKEN` | — | أتمتة DNS Cloudflare |
 
-القائمة الكاملة: [`.env.example`](../../../.env.example)
+القائمة الكاملة: [`.env.example`](https://github.com/iPmartNetwork/VortexUI/blob/master/.env.example)
 
 ---
 

docs/wiki/ar/12-api-reference.md

@@ -1,13 +1,13 @@
 # ١٢. مرجع API
 
 !!! note
-    المواصفات الكاملة: [`docs/openapi.yaml`](../../openapi.yaml) — جميع endpoints وRBAC.
+    المواصفات الكاملة: [`docs/openapi.yaml`](https://github.com/iPmartNetwork/VortexUI/blob/master/docs/openapi.yaml) — جميع endpoints وRBAC.
 
 ---
 
 ## OpenAPI
 
-المواصفات الكاملة: [`docs/openapi.yaml`](../../openapi.yaml)
+المواصفات الكاملة: [`docs/openapi.yaml`](https://github.com/iPmartNetwork/VortexUI/blob/master/docs/openapi.yaml)
 
 ### العرض التفاعلي
 

docs/wiki/ar/13-protocols-config.md

@@ -1,6 +1,6 @@
 # ١٣. البروتوكولات والتكوين
 
-> أمثلة JSON كاملة بالإنجليزية: [`docs/protocols.md`](../../protocols.md)
+> أمثلة JSON كاملة بالإنجليزية: [`docs/protocols.md`](https://github.com/iPmartNetwork/VortexUI/blob/master/docs/protocols.md)
 
 !!! tip
     تحت رقابة شديدة: **VLESS + REALITY + Vision** — أنشئ المفاتيح من الواجهة.

docs/wiki/ar/15-troubleshooting-faq.md

@@ -131,12 +131,12 @@ GPL-3.0 — المشتقات يجب أن تكون مفتوحة المصدر.
 1. [GitHub Issues](https://github.com/iPmartNetwork/VortexUI/issues)
 2. الإصدار: `vortexui settings` أو الشريط الجانبي
 3. السجلات: `vortexui logs` (بدون أسرار)
-4. [SECURITY.md](../../../SECURITY.md) للثغرات
+4. [SECURITY.md](https://github.com/iPmartNetwork/VortexUI/blob/master/SECURITY.md) للثغرات
 
 ---
 
 ## المجتمع
 
 - ⭐ Star on GitHub
-- [Contributing](../../../CONTRIBUTING.md)
-- [Changelog](../../../CHANGELOG.md)
+- [Contributing](https://github.com/iPmartNetwork/VortexUI/blob/master/CONTRIBUTING.md)
+- [Changelog](https://github.com/iPmartNetwork/VortexUI/blob/master/CHANGELOG.md)

docs/wiki/en/02-installation.md

@@ -164,7 +164,7 @@ In Docker Compose this is enabled by default.
 | `VORTEX_TELEGRAM_TOKEN` | — | Telegram bot token |
 | `VORTEX_CF_API_TOKEN` | — | Cloudflare DNS automation |
 
-Full list: [`.env.example`](../../../.env.example)
+Full list: [`.env.example`](https://github.com/iPmartNetwork/VortexUI/blob/master/.env.example)
 
 ---
 

docs/wiki/en/12-api-reference.md

@@ -1,13 +1,13 @@
 # 12. API Reference
 
 !!! note
-    Full spec: [`docs/openapi.yaml`](../../openapi.yaml) — all endpoints and RBAC.
+    Full spec: [`docs/openapi.yaml`](https://github.com/iPmartNetwork/VortexUI/blob/master/docs/openapi.yaml) — all endpoints and RBAC.
 
 ---
 
 ## OpenAPI
 
-Full specification: [`docs/openapi.yaml`](../../openapi.yaml)
+Full specification: [`docs/openapi.yaml`](https://github.com/iPmartNetwork/VortexUI/blob/master/docs/openapi.yaml)
 
 ### Interactive viewing
 

docs/wiki/en/13-protocols-config.md

@@ -1,6 +1,6 @@
 # 13. Protocols & Configuration
 
-> Full English JSON examples: [`docs/protocols.md`](../../protocols.md)
+> Full English JSON examples: [`docs/protocols.md`](https://github.com/iPmartNetwork/VortexUI/blob/master/docs/protocols.md)
 
 !!! tip
     Under heavy censorship: **VLESS + REALITY + Vision** — generate keys from the UI.

docs/wiki/en/15-troubleshooting-faq.md

@@ -131,12 +131,12 @@ GPL-3.0 — derivatives must be open source.
 1. [GitHub Issues](https://github.com/iPmartNetwork/VortexUI/issues)
 2. Version: `vortexui settings` or sidebar
 3. Logs: `vortexui logs` (no secrets)
-4. [SECURITY.md](../../../SECURITY.md) for vulnerabilities
+4. [SECURITY.md](https://github.com/iPmartNetwork/VortexUI/blob/master/SECURITY.md) for vulnerabilities
 
 ---
 
 ## Community
 
 - ⭐ Star on GitHub
-- [Contributing](../../../CONTRIBUTING.md)
-- [Changelog](../../../CHANGELOG.md)
+- [Contributing](https://github.com/iPmartNetwork/VortexUI/blob/master/CONTRIBUTING.md)
+- [Changelog](https://github.com/iPmartNetwork/VortexUI/blob/master/CHANGELOG.md)

docs/wiki/fa/02-installation.md

@@ -164,7 +164,7 @@ VORTEX_CORE_BIN=/usr/local/bin/xray
 | `VORTEX_TELEGRAM_TOKEN` | — | توکن ربات تلگرام |
 | `VORTEX_CF_API_TOKEN` | — | Cloudflare DNS automation |
 
-لیست کامل: [`.env.example`](../../../.env.example)
+لیست کامل: [`.env.example`](https://github.com/iPmartNetwork/VortexUI/blob/master/.env.example)
 
 ---