mkdocs：如何创建类似文件夹的结构

Question

我想用我的个人讲义创建一个小的本地文件。我想要的结构是

索引 1（包含子文件夹概述，但不包含其全部内容） 索引 1.1（包含子文件夹概述，但不包含其全部内容） 索引 1.1.1（包含部分内容）

目前我的 mkdocs.yml 看起来像

site_name: Lectures

theme: readthedocs

extra_javascript: 
    - https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML

markdown_extensions:
    - mdx_math

pages:
- Lecture1 
  - 'week 1': 'lec1/week1.md'
      - 'section 1': 'lec1/week1/sec1.md

但前面的代码并没有像我想要的那样显示它。

Answer 1

您的pages配置无效。

首先，节必须以冒号 ( :) 结尾，以指示后面的缩进行是该节的子节。

- Lecture:
  - 'week 1'...

其次，只有“部分”才能生孩子。“页面”不能有孩子。

- 'week 1':
  - Summary: 'lec1/week1.md'
  - 'section 1': 'lec1/week1/sec1.md'

是的，这意味着您需要为页面添加额外的条目week1.md。我给它起了标题Summary。当然，您可以使用您认为更合适的任何名称。无论如何，完整的配置应该如下所示：

pages:
  - Lecture:
    - 'week 1':
      - Summary: 'lec1/week1.md'
      - 'section 1': 'lec1/week1/sec1.md'