notebook icon indicating copy to clipboard operation
notebook copied to clipboard

Published 20 hours ago • verified publisher icon jupyter

6.4.11: sphins fails

Open kloczek opened this issue 3 years ago • 2 comments
trafficstars

Looks like it is some issue on building sphinx documentation

+ /usr/bin/sphinx-build -n -T -b man docs/source build/sphinx/man
Running Sphinx v4.5.0
DEBUG:: sys.path
================
/usr/bin
/usr/lib64/python38.zip
/usr/lib64/python3.8
/usr/lib64/python3.8/lib-dynload
/usr/lib64/python3.8/site-packages
/usr/lib/python3.8/site-packages
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
repo_root
=====================
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
DEBUG:: Post insert to sys.path
===============================
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
/usr/bin
/usr/lib64/python38.zip
/usr/lib64/python3.8
/usr/lib64/python3.8/lib-dynload
/usr/lib64/python3.8/site-packages
/usr/lib/python3.8/site-packages
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
Initializing GitHub plugin
making output directory... done
loading intersphinx inventory from https://ipython.readthedocs.io/en/stable/objects.inv...
loading intersphinx inventory from https://nbconvert.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://jupyter.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: https://jupyter.readthedocs.io/en/latest/objects.inv -> https://docs.jupyter.org/en/latest/objects.inv
[autosummary] generating autosummary for: changelog.md, comms.rst, config_overview.rst, contributing.rst, development_faq.rst, examples/Notebook/Connecting with the Qt Console.ipynb, examples/Notebook/Custom Keyboard Shortcuts.ipynb, examples/Notebook/Distributing Jupyter Extensions as Python Packages.ipynb, examples/Notebook/Importing Notebooks.ipynb, examples/Notebook/JavaScript Notebook Extensions.ipynb, ..., extending/index.rst, extending/keymaps.rst, extending/savehooks.rst, frontend_config.rst, index.rst, notebook.rst, public_server.rst, security.rst, troubleshooting.rst, ui_components.rst
myst v0.17.2: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions=['html_image'], linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=False, mathjax_classes='tex2jax_process|mathjax_process|math|output_area', disable_syntax=[], all_links_external=False, url_schemes=('http', 'https', 'mailto', 'ftp'), ref_domains=None, highlight_code_blocks=True, number_code_blocks=[], title_to_header=False, heading_anchors=None, heading_slug_func=None, footnote_transition=True, sub_delimiters=('{', '}'), words_per_minute=200)
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 32 added, 0 changed, 0 removed
reading sources... [100%] ui_components
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/index.rst:19: WARNING: toctree contains reference to nonexisting document 'config'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-jupyternotebook.3 { notebook ui_components examples/Notebook/examples_index examples/Notebook/What is the Jupyter Notebook examples/Notebook/Notebook Basics examples/Notebook/Running Code examples/Notebook/Working With Markdown Cells examples/Notebook/Custom Keyboard Shortcuts examples/Notebook/JavaScript Notebook Extensions examples/Notebook/Importing Notebooks examples/Notebook/Connecting with the Qt Console examples/Notebook/Typesetting Equations troubleshooting changelog comms config_overview frontend_config public_server security examples/Notebook/Distributing Jupyter Extensions as Python Packages extending/index extending/contents extending/savehooks extending/handlers extending/frontend_extensions extending/keymaps extending/bundler_extensions contributing development_faq examples/Notebook/nbpackage/mynotebook examples/Notebook/nbpackage/nbs/other } /home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/public_server.rst:50: WARNING: py:attr reference target not found: NotebookApp.password
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/public_server.rst:113: WARNING: py:func reference target not found: notebook.auth.security.passwd
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/public_server.rst:126: WARNING: py:func reference target not found: notebook.auth.security.passwd
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:11: WARNING: py:class reference target not found: manager.ContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:11: WARNING: py:class reference target not found: filemanager.FileContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:75: WARNING: py:class reference target not found: nbformat.notebooknode.NotebookNode
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:186: WARNING: py:class reference target not found: manager.ContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.get
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.delete_file
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.rename_file
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.file_exists
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.dir_exists
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.is_hidden
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:211: WARNING: py:meth reference target not found: manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:216: WARNING: py:meth reference target not found: manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:229: WARNING: py:mod reference target not found: notebook.services.contents.checkpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.rename_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.list_checkpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.delete_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.create_file_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.create_notebook_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.get_file_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.get_notebook_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:272: WARNING: py:mod reference target not found: notebook.services.contents.filecheckpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:279: WARNING: py:mod reference target not found: notebook.services.contents.tests
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/Running Code.ipynb:: WARNING: unknown node type: <CodeAreaNode: <literal_block...>>
failed

Traceback (most recent call last):
  File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 276, in build_main
    app.build(args.force_all, filenames)
  File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 330, in build
    self.builder.build_update()
  File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 283, in build_update
    self.build(['__all__'], to_build)
  File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 350, in build
    self.write(docnames, list(updated_docnames), method)
  File "/usr/lib/python3.8/site-packages/sphinx/util/__init__.py", line 540, in wrapper
    return f(*args, **kwargs)
  File "/usr/lib/python3.8/site-packages/sphinx/builders/manpage.py", line 93, in write
    docwriter.write(largetree, destination)
  File "/usr/lib/python3.8/site-packages/docutils/writers/__init__.py", line 78, in write
    self.translate()
  File "/usr/lib/python3.8/site-packages/sphinx/writers/manpage.py", line 31, in translate
    self.document.walkabout(visitor)
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 227, in walkabout
    if child.walkabout(visitor):
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 227, in walkabout
    if child.walkabout(visitor):
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 227, in walkabout
    if child.walkabout(visitor):
  [Previous line repeated 7 more times]
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 240, in walkabout
    visitor.dispatch_departure(self)
  File "/usr/lib/python3.8/site-packages/sphinx/util/docutils.py", line 536, in dispatch_departure
    super().dispatch_departure(node)
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2034, in dispatch_departure
    return method(node)
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2056, in unknown_departure
    raise NotImplementedError(
NotImplementedError: <class 'sphinx.writers.manpage.ManualPageTranslator'> departing unknown node type: CodeAreaNode

Exception occurred:
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2056, in unknown_departure
    raise NotImplementedError(
NotImplementedError: <class 'sphinx.writers.manpage.ManualPageTranslator'> departing unknown node type: CodeAreaNode
The full traceback has been saved in /tmp/sphinx-err-y5iic880.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

[tkloczko@devel-g2v SPECS]$ cat /tmp/sphinx-err-y5iic880.log
# Sphinx version: 4.5.0
# Python version: 3.8.13 (CPython)
# Docutils version: 0.17.1 release
# Jinja2 version: 3.1.1
# Last messages:
#   extending/handlers
#   extending/frontend_extensions
#   extending/keymaps
#   extending/bundler_extensions
#   contributing
#   development_faq
#   examples/Notebook/nbpackage/mynotebook
#   examples/Notebook/nbpackage/nbs/other
#   }
#   failed
# Loaded extensions:
#   sphinx.ext.mathjax (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/mathjax.py
#   sphinxcontrib.applehelp (1.0.2) from /usr/lib/python3.8/site-packages/sphinxcontrib/applehelp/__init__.py
#   sphinxcontrib.devhelp (1.0.2) from /usr/lib/python3.8/site-packages/sphinxcontrib/devhelp/__init__.py
#   sphinxcontrib.htmlhelp (2.0.0) from /usr/lib/python3.8/site-packages/sphinxcontrib/htmlhelp/__init__.py
#   sphinxcontrib.serializinghtml (1.1.5) from /usr/lib/python3.8/site-packages/sphinxcontrib/serializinghtml/__init__.py
#   sphinxcontrib.qthelp (1.0.3) from /usr/lib/python3.8/site-packages/sphinxcontrib/qthelp/__init__.py
#   alabaster (0.7.12) from /usr/lib/python3.8/site-packages/alabaster/__init__.py
#   sphinx.ext.autodoc.preserve_defaults (1.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/preserve_defaults.py
#   sphinx.ext.autodoc.type_comment (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/type_comment.py
#   sphinx.ext.autodoc (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/__init__.py
#   sphinx.ext.doctest (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/doctest.py
#   sphinx.ext.intersphinx (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/intersphinx.py
#   sphinx.ext.autosummary (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autosummary/__init__.py
#   IPython.sphinxext.ipython_console_highlighting (unknown version) from /usr/lib/python3.8/site-packages/IPython/sphinxext/ipython_console_highlighting.py
#   nbsphinx (0.8.8) from /usr/lib/python3.8/site-packages/nbsphinx.py
#   sphinxcontrib_github_alt (unknown version) from /usr/lib/python3.8/site-packages/sphinxcontrib_github_alt.py
#   myst_parser (0.17.2) from /usr/lib/python3.8/site-packages/myst_parser/__init__.py
Traceback (most recent call last):
  File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 276, in build_main
    app.build(args.force_all, filenames)
  File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 330, in build
    self.builder.build_update()
  File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 283, in build_update
    self.build(['__all__'], to_build)
  File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 350, in build
    self.write(docnames, list(updated_docnames), method)
  File "/usr/lib/python3.8/site-packages/sphinx/util/__init__.py", line 540, in wrapper
    return f(*args, **kwargs)
  File "/usr/lib/python3.8/site-packages/sphinx/builders/manpage.py", line 93, in write
    docwriter.write(largetree, destination)
  File "/usr/lib/python3.8/site-packages/docutils/writers/__init__.py", line 78, in write
    self.translate()
  File "/usr/lib/python3.8/site-packages/sphinx/writers/manpage.py", line 31, in translate
    self.document.walkabout(visitor)
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 227, in walkabout
    if child.walkabout(visitor):
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 227, in walkabout
    if child.walkabout(visitor):
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 227, in walkabout
    if child.walkabout(visitor):
  [Previous line repeated 7 more times]
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 240, in walkabout
    visitor.dispatch_departure(self)
  File "/usr/lib/python3.8/site-packages/sphinx/util/docutils.py", line 536, in dispatch_departure
    super().dispatch_departure(node)
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2034, in dispatch_departure
    return method(node)
  File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2056, in unknown_departure
    raise NotImplementedError(
NotImplementedError: <class 'sphinx.writers.manpage.ManualPageTranslator'> departing unknown node type: CodeAreaNode

kloczek avatar May 13 '22 08:05 kloczek

Looks like it is yet another case of nbsphix ext issue. After remove that module with patch

--- a/docs/source/conf.py~      2022-05-13 08:27:18.383082877 +0000
+++ b/docs/source/conf.py       2022-05-13 08:29:16.961130615 +0000
@@ -73,7 +73,6 @@
     'sphinx.ext.autosummary',
     'sphinx.ext.mathjax',
     'IPython.sphinxext.ipython_console_highlighting',
-    'nbsphinx',
     'sphinxcontrib_github_alt',
     'myst_parser'
 ]

I was able to generate documentation

[tkloczko@devel-g2v notebook-6.4.11]$ /usr/bin/sphinx-build -n -T -b man docs/source build/sphinx/man
Running Sphinx v4.5.0
DEBUG:: sys.path
================
/usr/bin
/usr/lib64/python38.zip
/usr/lib64/python3.8
/usr/lib64/python3.8/lib-dynload
/usr/lib64/python3.8/site-packages
/usr/lib/python3.8/site-packages
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
repo_root
=====================
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
DEBUG:: Post insert to sys.path
===============================
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
/usr/bin
/usr/lib64/python38.zip
/usr/lib64/python3.8
/usr/lib64/python3.8/lib-dynload
/usr/lib64/python3.8/site-packages
/usr/lib/python3.8/site-packages
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11
Initializing GitHub plugin
loading intersphinx inventory from https://ipython.readthedocs.io/en/stable/objects.inv...
loading intersphinx inventory from https://nbconvert.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://jupyter.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: https://jupyter.readthedocs.io/en/latest/objects.inv -> https://docs.jupyter.org/en/latest/objects.inv
[autosummary] generating autosummary for: changelog.md, comms.rst, config_overview.rst, contributing.rst, development_faq.rst, examples/Notebook/examples_index.rst, extending/bundler_extensions.rst, extending/contents.rst, extending/frontend_extensions.rst, extending/handlers.rst, extending/index.rst, extending/keymaps.rst, extending/savehooks.rst, frontend_config.rst, index.rst, notebook.rst, public_server.rst, security.rst, troubleshooting.rst, ui_components.rst
myst v0.17.2: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions=['html_image'], linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=False, mathjax_classes='tex2jax_process|mathjax_process|math|output_area', disable_syntax=[], all_links_external=False, url_schemes=('http', 'https', 'mailto', 'ftp'), ref_domains=None, highlight_code_blocks=True, number_code_blocks=[], title_to_header=False, heading_anchors=None, heading_slug_func=None, footnote_transition=True, sub_delimiters=('{', '}'), words_per_minute=200)
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 20 added, 0 changed, 0 removed
reading sources... [100%] ui_components
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/What is the Jupyter Notebook'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Notebook Basics'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Running Code'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Working With Markdown Cells'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Custom Keyboard Shortcuts'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/JavaScript Notebook Extensions'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Importing Notebooks'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Connecting with the Qt Console'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Typesetting Equations'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/index.rst:19: WARNING: toctree contains reference to nonexisting document 'config'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/index.rst:19: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Distributing Jupyter Extensions as Python Packages'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/index.rst:38: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/nbpackage/mynotebook.ipynb'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/index.rst:38: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/nbpackage/nbs/other.ipynb'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-jupyternotebook.3 { notebook ui_components examples/Notebook/examples_index troubleshooting changelog comms config_overview frontend_config public_server security extending/index extending/contents extending/savehooks extending/handlers extending/frontend_extensions extending/keymaps extending/bundler_extensions contributing development_faq } /home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/public_server.rst:50: WARNING: py:attr reference target not found: NotebookApp.password
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/public_server.rst:113: WARNING: py:func reference target not found: notebook.auth.security.passwd
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/public_server.rst:126: WARNING: py:func reference target not found: notebook.auth.security.passwd
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:11: WARNING: py:class reference target not found: manager.ContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:11: WARNING: py:class reference target not found: filemanager.FileContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:75: WARNING: py:class reference target not found: nbformat.notebooknode.NotebookNode
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:186: WARNING: py:class reference target not found: manager.ContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.get
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.delete_file
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.rename_file
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.file_exists
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.dir_exists
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.is_hidden
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:211: WARNING: py:meth reference target not found: manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:216: WARNING: py:meth reference target not found: manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:229: WARNING: py:mod reference target not found: notebook.services.contents.checkpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.rename_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.list_checkpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.delete_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.create_file_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.create_notebook_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.get_file_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.get_notebook_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:272: WARNING: py:mod reference target not found: notebook.services.contents.filecheckpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.11/docs/source/extending/contents.rst:279: WARNING: py:mod reference target not found: notebook.services.contents.tests
done
build succeeded, 39 warnings.

The manual pages are in build/sphinx/man.

It would be good to clean above warnings ..

kloczek avatar May 13 '22 08:05 kloczek

Here is updates list of warnings for just released 6.4.12

+ SETUPTOOLS_SCM_PRETEND_VERSION=6.4.12
+ /usr/bin/sphinx-build -n -T -b man docs/source build/sphinx/man
Running Sphinx v5.0.1
DEBUG:: sys.path
================
/usr/bin
/usr/lib64/python38.zip
/usr/lib64/python3.8
/usr/lib64/python3.8/lib-dynload
/usr/lib64/python3.8/site-packages
/usr/lib/python3.8/site-packages
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12
repo_root
=====================
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12
DEBUG:: Post insert to sys.path
===============================
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12
/usr/bin
/usr/lib64/python38.zip
/usr/lib64/python3.8
/usr/lib64/python3.8/lib-dynload
/usr/lib64/python3.8/site-packages
/usr/lib/python3.8/site-packages
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12
WARNING: Invalid configuration value found: 'language = None'. Update your configuration to a valid langauge code. Falling back to 'en' (English).
Initializing GitHub plugin
making output directory... done
loading intersphinx inventory from https://ipython.readthedocs.io/en/stable/objects.inv...
loading intersphinx inventory from https://nbconvert.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://jupyter.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: https://jupyter.readthedocs.io/en/latest/objects.inv -> https://docs.jupyter.org/en/latest/objects.inv
[autosummary] generating autosummary for: changelog.md, comms.rst, config_overview.rst, contributing.rst, development_faq.rst, examples/Notebook/examples_index.rst, extending/bundler_extensions.rst, extending/contents.rst, extending/frontend_extensions.rst, extending/handlers.rst, extending/index.rst, extending/keymaps.rst, extending/savehooks.rst, frontend_config.rst, index.rst, notebook.rst, public_server.rst, security.rst, troubleshooting.rst, ui_components.rst
myst v0.17.2: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions=['html_image'], linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=False, mathjax_classes='tex2jax_process|mathjax_process|math|output_area', disable_syntax=[], all_links_external=False, url_schemes=('http', 'https', 'mailto', 'ftp'), ref_domains=None, highlight_code_blocks=True, number_code_blocks=[], title_to_header=False, heading_anchors=None, heading_slug_func=None, footnote_transition=True, sub_delimiters=('{', '}'), words_per_minute=200)
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 20 added, 0 changed, 0 removed
reading sources... [100%] ui_components
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/What is the Jupyter Notebook'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Notebook Basics'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Running Code'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Working With Markdown Cells'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Custom Keyboard Shortcuts'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/JavaScript Notebook Extensions'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Importing Notebooks'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Connecting with the Qt Console'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/examples/Notebook/examples_index.rst:11: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Typesetting Equations'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/index.rst:19: WARNING: toctree contains reference to nonexisting document 'config'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/index.rst:19: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/Distributing Jupyter Extensions as Python Packages'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/index.rst:38: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/nbpackage/mynotebook.ipynb'
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/index.rst:38: WARNING: toctree contains reference to nonexisting document 'examples/Notebook/nbpackage/nbs/other.ipynb'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-jupyternotebook.3 { notebook ui_components examples/Notebook/examples_index troubleshooting changelog comms config_overview frontend_config public_server security extending/index extending/contents extending/savehooks extending/handlers extending/frontend_extensions extending/keymaps extending/bundler_extensions contributing development_faq } /home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/public_server.rst:50: WARNING: py:attr reference target not found: NotebookApp.password
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/public_server.rst:113: WARNING: py:func reference target not found: notebook.auth.security.passwd
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/public_server.rst:126: WARNING: py:func reference target not found: notebook.auth.security.passwd
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:11: WARNING: py:class reference target not found: manager.ContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:11: WARNING: py:class reference target not found: filemanager.FileContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:75: WARNING: py:class reference target not found: nbformat.notebooknode.NotebookNode
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:186: WARNING: py:class reference target not found: manager.ContentsManager
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.get
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.delete_file
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.rename_file
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.file_exists
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.dir_exists
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:198:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.manager.ContentsManager.is_hidden
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:211: WARNING: py:meth reference target not found: manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:216: WARNING: py:meth reference target not found: manager.ContentsManager.save
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:229: WARNING: py:mod reference target not found: notebook.services.contents.checkpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.rename_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.list_checkpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.Checkpoints.delete_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.create_file_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.create_notebook_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.get_file_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:242:<autosummary>:1: WARNING: py:obj reference target not found: notebook.services.contents.checkpoints.GenericCheckpointsMixin.get_notebook_checkpoint
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:272: WARNING: py:mod reference target not found: notebook.services.contents.filecheckpoints
/home/tkloczko/rpmbuild/BUILD/notebook-6.4.12/docs/source/extending/contents.rst:279: WARNING: py:mod reference target not found: notebook.services.contents.tests
done
build succeeded, 40 warnings.

You can peak on fixes that kind of issues in other projects https://github.com/latchset/jwcrypto/pull/289 https://github.com/click-contrib/sphinx-click/commit/abc31069 https://github.com/latchset/jwcrypto/pull/289 https://github.com/RDFLib/rdflib-sqlalchemy/issues/95 https://github.com/sissaschool/elementpath/commit/bf869d9e https://github.com/jaraco/cssutils/issues/21

kloczek avatar Jun 15 '22 06:06 kloczek