Add link validation script to CI

Add a new link validator script (dist/validate-links.sh) that scans markdown files for internal /docs/ and /cn/docs/ links and verifies target pages exist. Integrate the checker into the Hugo GitHub Actions workflow (.github/workflows/hugo.yml) so links are validated during CI. Fix several documentation links in both English and Chinese introduction pages to the correct /docs/quickstart/hugegraph/... path. Remove the obsolete DISCLAIMER file and tweak dist/README wording. Also add a TODO note in dist/validate-release.sh regarding TLP graduation and ASF infra migration.

Author: imbajin

.github/workflows/hugo.yml

@@ -40,6 +40,9 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-hugomod-
 
+      - name: Check Links
+        run: bash dist/validate-links.sh
+
       - name: Build Site (minify)
         run: npm i && hugo --minify
 

DISCLAIMER

@@ -50,7 +50,7 @@ HugeGraph 支持多种部署模式，满足不同规模和场景的需求：
 
 | 使用场景 | 推荐路径 |
 |---------|---------|
-| 快速体验 | [Docker 部署](/cn/docs/quickstart/hugegraph-server/hugegraph-server#docker) |
+| 快速体验 | [Docker 部署](/cn/docs/quickstart/hugegraph/hugegraph-server#docker) |
 | 构建 OLTP 应用 | Server → REST API / Gremlin / Cypher |
 | 图分析 (OLAP) | [Vermeer](/cn/docs/quickstart/computing/hugegraph-computer) (推荐) 或 Computer |
 | 构建 AI 应用 | [HugeGraph-AI](/cn/docs/quickstart/hugegraph-ai) (GraphRAG/知识图谱) |

content/cn/docs/introduction/README.md

@@ -35,7 +35,7 @@ HugeGraph supports multiple deployment modes to meet different scales and scenar
 - Server + RocksDB backend storage
 - Suitable for development, testing, and small-to-medium scale data (< 4TB)
 - Docker quick start: `docker run hugegraph/hugegraph`
-- See [Server Quickstart](/docs/quickstart/hugegraph-server/hugegraph-server)
+- See [Server Quickstart](/docs/quickstart/hugegraph/hugegraph-server)
 
 **Distributed Mode**
 - HugeGraph-PD: Metadata management and cluster scheduling

content/en/docs/introduction/README.md

@@ -1,6 +1,6 @@
 # Apache HugeGraph 发版验证脚本
 
-Apache HugeGraph (Incubating) 发布包的自动化验证脚本。
+Apache HugeGraph 发布包的自动化验证脚本。
 
 ## 概述
 

dist/README.md

@@ -0,0 +1,65 @@
+#!/bin/bash
+
+# Configuration
+CONTENT_DIR="content"
+EXIT_CODE=0
+
+echo "Starting link validation..."
+
+# Find all markdown files and verify links
+while read -r FILE; do
+    # Extract internal links starting with /docs/ or /cn/docs/
+    # We look for [text](url) pattern where url starts with /docs/ or /cn/docs/
+    # Using grep to find all matching links in the file
+    while read -r MATCH; do
+        if [ -z "$MATCH" ]; then continue; fi
+        
+        # Extract URL from ](url)
+        LINK=${MATCH#*](}
+        LINK=${LINK%)}
+        
+        # Remove anchor and query parameters
+        CLEAN_LINK=$(echo "$LINK" | cut -d'#' -f1 | cut -d'?' -f1)
+        
+        # Determine target file path based on language prefix
+        if [[ "$CLEAN_LINK" == /docs/* ]]; then
+            TARGET_PATH="content/en${CLEAN_LINK}"
+        elif [[ "$CLEAN_LINK" == /cn/docs/* ]]; then
+            TARGET_PATH="content${CLEAN_LINK}"
+        else
+            continue
+        fi
+
+        # Check for file existence variations
+        FOUND=false
+        
+        # Check 1: As .md file
+        if [[ -f "${TARGET_PATH}.md" ]]; then
+            FOUND=true
+        # Check 2: Exact file (if extension was included)
+        elif [[ -f "$TARGET_PATH" ]]; then
+            FOUND=true
+        # Check 3: Directory index
+        elif [[ -f "${TARGET_PATH}/_index.md" ]]; then
+            FOUND=true
+        # Check 4: Directory README (legacy)
+        elif [[ -f "${TARGET_PATH}/README.md" ]]; then
+            FOUND=true
+        fi
+        
+        if [ "$FOUND" = false ]; then
+            echo "Error: Broken link in $FILE"
+            echo "  Link: $LINK"
+            echo "  Target: $TARGET_PATH (and variants)"
+            EXIT_CODE=1
+        fi
+    done < <(grep -oE '\]\((/docs/|/cn/docs/)[^)]+\)' "$FILE")
+done < <(find "$CONTENT_DIR" -type f -name "*.md")
+
+if [ $EXIT_CODE -eq 0 ]; then
+    echo "Link validation passed!"
+else
+    echo "Link validation failed!"
+fi
+
+exit $EXIT_CODE

dist/validate-links.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# TODO: Update for TLP graduation after ASF infra migration is complete.
 ################################################################################
 # Apache HugeGraph Release Validation Script
 ################################################################################