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
这样就能创建一个清晰的多级导航结构。需要了解更多具体配置选项吗?