QuantEcon / jupinx

Jupyter + Sphinx Utilities and Tools
https://quantecon.github.io/jupinx/
20 stars 4 forks source link

Can't start the website following the tutorial #93

Closed juanbono closed 4 years ago

juanbono commented 4 years ago

Hi! I downloaded jupinx via pip (it downloaded version 0.2.2) and after following the steps detailed in the tutorial I ran the command to build the website but it failed with the following error:

$ jupinx -w .                                                                                                          (16m 20s 268ms)  
Running: make website
Running Sphinx v2.3.1
making output directory... done
WARNING: html_static_path entry 'static' does not exist
building [mo]: targets for 0 po files that are out of date
building [jupyter]: targets for 3 source files that are out of date
updating environment: [new config] 3 added, 0 changed, 0 removed
reading sources... [100%] index                                                                                                          
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] index                                                                                                           
copying static files... copying static files to executed folder... 
done
Starting notebook execution for website and html conversion(if set in config)...

Exception occurred:
  File "/home/<user>/.pyenv/versions/3.7.0/lib/python3.7/site-packages/sphinxcontrib/jupyter/writers/execute_nb.py", line 125, in task_execution_time
    computing_time = time_tuple[2] - time_tuple[1]
KeyError: 2
The full traceback has been saved in /tmp/sphinx-err-wdeugawu.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!
make: *** [Makefile:44: website] Error 2

Do i need to do something before to get the website working?

AakashGfude commented 4 years ago

Hi @juanbono , sorry for the late reply and thank you for reporting this. This was caused due to an issue with one of the dependencies - dask, used in our sphinxcontrib-jupyter package, which is used under the hood by jupinx. Can you upgrade your sphinxcontrib-jupyter package using pip install --upgrade sphinxcontrib-jupyter , and let us know if the build is working now.

juanbono commented 4 years ago

Hi @AakashGfude , thank you for answering! I ran the command you told me and it worked! Here is the output

jupinx -w .                                                                                    (1) (1s 12ms) ┃
Running: make website
Running Sphinx v2.3.1
building [mo]: targets for 0 po files that are out of date
building [jupyter]: targets for 3 source files that are out of date
updating environment: [new config] 3 added, 0 changed, 0 removed
reading sources... [100%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] index
copying static files... copying static files to executed folder...
done
Starting notebook execution for website and html conversion(if set in config)...
(1/3)  demo_notebook -- pass -- 3.31s
(2/3)  index -- pass -- 1.34s
(3/3)  first_notebook -- pass -- 1.34s
WARNING: html folder not present in the themes directory
WARNING: coverage directory not found. Please ensure to run coverage build before running website build
build succeeded, 2 warnings.

After that i ran the commands to see the notebooks and the website and they worked as expected. So thank you very much!

AakashGfude commented 4 years ago

@juanbono That's great.