spatialaudio / nbsphinx

:ledger: Sphinx source parser for Jupyter notebooks
https://nbsphinx.readthedocs.io/
MIT License
457 stars 130 forks source link

0.8.8: nbconvert man page rendering fails with call trace #643

Open kloczek opened 2 years ago

kloczek commented 2 years ago

I'm buuklding all my rpm packages with pyton modules with sphinx documentation renedered as man pages. Rendering nbconvert man page I found that sphisnx fails with call trace

+ /usr/bin/python3 setup.py build_sphinx -b man --build-dir build/sphinx
running build_sphinx
Running Sphinx v4.5.0
making output directory... done
loading intersphinx inventory from https://docs.python.org/3.6/objects.inv...
loading intersphinx inventory from http://jinja.pocoo.org/docs/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: http://jinja.pocoo.org/docs/objects.inv -> https://jinja.palletsprojects.com/en/3.1.x/objects.inv
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 23 added, 0 changed, 0 removed
reading sources... [100%] usage
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/changelog.rst:22: WARNING: Inline interpreted text or phrase reference start-string without end-string.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-nbconvert.3 { install usage nbconvert_library dejavu latex_citations removing_cells execute_api config_options customizing external_exporters highlighting architecture api/index api/nbconvertapp api/exporters api/preprocessors api/filters api/writers api/postprocessors development_release changelog need_help } /home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2194: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2231: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2231: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2293: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2293: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2302: WARNING: 'any' reference target not found: cell_allows_errors
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2302: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2302: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2311: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2311: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2319: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2319: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2328: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2336: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2344: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2743: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2770: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2770: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2832: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2832: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2841: WARNING: 'any' reference target not found: cell_allows_errors
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2841: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2841: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2850: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2850: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2858: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2858: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2867: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2875: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2883: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/customizing.rst:7: WARNING: more than one target found for 'any' cross-reference 'TemplateExporter': could be :py:class:`nbconvert.exporters.TemplateExporter` or :py:class:`nbconvert.exporters.templateexporter.TemplateExporter`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/nbconvert_library.ipynb:: WARNING: unknown node type: <CodeAreaNode: <literal_block...>>
failed

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-vwbkyp29.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-vwbkyp29.log
# Sphinx version: 4.5.0
# Python version: 3.8.12 (CPython)
# Docutils version: 0.17.1 release
# Jinja2 version: 3.0.3
# Last messages:
#   api/exporters
#   api/preprocessors
#   api/filters
#   api/writers
#   api/postprocessors
#   development_release
#   changelog
#   need_help
#   }
#   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.extlinks (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/extlinks.py
#   sphinx.ext.intersphinx (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/intersphinx.py
#   sphinx.ext.napoleon (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/napoleon/__init__.py
#   nbsphinx (0.8.8) from /usr/lib/python3.8/site-packages/nbsphinx.py
#   IPython.sphinxext.ipython_console_highlighting (unknown version) from /usr/lib/python3.8/site-packages/IPython/sphinxext/ipython_console_highlighting.py
Traceback (most recent call last):
  File "/usr/lib/python3.8/site-packages/sphinx/setup_command.py", line 167, in run
    app.build(force_all=self.all_files)
  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 4 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

Disabling sphinx extensins listed in copy.py:

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.extlinks',
    'sphinx.ext.intersphinx',
    'sphinx.ext.napoleon',
    'nbsphinx',
    'IPython.sphinxext.ipython_console_highlighting',
]

I found that afterremove from above nbsphinx I found that I was able to render man page with exit 0.

+ /usr/bin/python3 setup.py build_sphinx -b man --build-dir build/sphinx
running build_sphinx
Running Sphinx v4.5.0
making output directory... done
loading intersphinx inventory from https://docs.python.org/3.6/objects.inv...
loading intersphinx inventory from http://jinja.pocoo.org/docs/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: http://jinja.pocoo.org/docs/objects.inv -> https://jinja.palletsprojects.com/en/3.1.x/objects.inv
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 22 added, 0 changed, 0 removed
reading sources... [100%] usage
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/changelog.rst:22: WARNING: Inline interpreted text or phrase reference start-string without end-string.
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/index.rst:33: WARNING: toctree contains reference to nonexisting document 'nbconvert_library'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-nbconvert.3 { install usage dejavu latex_citations removing_cells execute_api config_options customizing external_exporters highlighting architecture api/index api/nbconvertapp api/exporters api/preprocessors api/filters api/writers api/postprocessors development_release changelog need_help } /home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/execute_api.rst:11: WARNING: unknown document: nbconvert_library
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2194: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2231: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2231: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2293: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2293: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2302: WARNING: 'any' reference target not found: cell_allows_errors
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2302: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2302: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2311: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2311: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2319: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2319: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2328: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2336: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2344: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2743: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2770: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2770: WARNING: more than one target found for 'any' cross-reference 'CellExecutionError': could be :py:class:`nbconvert.preprocessors.CellExecutionError` or :py:class:`nbclient.exceptions.CellExecutionError`
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2832: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2832: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2841: WARNING: 'any' reference target not found: cell_allows_errors
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2841: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2841: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2850: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2850: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2858: WARNING: 'any' reference target not found: cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2858: WARNING: 'any' reference target not found: cell_index
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2867: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2875: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/config_options.rst:2883: WARNING: 'any' reference target not found: notebook
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.4.5/docs/source/customizing.rst:7: WARNING: more than one target found for 'any' cross-reference 'TemplateExporter': could be :py:class:`nbconvert.exporters.TemplateExporter` or :py:class:`nbconvert.exporters.templateexporter.TemplateExporter`
done
build succeeded, 34 warnings.

So looks like that potentially something mey be wrong with nbsphinx.

May I ask for some help?

mgeier commented 2 years ago

The man builder isn't really supported.

Quite recently, the text builder has gotten minimal support: #615

Maybe something similar (or even the exact same thing?) can be done for the man builder?

kloczek commented 2 years ago

It would be really nice to have roff outpu support asd man pages are still basic format of the sodumentation delivered across most of the projects o Unix platforms 😄

kloczek commented 2 years ago

Just tested nbconvert 6.5.0 and I'm no longer able to reproduce that issue. Closing.

+ /usr/bin/sphinx-build -n -T -b man docs/source build/sphinx/man
Running Sphinx v4.5.0
making output directory... done
loading intersphinx inventory from https://docs.python.org/3.6/objects.inv...
loading intersphinx inventory from http://jinja.pocoo.org/docs/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: http://jinja.pocoo.org/docs/objects.inv -> https://jinja.palletsprojects.com/en/3.1.x/objects.inv
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 22 added, 0 changed, 0 removed
reading sources... [100%] usage
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/docs/source/config_options.rst:2231: ERROR: Unexpected indentation.
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/docs/source/config_options.rst:2234: WARNING: Block quote ends without a blank line; unexpected unindent.
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/docs/source/config_options.rst:2794: ERROR: Unexpected indentation.
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/docs/source/config_options.rst:2797: WARNING: Block quote ends without a blank line; unexpected unindent.
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/docs/source/index.rst:33: WARNING: toctree contains reference to nonexisting document 'nbconvert_library'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-nbconvert.3 { install usage dejavu latex_citations removing_cells execute_api config_options customizing external_exporters highlighting architecture api/index api/nbconvertapp api/exporters api/preprocessors api/filters api/writers api/postprocessors development_release changelog need_help } /home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/docs/source/execute_api.rst:11: WARNING: unknown document: nbconvert_library
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/nbconvertapp.py:docstring of nbconvert.nbconvertapp.NbConvertApp.write_single_notebook:: WARNING: py:class reference target not found: file
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/base.py:docstring of nbconvert.exporters.base.export:9: WARNING: py:class reference target not found: nbformat.NotebookNode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/base.py:docstring of nbconvert.exporters.base.export:: WARNING: py:class reference target not found: config
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/base.py:docstring of nbconvert.exporters.base.export:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/base.py:docstring of nbconvert.exporters.base.export:: WARNING: py:class reference target not found: keyword arg
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/base.py:docstring of nbconvert.exporters.base.export:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/base.py:docstring of nbconvert.exporters.base.export:: WARNING: py:class reference target not found: keyword arg
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/exporter.py:docstring of nbconvert.exporters.exporter.Exporter.from_notebook_node:4: WARNING: py:class reference target not found: nbformat.NotebookNode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/exporter.py:docstring of nbconvert.exporters.exporter.Exporter.from_file:: WARNING: py:class reference target not found: file-like object
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/templateexporter.py:docstring of nbconvert.exporters.templateexporter.TemplateExporter.__init__:: WARNING: py:class reference target not found: config
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/templateexporter.py:docstring of nbconvert.exporters.templateexporter.TemplateExporter.__init__:: WARNING: py:class reference target not found: of Jinja Loaders
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/templateexporter.py:docstring of nbconvert.exporters.templateexporter.TemplateExporter.__init__:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/templateexporter.py:docstring of nbconvert.exporters.templateexporter.TemplateExporter.__init__:: WARNING: py:class reference target not found: kw arg
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/templateexporter.py:docstring of nbconvert.exporters.templateexporter.TemplateExporter.from_notebook_node:4: WARNING: py:class reference target not found: nbformat.NotebookNode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/exporters/exporter.py:docstring of nbconvert.exporters.exporter.Exporter.from_file:: WARNING: py:class reference target not found: file-like object
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/base.py:docstring of nbconvert.preprocessors.base.Preprocessor.__init__:: WARNING: py:class reference target not found: Config
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/base.py:docstring of nbconvert.preprocessors.base.Preprocessor.preprocess:: WARNING: py:class reference target not found: NotebookNode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/base.py:docstring of nbconvert.preprocessors.base.Preprocessor.preprocess:: WARNING: py:class reference target not found: dictionary
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/base.py:docstring of nbconvert.preprocessors.base.Preprocessor.preprocess_cell:: WARNING: py:class reference target not found: NotebookNode cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/base.py:docstring of nbconvert.preprocessors.base.Preprocessor.preprocess_cell:: WARNING: py:class reference target not found: dictionary
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess:: WARNING: py:class reference target not found: nbformat.notebooknode.NotebookNode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess:: WARNING: py:class reference target not found: NotebookNode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess:: WARNING: py:class reference target not found: dictionary
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess:: WARNING: py:class reference target not found: KernelManager
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess_cell:: WARNING: py:class reference target not found: NotebookNode cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/execute.py:docstring of nbconvert.preprocessors.execute.ExecutePreprocessor.preprocess_cell:: WARNING: py:class reference target not found: dictionary
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/coalescestreams.py:docstring of nbconvert.preprocessors.coalescestreams.coalesce_streams:: WARNING: py:class reference target not found: NotebookNode cell
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/preprocessors/coalescestreams.py:docstring of nbconvert.preprocessors.coalescestreams.coalesce_streams:: WARNING: py:class reference target not found: dictionary
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/ansi.py:docstring of nbconvert.filters.ansi.ansi2html:: WARNING: py:class reference target not found: unicode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/ansi.py:docstring of nbconvert.filters.ansi.ansi2latex:: WARNING: py:class reference target not found: unicode
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/strings.py:docstring of nbconvert.filters.strings.get_lines:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/strings.py:docstring of nbconvert.filters.strings.get_lines:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/pandoc.py:docstring of nbconvert.filters.pandoc.convert_pandoc:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/pandoc.py:docstring of nbconvert.filters.pandoc.convert_pandoc:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/pandoc.py:docstring of nbconvert.filters.pandoc.convert_pandoc:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/pandoc.py:docstring of nbconvert.filters.pandoc.convert_pandoc:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/utils/text.py:docstring of nbconvert.utils.text.indent:: WARNING: py:class reference target not found: basestring
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/utils/text.py:docstring of nbconvert.utils.text.indent:: WARNING: py:class reference target not found: default: 4
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/utils/text.py:docstring of nbconvert.utils.text.indent:: WARNING: py:class reference target not found: default: 0
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/utils/text.py:docstring of nbconvert.utils.text.indent:: WARNING: py:class reference target not found: default: False
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/utils/text.py:docstring of nbconvert.utils.text.indent:: WARNING: py:class reference target not found: string indented by ntabs and nspaces.
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/markdown.py:docstring of nbconvert.filters.markdown.markdown2latex:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/markdown.py:docstring of nbconvert.filters.markdown.markdown2latex:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/markdown.py:docstring of nbconvert.filters.markdown.markdown2latex:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/markdown.py:docstring of nbconvert.filters.markdown.markdown2rst:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/markdown.py:docstring of nbconvert.filters.markdown.markdown2rst:: WARNING: py:class reference target not found: string
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/filters/strings.py:docstring of nbconvert.filters.strings.wrap_text:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/nbconvert-6.5.0/nbconvert/writers/base.py:docstring of nbconvert.writers.base.WriterBase.write:: WARNING: py:class reference target not found: string
done
build succeeded, 56 warnings.
kloczek commented 2 years ago

gentle ping .. 🤔

kloczek commented 1 year ago

Looks like nbsphinx 0.8.10 has problem with rendering its own documentation as well

```console + /usr/bin/sphinx-build -n -T -b man doc build/sphinx/man Running Sphinx v5.3.0 fatal: not a git repository (or any parent up to mount point /home/tkloczko) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set). making output directory... done checking bibtex cache... out of date parsing bibtex file /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/doc/references.bib... parsed 2 entries loading intersphinx inventory from https://ipython.readthedocs.io/en/stable/objects.inv... loading intersphinx inventory from https://matplotlib.org/objects.inv... loading intersphinx inventory from https://docs.scipy.org/doc/numpy/objects.inv... loading intersphinx inventory from https://pandas.pydata.org/docs/objects.inv... loading intersphinx inventory from https://docs.python.org/3/objects.inv... intersphinx inventory has moved: https://matplotlib.org/objects.inv -> https://matplotlib.org/stable/objects.inv intersphinx inventory has moved: https://docs.scipy.org/doc/numpy/objects.inv -> https://numpy.org/doc/stable/objects.inv building [mo]: targets for 0 po files that are out of date building [man]: all manpages updating environment: [new config] 34 added, 0 changed, 0 removed /usr/lib/python3.8/site-packages/jupytext/cell_reader.py:20: UserWarning: Sphinx Gallery in version 0.11.1 is not supported by Jupytext. Please use sphinx-gallery<=0.7.0 instead. If that is an issue, feel free to report it at https://github.com/mwouts/jupytext/issues, or even better, prepare a PR to handle the new signature of sphinx_gallery.notebook.rst2md. warnings.warn( reading sources... [100%] yet-another getting Git timestamps for source files... [100%] /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/doc/subdir getting Git timestamps for dependencies... [100%] /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10 WARNING: Error getting data from Git (no "last updated" dates will be shown for source files from /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/doc): fatal: not a git repository (or any parent up to mount point /home/tkloczko) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set). WARNING: Error getting data from Git (no "last updated" dates will be shown for source files from /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/doc/gallery): fatal: not a git repository (or any parent up to mount point /home/tkloczko) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set). WARNING: Error getting data from Git (no "last updated" dates will be shown for source files from /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/doc/subdir): fatal: not a git repository (or any parent up to mount point /home/tkloczko) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set). looking for now-outdated files... none found pickling environment... done checking consistency... done writing... python-nbsphinx.3 { installation usage markdown-cells code-cells raw-cells hidden-cells executing-notebooks pre-executed never-execute allow-errors allow-errors-per-cell configuring-kernels timeout prolog-and-epilog custom-formats subdir/a-notebook-in-a-subdir subdir/gallery gallery/cell-tag gallery/cell-metadata gallery/multiple-outputs gallery/no-thumbnail gallery/thumbnail-from-conf-py subdir/toctree yet-another custom-css a-normal-rst-file gallery/uno-rst gallery/due-rst a-markdown-file links contributing version-history } /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/doc/installation.ipynb:81: WARNING: unknown node type: > failed Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 281, in build_main app.build(args.force_all, args.filenames) File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 347, in build self.builder.build_update() File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 307, in build_update self.build(['__all__'], to_build) File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 376, in build self.write(docnames, list(updated_docnames), method) File "/usr/lib/python3.8/site-packages/sphinx/util/__init__.py", line 527, in wrapper return f(*args, **kwargs) File "/usr/lib/python3.8/site-packages/sphinx/builders/manpage.py", line 98, 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 199, in walkabout if child.walkabout(visitor): File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 199, in walkabout if child.walkabout(visitor): File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 199, in walkabout if child.walkabout(visitor): [Previous line repeated 4 more times] File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 212, in walkabout visitor.dispatch_departure(self) File "/usr/lib/python3.8/site-packages/sphinx/util/docutils.py", line 585, in dispatch_departure super().dispatch_departure(node) File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2046, in dispatch_departure return method(node) File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2068, in unknown_departure raise NotImplementedError( NotImplementedError: departing unknown node type: AdmonitionNode Exception occurred: File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2068, in unknown_departure raise NotImplementedError( NotImplementedError: departing unknown node type: AdmonitionNode The full traceback has been saved in /tmp/sphinx-err-893ke965.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 . Thanks! [tkloczko@devel-g2v SPECS]$ cat /tmp/sphinx-err-893ke965.log # Sphinx version: 5.3.0 # Python version: 3.8.15 (CPython) # Docutils version: 0.18.1 release # Jinja2 version: 3.1.1 # Last messages: # custom-css # a-normal-rst-file # gallery/uno-rst # gallery/due-rst # a-markdown-file # links # contributing # version-history # } # failed # Loaded extensions: # sphinx.ext.mathjax (5.3.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 # nbsphinx (0.8.10) from /home/tkloczko/rpmbuild/BUILD/nbsphinx-0.8.10/src/nbsphinx.py # sphinxcontrib.bibtex (2.5.0) from /usr/lib/python3.8/site-packages/sphinxcontrib/bibtex/__init__.py # sphinx_gallery.load_style (0.11.1) from /usr/lib/python3.8/site-packages/sphinx_gallery/load_style.py # sphinx_last_updated_by_git (0.3.3) from /usr/lib/python3.8/site-packages/sphinx_last_updated_by_git.py # sphinx.ext.autodoc.preserve_defaults (5.3.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/preserve_defaults.py # sphinx.ext.autodoc.type_comment (5.3.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/type_comment.py # sphinx.ext.autodoc.typehints (5.3.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/typehints.py # sphinx.ext.autodoc (5.3.0) from /usr/lib/python3.8/site-packages/sphinx/ext/autodoc/__init__.py # sphinx_codeautolink (0.12.1) from /usr/lib/python3.8/site-packages/sphinx_codeautolink/__init__.py # sphinx.ext.intersphinx (5.3.0) from /usr/lib/python3.8/site-packages/sphinx/ext/intersphinx.py Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 281, in build_main app.build(args.force_all, args.filenames) File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 347, in build self.builder.build_update() File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 307, in build_update self.build(['__all__'], to_build) File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 376, in build self.write(docnames, list(updated_docnames), method) File "/usr/lib/python3.8/site-packages/sphinx/util/__init__.py", line 527, in wrapper return f(*args, **kwargs) File "/usr/lib/python3.8/site-packages/sphinx/builders/manpage.py", line 98, 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 199, in walkabout if child.walkabout(visitor): File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 199, in walkabout if child.walkabout(visitor): File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 199, in walkabout if child.walkabout(visitor): [Previous line repeated 4 more times] File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 212, in walkabout visitor.dispatch_departure(self) File "/usr/lib/python3.8/site-packages/sphinx/util/docutils.py", line 585, in dispatch_departure super().dispatch_departure(node) File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2046, in dispatch_departure return method(node) File "/usr/lib/python3.8/site-packages/docutils/nodes.py", line 2068, in unknown_departure raise NotImplementedError( NotImplementedError: departing unknown node type: AdmonitionNode ```

List of modules installed in build env:

list of modules installed in build env ```console Package Version ------------------------------ ----------------- alabaster 0.7.12 appdirs 1.4.4 asttokens 2.0.5 attrs 22.1.0 Babel 2.11.0 backcall 0.2.0 beautifulsoup4 4.11.1 bleach 5.0.0 Brlapi 0.8.3 build 0.9.0 charset-normalizer 3.0.0 contourpy 1.0.6 cssselect 1.1.0 cycler 0.11.0 debugpy 1.6.3 decorator 5.1.1 defusedxml 0.7.1 distro 1.8.0 dnspython 2.2.1 docutils 0.18.1 entrypoints 0.4 executing 1.1.1 extras 1.0.0 fastjsonschema 2.16.1 fixtures 4.0.0 fonttools 4.38.0 gpg 1.17.1-unknown html5lib 1.1 idna 3.4 imagesize 1.4.1 importlib-metadata 5.0.0 importlib-resources 5.9.0 iniconfig 1.1.1 ipykernel 6.17.1 ipython 8.5.0 ipywidgets 8.0.1 jedi 0.18.1 Jinja2 3.1.1 jsonschema 4.17.0 jupyter_client 7.4.5 jupyter_core 5.0.0 jupyterlab-pygments 0.1.2 jupyterlab-widgets 3.0.2 jupytext 1.14.1 kiwisolver 1.4.4 latexcodec 2.0.1 libcomps 0.1.19 louis 3.23.0 lxml 4.9.1 markdown-it-py 2.1.0 MarkupSafe 2.1.1 matplotlib 3.6.2 matplotlib-inline 0.1.5 mdit-py-plugins 0.3.1 mdurl 0.1.2 mistune 2.0.4 nbclient 0.7.0 nbconvert 7.2.2 nbformat 5.7.0 nest-asyncio 1.5.6 numpy 1.23.1 olefile 0.46 packaging 21.3 pandas 1.4.2 pandocfilters 1.5.0 parso 0.8.3 pbr 5.9.0 pep517 0.13.0 pexpect 4.8.0 pickleshare 0.7.5 Pillow 9.3.0 pip 22.2.2 pkgutil_resolve_name 1.3.10 platformdirs 2.5.2 pluggy 1.0.0 prompt-toolkit 3.0.29 psutil 5.9.2 ptyprocess 0.7.0 pure-eval 0.2.2 py 1.11.0 pybtex 0.24.0 pybtex-docutils 1.0.2 Pygments 2.13.0 PyGObject 3.42.2 pyparsing 3.0.9 pyrsistent 0.19.2 pytest 7.1.3 python-dateutil 2.8.2 pytz 2022.4 PyYAML 6.0 pyzmq 24.0.0 requests 2.28.1 rpm 4.17.0 scour 0.38.2 setuptools 65.5.1 six 1.16.0 snowballstemmer 2.2.0 soupsieve 2.3.2.post1 Sphinx 5.3.0 sphinx-codeautolink 0.12.1 sphinx-gallery 0.11.1 sphinx-last-updated-by-git 0.3.3 sphinxcontrib-applehelp 1.0.2.dev20220730 sphinxcontrib-bibtex 2.5.0 sphinxcontrib-devhelp 1.0.2.dev20220730 sphinxcontrib-htmlhelp 2.0.0 sphinxcontrib-jsmath 1.0.1.dev20220730 sphinxcontrib-qthelp 1.0.3.dev20220730 sphinxcontrib-serializinghtml 1.1.5 sphinxcontrib-svg2pdfconverter 1.2.0 stack-data 0.5.1 testtools 2.5.0 tinycss2 1.2.1 toml 0.10.2 tomli 2.0.1 tornado 6.2 traitlets 5.4.0 urllib3 1.26.12 wcwidth 0.2.5 webencodings 0.5.1 wheel 0.37.1 widgetsnbextension 4.0.3 zipp 3.9.0 ```
mgeier commented 1 year ago

Looks like nbsphinx 0.8.10 has problem with rendering its own documentation as well

Sure. As I said, the man builder isn't really supported.

I'm not planning to implement this, but I'm open for pull requests!