mkdocs.yml

site_name: KsADK
site_description: AI Agent Runtime Platform
site_url: https://kingsoftcloud.github.io/ksadk-python/
repo_url: https://github.com/kingsoftcloud/ksadk-python
repo_name: kingsoftcloud/ksadk-python
edit_uri: edit/main/public-docs/
docs_dir: public-docs
site_dir: site
strict: true

theme:
  name: material
  language: zh
  features:
    - content.action.edit
    - content.action.view
    - content.code.copy
    - content.code.select
    - navigation.footer
    - navigation.path
    - navigation.sections
    - navigation.tabs
    - navigation.tabs.sticky
    - search.highlight
    - search.share

nav:
  - Getting Started 入门:
      - 首页: index.md
      - 为什么需要 KsADK: getting-started/why-ksadk.md
      - 架构: getting-started/architecture.md
      - 生态定位对比: getting-started/comparison.md
      - 初识 KsADK: getting-started/concepts.md
      - 快速开始: getting-started/quickstart.md
      - 配置项: getting-started/configuration.md
      - 项目结构: getting-started/project-structure.md
  - Build 构建:
      - 构建 LangGraph 智能体: tutorials/langgraph-agent.md
      - 构建 ADK 智能体: tutorials/adk-agent.md
      - 接入已有智能体: tutorials/existing-agent.md
      - 框架接入: guides/frameworks.md
      - Agent 最佳实践: guides/agent-best-practices.md
  - Run 运行:
      - 本地 Web UI: guides/local-web-ui.md
      - Web UI 仓库: guides/web-ui-source.md
      - 运行时架构: guides/runtime-architecture.md
      - 智能体上下文: guides/agent-context.md
      - 附件与多模态输入: guides/attachments-multimodal.md
      - 工作区文件: guides/workspace-files.md
      - 会话与文件: reference/runtime-sessions-files.md
  - Deploy 部署:
      - 构建与打包: guides/build-and-package.md
      - 运行时产品: guides/runtime-products.md
      - 远程运行时 API: reference/remote-runtime-api.md
      - 发布流程: contributing/release.md
  - Observe 观测:
      - 可观测与链路追踪: guides/observability-tracing.md
      - 故障排查: reference/troubleshooting.md
      - 测试策略: contributing/testing.md
  - Extend 扩展:
      - 工具与 Skill Runtime: guides/tools-and-skill-runtime.md
      - 记忆与知识库: guides/memory-knowledge.md
      - OpenAI 兼容 API: reference/openai-compatible-api.md
      - 贡献指南: contributing/index.md
  - Reference 参考:
      - 命令行: reference/cli.md
      - 项目配置: reference/project-config.md
      - 环境变量: reference/environment-variables.md
      - 安全边界: reference/security-boundaries.md

exclude_docs: |
  internal/
  .zread/

not_in_nav: |
  *.en.md

plugins:
  - search
  - i18n:
      docs_structure: suffix
      fallback_to_default: true
      languages:
        - locale: zh
          name: 简体中文
          build: true
          default: true
          site_name: KsADK
          site_description: AI Agent Runtime Platform
          theme:
            language: zh
        - locale: en
          name: English
          build: true
          site_name: KsADK
          site_description: Agent Runtime Platform for AI agents
          theme:
            language: en
          nav_translations:
            Getting Started 入门: Getting Started
            首页: Overview
            为什么需要 KsADK: Why KsADK
            架构: Architecture
            生态定位对比: Ecosystem Positioning
            初识 KsADK: Concepts
            快速开始: Quick Start
            配置项: Configuration
            项目结构: Project Structure
            Build 构建: Build
            构建 LangGraph 智能体: Build A LangGraph Agent
            构建 ADK 智能体: Build An ADK Agent
            接入已有智能体: Bring An Existing Agent
            Run 运行: Run
            本地 Web UI: Local Web UI
            Web UI 仓库: Web UI Repository
            运行时架构: Runtime Architecture
            智能体上下文: Agent Context
            附件与多模态输入: Attachments And Multimodal Input
            工作区文件: Workspace Files
            会话与文件: Runtime Sessions And Files
            Deploy 部署: Deploy
            构建与打包: Build And Package
            运行时产品: Runtime Products
            远程运行时 API: Remote Runtime API
            发布流程: Release Process
            Observe 观测: Observe
            可观测与链路追踪: Observability And Tracing
            故障排查: Troubleshooting
            测试策略: Testing Strategy
            Extend 扩展: Extend
            工具与 Skill Runtime: Tools And Skill Runtime
            记忆与知识库: Memory And Knowledge
            命令行: CLI
            OpenAI 兼容 API: OpenAI-Compatible API
            贡献指南: Contributing Guide
            Reference 参考: Reference
            项目配置: Project Configuration
            环境变量: Environment Variables
            安全边界: Security Boundaries
            Agent 最佳实践: Agent Best Practices
            框架接入: Frameworks
  - mkdocstrings:
      handlers:
        python:
          options:
            docstring_style: google

markdown_extensions:
  - admonition
  - attr_list
  - def_list
  - md_in_html
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - toc:
      permalink: true