Организация разделов в навигации:

Организация разделов в навигации:#

Способ 1: caption для каждой группы в index.md#

# Документация проекта

```{toctree}
:maxdepth: 1
:caption: Раздел 1

cron
curl
```

```{toctree}
:maxdepth: 1
:caption: Раздел 2

flask
file4
file5
```

Это создаст два отдельных блока в навигации.

Способ 2: отдельные файлы-разделы#

Структура:

docs/source/
├── index.md
├── section1.md
├── section2.md
├── cron.md
├── curl.md
├── flask.md
└── ...

index.md:

# Документация проекта

```{toctree}
:maxdepth: 2
:caption: Содержание

section1
section2
```

section1.md:

# Раздел 1

```{toctree}
:maxdepth: 1

cron
curl
```

section2.md:

# Раздел 2

```{toctree}
:maxdepth: 1

flask
file4
file5
```

Способ 3: папки (самый структурированный)#

Структура:

docs/source/
├── index.md
├── section1/
│   ├── index.md
│   ├── cron.md
│   └── curl.md
└── section2/
    ├── index.md
    ├── flask.md
    ├── file4.md
    └── file5.md

index.md (главный):

# Документация проекта

```{toctree}
:maxdepth: 2
:caption: Содержание

section1/index
section2/index
```

section1/index.md:

# Раздел 1

```{toctree}
:maxdepth: 1

cron
curl
```

section2/index.md:

# Раздел 2

```{toctree}
:maxdepth: 1

flask
file4
file5
```

Если разделов немного (2-3) - используйте Способ 1 (проще всего). Если много документов и сложная структура - Способ 3 (с папками).

После изменений:

make clean && make html
Contents