mkdocs.yml

# Project information
site_name: Hugging-multi-agent
site_author: Azula
site_description: 全面深入的agent学习开发指南



# Configuration
theme:
  name: material
  custom_dir: overrides
  language: zh
  features:
    # - announce.dismiss
    - content.action.edit
    # - content.action.view
    - content.code.annotate
    - content.code.copy
    - content.tabs.link
    - content.tooltips
    # - header.autohide
    # - navigation.expand
    - navigation.indexes
    # - navigation.instant
    # - navigation.prune
    # - navigation.sections
    # - navigation.tabs
    # - navigation.tabs.sticky
    - navigation.top
    - navigation.footer
    - navigation.tracking
    - search.highlight
    - search.share
    - search.suggest
    - toc.follow
    # - toc.integrate
  palette:
    - scheme: default
      primary: white
      # accent: indigo
      toggle:
        icon: material/theme-light-dark
        name: Switch to dark mode
    - scheme: slate
      primary: grey
      # accent: indigo
      toggle:
        icon: material/theme-light-dark
        name: Switch to light mode
  font:
    text: Noto Sans SC
    code: Fira Code
  favicon: assets/images/logo.jpg
  logo: assets/images/logo.jpg
  icon:
    logo: logo
    repo: fontawesome/brands/github
    edit: fontawesome/regular/pen-to-square

extra:
  alternate:
    - name: 中文
      link: /
      lang: zh
    - name: English
      link: /en/
      lang: en
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/datawhalechina/hugging-multi-agent
  generator: false
  status:
    new: 最近添加

# Plugins
plugins:
  - search
  - glightbox:
      touchNavigation: true
      loop: false
      effect: zoom
      slide_effect: none
      width: 100%
      height: auto
      zoomable: true
      draggable: false
      auto_caption: false
      caption_position: bottom

# Extensions
markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  # - pymdownx.emoji:
  #     emoji_index: !!python/name:materialx.emoji.twemoji
  #     emoji_generator: !!python/name:materialx.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.keys
  # - pymdownx.magiclink:
  #     repo_url_shorthand: true
  #     user: squidfunk
  #     repo: mkdocs-material
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

extra_javascript:
  - javascripts/mathjax.js
  - https://polyfill.io/v3/polyfill.min.js?features=es6
  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
  # - javascripts/katex.js 
  # - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.js  
  # - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js

extra_css:
  - stylesheets/extra.css
  # - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.css

# Page tree
nav:
  - 第 1 章   获取MetaGPT:
    # [icon: material/book-open-outline]
    - chapter1/index.md
    - 1.1   获取MetaGPT: chapter1/获取MetaGPT.md

  - 第 2 章   智能体综述及多智能体框架介绍:

    - chapter2/index.md
    - 2.1   AI Agent体系介绍: chapter2/AIAgent知识体系结构.md
    - 2.2   多智能体框架介绍: chapter2/多智能体框架介绍.md

  - 第 3 章   单智能体开发:

    - chapter3/index.md
    - 3.1   Agent概念概述: chapter3/Agent概念概述.md
    - 3.2   RoleContext对象分析: chapter3/RoleContext对象分析.md
    - 3.3   实现一个单动作Agent: chapter3/实现一个单动作Agent.md
    - 3.4   实现一个多动作Agent: chapter3/实现一个多动作Agent.md
    - 3.5   实现一个更复杂的Agent：技术文档助手: chapter3/实现一个更复杂的Agent：技术文档助手.md
    - 3.6   单智能体案例OSS-订阅智能体: chapter3/单智能体案例OSS-订阅智能体.md
    - 3.7   智能体开发作业: chapter3/智能体开发作业.md

  - 参考文献:
    - chapter_reference/index.md