Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork7.9k
DOC: Suppress IPython output in examples and tutorials where not needed#23978
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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Uh oh!
There was an error while loading.Please reload this page.
Conversation
By default, sphinx-gallery captures the last output of each code blockand shows it in the generated html in yellow boxes. Especially intutorials with a frequently interleaving code and text blocks this mayappear confusing and reduces readability. In some cases, however, theoutput is desired (although it could always be replaced by printing).The global configuration is now changed to "capture nothing", for onetutorial with multiple desired outputs this is overridden in the fileto show the output and in other cases with just one desired outputit's converted to a call to print().
I am very surprised that we only had ~2 cases where the output was valuable and intentials. I'm inclined to merge but not back port this so we have a while for any issues to be found in the devdocs. |
StefRe commentedSep 21, 2022 • edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
Me too - if I had known earlier I wouldn't have madesphinx-gallery/sphinx-gallery#891. It turned out, however, that practically in all cases, where the output is intentional, it was already produced by |
I'm also surprised, but this
makes sense.
Do we read the devdocs so thoroughly that we would find possible issues? While I do a lot of docs stuff, I would not claim for me that I would find a significant fraction of such issues if they existed. I therefore would be happy to backport. |
…s and tutorials where not needed
…978-on-v3.6.xBackport PR#23978 on branch v3.6.x (DOC: Suppress IPython output in examples and tutorials where not needed)
PR Summary
By default, sphinx-gallery captures the last output of each code block and shows it in the generated html in yellow boxes. Especially in tutorials with frequently interleaving code and text blocks this may appear confusing and reduces readability. In some cases, however, the output is desired (although it could always be replaced by printing).
The global configuration is now changed to "capture nothing", for one tutorial with multiple desired outputs this is overridden in the file to show the output and in other cases with just one desired output it's converted to a call to print().
(I went through all the examples and tutorials by searching the generated rst files for
.. rst-class:: sphx-glr-script-out
to see if we need the generated output, hopefully I didn't overlook some desired output)This PR addresses this#21794 (comment):
PR Checklist
Tests and Styling
pytest
passes).flake8-docstrings
and runflake8 --docstring-convention=all
).Documentation
doc/users/next_whats_new/
(follow instructions in README.rst there).doc/api/next_api_changes/
(follow instructions in README.rst there).