Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Psuedocode crashes build post merge #27

Open
glemieux opened this issue Nov 29, 2022 · 1 comment
Open

Psuedocode crashes build post merge #27

glemieux opened this issue Nov 29, 2022 · 1 comment
Labels
correction Corrections to existing grammar, spelling, context, etc

Comments

@glemieux
Copy link
Collaborator

glemieux commented Nov 29, 2022

Description

After successfully passing a pull request automated build test, the post-merge build fails.

Looking at the raw build output from readthedocs, this is failing in the post html build step where I think readthedocs is trying to render a PDF and EPUB version of the documentation.

Exception occurred:
  File "/home/docs/checkouts/readthedocs.org/user_builds/fates-users-guide/envs/latest/lib/python3.9/site-packages/docutils/nodes.py", line 2056, in unknown_departure
    raise NotImplementedError(
NotImplementedError: <class 'sphinx.writers.latex.LaTeXTranslator'> departing unknown node type: pseudocodeContentNode
The full traceback has been saved in /tmp/sphinx-err-8ma5ua57.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!

Suggested fix

Unknown at this time. Short term fix to try is to disable the PDF and EPUB builds.

@glemieux glemieux added the correction Corrections to existing grammar, spelling, context, etc label Nov 29, 2022
@glemieux
Copy link
Collaborator Author

glemieux commented Nov 30, 2022

Disabling the pdf and epub build option in the readthedocs.yaml config file alleviates the issue, so this is definitely a problem with the pseudo code generator and latex. I'm going to leave this open for now assuming that generating a pdf is ideal, although not necessary.

Potential future investigation should look at building the pdf directly through sphinx without the use of readthedocs to see if this fails in the same manner. Failing that it might be good to post to the pseudocode issues page.

  • Attempt to build pdf using latex without readthedocs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
correction Corrections to existing grammar, spelling, context, etc
Projects
None yet
Development

No branches or pull requests

1 participant