Sphinx-doc TOC not updated with RTD theme

I have a sphinx-doc programmatically generated source that uses the Read-The-Docs theme. The source tree looks like this:

source
β”œβ”€β”€ conf.py
β”œβ”€β”€ index.rst
β”œβ”€β”€ models
β”‚   β”œβ”€β”€ 1lin
β”‚   β”‚   β”œβ”€β”€ 1lin_Amplero.rst
β”‚   β”‚   β”œβ”€β”€ 1lin_Blodgett.rst
β”‚   β”‚   β”œβ”€β”€ 1lin_Bugac.rst
β”‚   β”‚   β”œβ”€β”€ ..
β”‚   β”‚   β”œβ”€β”€ figures
β”‚   β”‚   β”‚   β”œβ”€β”€ 1lin_all_PLUMBER_plot_all_metrics.png
β”‚   β”‚   β”‚   β”œβ”€β”€ 1lin_all_PLUMBER_plot_distribution_metrics.png
β”‚   β”‚   β”‚   β”œβ”€β”€ 1lin_all_PLUMBER_plot_standard_metrics.png
β”‚   β”‚   β”‚   β”œβ”€β”€ Amplero
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ 1lin_Amplero_PLUMBER_plot_all_metrics.png
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ 1lin_Amplero_rank_counts_all_metrics.png
β”‚   β”‚   β”‚   ..  .. 
β”‚   β”‚   β”œβ”€β”€ index.rst
β”‚   β”‚   .. 
β”‚   β”œβ”€β”€ 2lin
β”‚   β”‚   β”œβ”€β”€ 2lin_Amplero.rst
β”‚   β”‚   β”œβ”€β”€ 2lin_Blodgett.rst
β”‚   β”‚   β”œβ”€β”€ 2lin_Bugac.rst
β”‚   β”‚   β”‚   ..  
β”‚   β”‚   β”œβ”€β”€ index.rst
β”‚   β”‚   .. 
β”œβ”€β”€ model_search.rst
β”œβ”€β”€ sphinx_static
β”‚   β”œβ”€β”€ jquery
β”‚   β”‚   β”œβ”€β”€ AUTHORS.txt
β”‚   ..  ..
β”œβ”€β”€ sphinx_templates
β”‚   └── layout.html
..

index.rst Includes TOC, for example:

.. toctree::
    :maxdepth: 2

    model_search

    ...

and model_search.rstincludes the entire index.rsts model :

.. toctree::
    :maxdepth: 1

    models/1lin/index
    models/2lin/index

    ...

When I originally created the source using make html, it builds beautifully and creates a TOC that includes all existing models.

, (, 3lin), make build , TOC (1lin, 2lin ..). , TOC , - conf.py (, / autodoc), touch .rst.

TOC ? , ?

+4
1

. Sphinx , . touch , make clean make html.

+1

Source: https://habr.com/ru/post/1657684/


All Articles