Mkdocs 多级目录

以下是在 MkDocs 中创建多级导航的方法:

在 mkdocs.yml 中配置导航结构:
nav:

  • 首页: index.md
  • 指南:
    • 快速入门: guide/getting-started.md
    • 基础概念: guide/concepts.md
    • 进阶教程:
      • 配置: guide/advanced/configuration.md
      • 部署: guide/advanced/deployment.md
  • API文档:
    • 概述: api/overview.md
    • 参考: api/reference.md
  • 关于: about.md
    确保目录结构匹配:
    docs/
    ├── index.md
    ├── guide/
    │ ├── getting-started.md
    │ ├── concepts.md
    │ └── advanced/
    │ ├── configuration.md
    │ └── deployment.md
    ├── api/
    │ ├── overview.md
    │ └── reference.md
    └── about.md
    在 mkdocs.yml 添加导航相关功能:
    theme:
    name: material
    features:
    • navigation.instant
    • navigation.tracking
    • navigation.tabs
    • navigation.sections
    • navigation.expand
    • navigation.indexes
      这样就能创建一个清晰的多级导航结构。需要了解更多具体配置选项吗?
posted @ 2024-11-01 14:27  eva1024  阅读(8)  评论(0编辑  收藏  举报