Skip to content
This repository has been archived by the owner on Jan 15, 2024. It is now read-only.

[BUGFIX]Disable nbsphinx plugin execute code chunks #1197

Merged
merged 1 commit into from
Apr 6, 2020

Conversation

chenw23
Copy link
Member

@chenw23 chenw23 commented Apr 4, 2020

Description

There are cases that we don't want to compute the results for the python code chunks in the .md files. So I added a configuration for disabling execute code chunks when converting .md files to .ipynb files. See #1191 #1192

However, the nbsphinx plugin of sphinx, which is in charge of reading .ipynb files for sphinx, automatically executes all chunks without output, which is opposite to what we want. So this pull request turns this feature off.

Turning this off won't have any side effect because all the ipynb files in this project resides in the docs/examples/ path and they are all converted from md files. So even if we want to compute the results, all the computation should be done in md2ipynb.py file and nbsphinx will still not compute code chunks in the normal process.

Checklist

Essentials

  • PR's title starts with a category (e.g. [BUGFIX], [MODEL], [TUTORIAL], [FEATURE], [DOC], etc)
  • Changes are complete (i.e. I finished coding on this PR)
  • All changes have test coverage
  • Code is well-documented

Changes

  • Feature1, tests, (and when applicable, API doc)
  • Feature2, tests, (and when applicable, API doc)

Comments

  • If this change is a backward incompatible change, why must this change be made.
  • Interesting edge cases to note here

cc @dmlc/gluon-nlp-team

@chenw23 chenw23 requested a review from a team as a code owner April 4, 2020 05:46
@codecov
Copy link

codecov bot commented Apr 4, 2020

Codecov Report

Merging #1197 into master will increase coverage by 0.09%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #1197      +/-   ##
==========================================
+ Coverage   87.32%   87.42%   +0.09%     
==========================================
  Files          81       81              
  Lines        7345     7345              
==========================================
+ Hits         6414     6421       +7     
+ Misses        931      924       -7     
Impacted Files Coverage Δ
src/gluonnlp/data/datasetloader.py 85.34% <0.00%> (+3.01%) ⬆️

@mli
Copy link
Member

mli commented Apr 4, 2020

Job PR-1197/1 is complete.
Docs are uploaded to http://gluon-nlp-staging.s3-accelerate.dualstack.amazonaws.com/PR-1197/1/index.html

@chenw23
Copy link
Member Author

chenw23 commented Apr 5, 2020

This pull request is complete and ready for merge

Copy link
Contributor

@leezu leezu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you

@leezu leezu merged commit ef59a37 into dmlc:master Apr 6, 2020
chenw23 pushed a commit to chenw23/gluon-nlp that referenced this pull request Apr 15, 2020
Now adopts the great new enhancements from dmlc#1191 , dmlc#1192 , dmlc#1193 , dmlc#1194 , dmlc#1195 , dmlc#1196 , dmlc#1197 , dmlc#1198 and dmlc#1120 .
The pull requests above fixed various errors in the previous make docs command and added new switch options. Now the commands mentioned in this documentation are strictly error-free.
chenw23 pushed a commit to chenw23/gluon-nlp that referenced this pull request Apr 15, 2020
Now adopts the great new enhancements from dmlc#1191 , dmlc#1192 , dmlc#1193 , dmlc#1195 , dmlc#1196 , dmlc#1197 , dmlc#1198 and dmlc#1200 .
The pull requests above fixed various errors in the previous make docs command and added new switch options. Now the commands mentioned in this documentation are strictly error-free.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants