0.4.7: sphinx warnings

[kloczek]

Looks like sphinx on generate documentation shows few warnings

+ /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man
Running Sphinx v4.5.0
making output directory... done
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 9 added, 0 changed, 0 removed
reading sources... [100%] installation
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/tkloczko/rpmbuild/BUILD/jupyterlite-sphinx-0.4.7/docs/bqplot.ipynb: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/jupyterlite-sphinx-0.4.7/docs/directives/my_notebook.ipynb: WARNING: document isn't included in any toctree
done
writing... python-jupyterlite-sphinx.3 { installation configuration directives/jupyterlite directives/retrolite directives/replite full } done
build succeeded, 2 warnings.

[martinRenou]

Thanks, I don't know what we can do with this. The Notebook are indeed not included in the doctree, but they are not supposed to be included. We need a way to tell sphinx to ignore the ipynb files.

[kloczek]

Here is my current list of the fixes similar issues in other modules
latchset/jwcrypto#289
click-contrib/sphinx-click@abc31069
latchset/jwcrypto#289
RDFLib/rdflib-sqlalchemy#95

[benbovy]

Maybe via a "orphan": true notebook metadata entry? This seems to be what MyST-NB uses to ignore the warnings.

[Carreau]

I believe this has been fixed since this issue has been opened. It would be great for someone to try to reproduce and confirm. Thanks.

[melissawm]

I was trying to look into this but I am also hitting #177 when building the docs.

[agriyakhetarpal]

I have faced #177 before (with unusually slow download speeds, rather) and what I usually do for local development is that I uninstall the Xeus kernel for local development because of said problem, since it's not necessarily required.

I've tried to reproduce this and I don't see any warnings for orphan pages such as the one(s) suggested.