0.13.2: sphinx fails on generate man page #402
Labels
bug
Something isn't working
Comments
|
Heya, yeh cheers for the feedback, this will be fixed in #380 |
|
Is that PR can be applied on top of last release? |
|
After merging #380, this now works Note there are some warnings, but this IMO is to be expected for these output types that man does not support: |
|
Yupi 😄 |
|
There are to many paches to integrate with my build procedure so will wait on next release. |
|
Q: is it known ETA of next release? 🤔 |
Next release!? I've already done two since 0.13.2 😅 |
|
OK so looks like it is another issue with generate man page in 0.15.0. Coconut: Installing Jupyter kernels 'coconut_py', 'coconut_py2', 'coconut_py3'...
Coconut: Successfully installed Jupyter kernels: 'coconut_py', 'coconut_py2', 'coconut_py3'
myst v0.17.2: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions=['amsmath', 'colon_fence', 'deflist', 'dollarmath', 'html_image'], linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=True, 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)
myst-nb v0.15.0: NbParserConfig(custom_formats={'.Rmd': ('jupytext.reads', {'fmt': 'Rmd'}, False)}, metadata_key='mystnb', cell_metadata_key='mystnb', kernel_rgx_aliases={}, execution_mode='cache', execution_cache_path='', execution_excludepatterns=(), execution_timeout=60, execution_in_temp=False, execution_allow_errors=False, execution_raise_on_error=False, execution_show_tb=False, merge_streams=False, render_plugin='default', remove_code_source=False, remove_code_outputs=False, number_source_lines=False, output_stderr='show', render_text_lexer='myst-ansi', render_error_lexer='ipythontb', render_image_options={}, render_figure_options={}, render_markdown_format='commonmark', output_folder='build', append_css=True, metadata_to_fm=False)
Using jupyter-cache at: /home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/build/sphinx/.jupyter_cache
loading intersphinx inventory from https://docs.python.org/3.8/objects.inv...
loading intersphinx inventory from https://jupyterbook.org/objects.inv...
loading intersphinx inventory from https://myst-parser.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://markdown-it-py.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://nbclient.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://www.sphinx-doc.org/en/master/objects.inv...
intersphinx inventory has moved: https://jupyterbook.org/objects.inv -> https://jupyterbook.org/en/stable/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... [ 9%] authoring/custom-formats
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 300, in build
updated_docnames = set(self.read())
File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 407, in read
self._read_serial(docnames)
File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 428, in _read_serial
self.read_doc(docname)
File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 468, in read_doc
doctree = read_doc(self.app, self.env, self.env.doc2path(docname))
File "/usr/lib/python3.8/site-packages/sphinx/io.py", line 181, in read_doc
pub.publish()
File "/usr/lib/python3.8/site-packages/docutils/core.py", line 217, in publish
self.document = self.reader.read(self.source, self.parser,
File "/usr/lib/python3.8/site-packages/sphinx/io.py", line 101, in read
self.parse()
File "/usr/lib/python3.8/site-packages/docutils/readers/__init__.py", line 78, in parse
self.parser.parse(self.input, document)
File "/home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/myst_nb/sphinx_.py", line 123, in parse
nb_renderer: NbElementRenderer = load_renderer(renderer_name)(
File "/home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/myst_nb/core/render.py", line 849, in load_renderer
raise EntryPointError(f"No Entry Point found for {RENDER_ENTRY_GROUP}:{name}")
myst_nb.core.render.EntryPointError: No Entry Point found for myst_nb.renderers:default
Exception occurred:
File "/home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/myst_nb/core/render.py", line 849, in load_renderer
raise EntryPointError(f"No Entry Point found for {RENDER_ENTRY_GROUP}:{name}")
myst_nb.core.render.EntryPointError: No Entry Point found for myst_nb.renderers:default
The full traceback has been saved in /tmp/sphinx-err-aqtv4l29.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! |
|
Or it could be some sphinx-design issue .. [tkloczko@devel-g2v SPECS]$ cat /tmp/sphinx-err-aqtv4l29.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:
# loading intersphinx inventory from https://nbformat.readthedocs.io/en/latest/objects.inv...
# loading intersphinx inventory from https://www.sphinx-doc.org/en/master/objects.inv...
# intersphinx inventory has moved: https://jupyterbook.org/objects.inv -> https://jupyterbook.org/en/stable/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... [ 4%] authoring/basics
# reading sources... [ 9%] authoring/custom-formats
# 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_togglebutton (0.3.1) from /usr/lib/python3.8/site-packages/sphinx_togglebutton/__init__.py
# myst_nb (0.15.0) from /home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/myst_nb/__init__.py
# sphinx_copybutton (0.4.0) from /usr/lib/python3.8/site-packages/sphinx_copybutton/__init__.py
# sphinx_book_theme (unknown version) from /usr/lib/python3.8/site-packages/sphinx_book_theme/__init__.py
# sphinx.ext.intersphinx (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/intersphinx.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.viewcode (4.5.0) from /usr/lib/python3.8/site-packages/sphinx/ext/viewcode.py
# sphinx_design (0.0.13) from /usr/lib/python3.8/site-packages/sphinx_design/__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 300, in build
updated_docnames = set(self.read())
File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 407, in read
self._read_serial(docnames)
File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 428, in _read_serial
self.read_doc(docname)
File "/usr/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 468, in read_doc
doctree = read_doc(self.app, self.env, self.env.doc2path(docname))
File "/usr/lib/python3.8/site-packages/sphinx/io.py", line 181, in read_doc
pub.publish()
File "/usr/lib/python3.8/site-packages/docutils/core.py", line 217, in publish
self.document = self.reader.read(self.source, self.parser,
File "/usr/lib/python3.8/site-packages/sphinx/io.py", line 101, in read
self.parse()
File "/usr/lib/python3.8/site-packages/docutils/readers/__init__.py", line 78, in parse
self.parser.parse(self.input, document)
File "/home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/myst_nb/sphinx_.py", line 123, in parse
nb_renderer: NbElementRenderer = load_renderer(renderer_name)(
File "/home/tkloczko/rpmbuild/BUILD/MyST-NB-0.15.0/myst_nb/core/render.py", line 849, in load_renderer
raise EntryPointError(f"No Entry Point found for {RENDER_ENTRY_GROUP}:{name}")
myst_nb.core.render.EntryPointError: No Entry Point found for myst_nb.renderers:default |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Describe the bug
context
I'm trying to package your module as the rpm package.
Part of that process is building sphinx based documentation as man page (ad on all unixes man page is still most basic forrm of the documentation).
expectation
Should be possible to generate MyST-NB documentation as the man page.
bug
sphinx fails with:
problem
I suppose that myst-mb has not finished backend generating roff output.
Reproduce the bug
tox -e docs-update man
List your environment
list of modules installed in build env:
The text was updated successfully, but these errors were encountered: