Skip to content

Documentation notebooks in jupyter_execute recursively added when successively building locally the documentation #2898

@jlenh

Description

@jlenh

Describe the bug
After building locally the documentation following the instructions, I noticed some warnings adding up. It seems that the notebooks are recursively copied/built inside the jupyter_execute folder, leading to another layer of nested directories every time the documentation is built.

Please attach
Output from running sphinx-build -Ea doc doc/build

building [mo]: all of 0 po files
writing output... 
building [html]: all source files
updating environment: [new config] 66 added, 0 changed, 0 removed
reading sources... [100%] recipe/preprocessor
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/notebooks/composing-recipes.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/notebooks/discovering-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
/home/sm_julle/projects/ESMValCore/doc/jupyter_execute/notebooks/loading-and-processing-data.ipynb: WARNING: document isn't included in any toctree [toc.not_included]
done
preparing documents... done
copying assets... 
copying downloadable files... [100%] ../../esmvalcore/config/configurations/defaults/extra_facets_access.yml
copying static files... 
Writing evaluated template result to /home/sm_julle/projects/ESMValCore/doc/build/_static/documentation_options.js
Writing evaluated template result to /home/sm_julle/projects/ESMValCore/doc/build/_static/basic.css
Writing evaluated template result to /home/sm_julle/projects/ESMValCore/doc/build/_static/language_data.js
copying static files: done
copying extra files... 
copying extra files: done
copying assets: done
writing output... [100%] recipe/preprocessor
generating indices... genindex py-modindex done
highlighting module code... [100%] esmvalcore.preprocessor.regrid_schemes
writing additional pages... search done
copying images... [100%] jupyter_execute/6c6a51121e0e8a8a99301985e9b03a5f52919e8521b6cffade11c7be07bf4665.png
dumping search index in English (code: en)... done
dumping object inventory... done
build succeeded, 24 warnings.

The HTML pages are in doc/build.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions