Fix docs language switching

Author: iancaoo

docs/javascripts/language-switcher.js

@@ -0,0 +1,71 @@
+(() => {
+  const script = document.currentScript;
+  const scriptUrl = new URL(
+    script?.getAttribute("src") ?? "javascripts/language-switcher.js",
+    window.location.href
+  );
+  const siteBasePath = scriptUrl.pathname.replace(/\/javascripts\/language-switcher\.js$/, "/");
+
+  const trimSlashes = (value) => value.replace(/^\/+|\/+$/g, "");
+  const withTrailingSlash = (value) => value.endsWith("/") ? value : `${value}/`;
+  const normalizePagePath = (pathname) => {
+    const decoded = decodeURI(pathname)
+      .replace(/\/index\.html$/, "/")
+      .replace(/\.html$/, "/");
+    return withTrailingSlash(decoded);
+  };
+  const sitePath = (relativePath) => {
+    const clean = trimSlashes(relativePath);
+    return `${siteBasePath}${clean ? `${clean}/` : ""}`.replace(/\/{2,}/g, "/");
+  };
+  const currentRelativePath = () => {
+    const pathname = normalizePagePath(window.location.pathname);
+    return pathname.startsWith(siteBasePath)
+      ? trimSlashes(pathname.slice(siteBasePath.length))
+      : trimSlashes(pathname);
+  };
+  const languageTarget = (language) => {
+    const current = currentRelativePath();
+
+    if (language === "en") {
+      if (!current || current === "zh/home") {
+        return sitePath("");
+      }
+      if (current === "zh") {
+        return sitePath("en");
+      }
+      if (current.startsWith("zh/")) {
+        return sitePath(`en/${current.slice(3)}`);
+      }
+      return sitePath(current);
+    }
+
+    if (language === "zh") {
+      if (!current) {
+        return sitePath("zh/home");
+      }
+      if (current === "en") {
+        return sitePath("zh");
+      }
+      if (current.startsWith("en/")) {
+        return sitePath(`zh/${current.slice(3)}`);
+      }
+      return sitePath(current);
+    }
+
+    return sitePath("");
+  };
+  const applyLanguageTargets = () => {
+    for (const link of document.querySelectorAll('a[hreflang="en"], a[hreflang="zh"]')) {
+      const language = link.getAttribute("hreflang");
+      link.setAttribute("href", languageTarget(language));
+    }
+  };
+
+  if (window.document$?.subscribe) {
+    window.document$.subscribe(applyLanguageTargets);
+  } else {
+    document.addEventListener("DOMContentLoaded", applyLanguageTargets);
+    applyLanguageTargets();
+  }
+})();

docs/zh/home.md

@@ -0,0 +1,77 @@
+---
+hide:
+  - navigation
+  - toc
+  - edit
+---
+
+<div class="df-home" markdown>
+
+<section class="df-home-hero" markdown>
+
+<p class="df-kicker">开源数据智能体工作台</p>
+
+# DataFoundry
+
+面向企业数据任务的受控 Data Agent 工作流。将自然语言分析转化为理解 Schema、只读执行、可回放、可审计的数据工作。
+
+<div class="df-actions" markdown>
+[快速开始](quick-start.md){ .df-button .df-button-primary }
+[阅读文档](index.md){ .df-button }
+[GitHub](https://github.com/datagallery-lab/datafoundry){ .df-button }
+</div>
+
+</section>
+
+<figure class="df-home-shot" markdown>
+![DataFoundry Web 工作台](../assets/readme/gui-demo.gif){ .df-shot }
+<figcaption>Web 工作台、终端工作流和后端运行时共享同一套受控任务模型。</figcaption>
+</figure>
+
+<section class="df-proof-grid" markdown>
+
+<div class="df-proof" markdown>
+### 受控执行
+Schema 检查、数据源策略、只读 SQL、行数限制、脱敏与审计都由 Data Gateway 统一约束。
+</div>
+
+<div class="df-proof" markdown>
+### 可回放工作
+Web、TUI 和 API 客户端共享同一套运行状态、事件流、产物和任务历史。
+</div>
+
+<div class="df-proof" markdown>
+### 统一上下文
+文件、知识库、技能、工具、记忆和数据源选择在后端策略下编译成可控上下文。
+</div>
+
+</section>
+
+## 选择合适的开始路径
+
+<div class="df-grid df-route-grid" markdown>
+
+<div class="df-card" markdown>
+### 本地试用
+启动工作台，并基于内置 DuckDB demo 完成第一次数据分析。
+
+[快速开始](quick-start.md)
+</div>
+
+<div class="df-card" markdown>
+### 理解系统
+了解运行时、安全边界和 Data Gateway 架构。
+
+[架构概览](architecture/overview.md)
+</div>
+
+<div class="df-card" markdown>
+### 接入 API
+使用 REST 配置 API 与 Agent Runtime / AG-UI 入口。
+
+[API 参考](reference/rest-api.md)
+</div>
+
+</div>
+
+</div>

mkdocs.yml

@@ -33,6 +33,9 @@ theme:
 extra_css:
   - stylesheets/extra.css
 
+extra_javascript:
+  - javascripts/language-switcher.js
+
 extra:
   social:
     - icon: fontawesome/brands/github
@@ -71,6 +74,7 @@ nav:
           - Examples:
               - DTC growth analysis demo: en/examples/dtc-growth-demo.md
       - 简体中文:
+          - 产品首页: zh/home.md
           - zh/index.md
           - 产品概览: zh/overview.md
           - 快速开始: zh/quick-start.md