mkdocs.yml

INHERIT: mkdocs.base.yml

site_url: https://lusipad.com/plcopen/
site_description: >-
  现代 C++ PLCopen 运动控制内核与 IEC 61131-3 ST 运行时，
  可嵌入控制器，也可接入学习系统
docs_dir: docs.zh
site_dir: site

theme:
  language: zh
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      toggle:
        icon: material/brightness-7
        name: 切换到深色模式
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      toggle:
        icon: material/brightness-4
        name: 切换到浅色模式

plugins:
  search:
    lang: zh

extra:
  alternate:
    - name: 简体中文
      link: /plcopen/
      lang: zh
    - name: English
      link: /plcopen/en/
      lang: en

nav:
  - 首页: index.md
  - 快速开始:
    - Python 数字孪生: getting-started/python.md
    - C++ 嵌入: getting-started/cpp.md
    - IEC 61131-3 ST: getting-started/st.md
  - 使用指南:
    - 实时集成: guides/realtime-integration.md
    - 运动调参: guides/tuning.md
    - TwinCAT / CODESYS 迁移: guides/twinCAT-codesys-migration.md
    - 诊断与轨迹: guides/diagnostics.md
    - ST Language Server: guides/st-language-server.md
    - 在线调试示波器: guides/online-scope.md
    - 运维: operations.md
  - 参考:
    - 算法白盒: getting-started/algorithms.md
    - 功能块参考: references/fb-reference.md
    - ST 运行时: references/st-runtime.md
    - 标准与证据: references/standards-evidence.md
    - 架构决策: references/architecture-decisions.md
    - C++ API（自动生成）: https://lusipad.com/plcopen/api/
  - 项目文档:
    - 导览: project/index.md
    - 状态与方向: project/status.md
    - 架构: project/architecture.md
    - 合规: project/compliance.md
    - 已知边界: project/known-boundaries.md
    - 参与贡献: project/contributing.md
    - 治理: project/governance.md
    - 安全: project/security.md
    - 变更日志: project/changelog.md
  - 版本:
    - v0.21.0 候选: releases/v0.21.0.md
    - v0.20.0: releases/v0.20.0.md