executablebooks / quantecon-mini-example Goto Github PK

The current plan is for this mini project to be a starting point for users of the CLI, who are encouraged to download, build and view it. The project will feature in the docs as an example that helps people get started quickly.

Discussion is here: executablebooks/meta#46

Here's how they look now.

We already have glue, citations, numbered eqs. What else do we want to add before we go ahead? I would like to see numbered figs with references to them.

What do others want? CC @choldgraf @najuzilu @mmcky

(There are also some small bugs like the TOC appearing twice in the left hand menu and figures not being properly centered.)

Looks like server can't find the CSS in gh-pages branch:

https://executablebookproject.github.io/quantecon-mini-example/docs/index.html

As a good test case we should add nightly builds of the PDF using jupyter-book

In a previous version, the title under the sidebar Scientific Python QuickStart had a different font size from its subcategories to indicate the structure of the toctree. If I remember correctly it was the same font size as the header key. This is not the case for our current example:

I also find it strange that index.md shows up on the sidebar. I would expect that if the user wants to go back to the landing page, clicking on the logo should take them there.

@jstac do you have any thoughts on the above?

As @denigomonov noticed (executablebooks/jupyter-book#907 (comment)) --
jb build mini_book is failing with current master due to a utf-8 encoding error. Last time this happened, the problem originated in jupyter-sphinx and was triggered by an executable cell with a greek letter variable. To reproduce with most recent commits for all executable book packages, I used https://github.com/eoas-ubc/quantecon-mini-example/blob/windows_dev/environment_dev.yml. The error message is:
https://github.com/eoas-ubc/quantecon-mini-example/blob/windows_dev/encoding_error_log.txt (the same error occurs with the qe-mini-example-environment)

I can't figure out why the the code cells in quantecon-mini-example are missing (see example). They're rendered locally (see screenshot). Since the workflow is not implemented in quantecon-example, I can see the outputs render there just fine (example). This is site-wide.
I wonder if it's a workflow thing. @mmcky: do you think that's possible?

Following the steps from demo book on https://jupyterbook.org/intro.html

When running the following command (in anaconda prompt on Windows 10 PC):

(wintest) C:\Users\luuka\quantecon-mini-example>jupyter-book build ./mini_book

It returns the following output and error:

Running Jupyter-Book v0.8.3
Traceback (most recent call last):
File “c:\users\luuka\anaconda3\envs\wintest\lib\runpy.py”, line 193, in _run_module_as_main
“main”, mod_spec)
File “c:\users\luuka\anaconda3\envs\wintest\lib\runpy.py”, line 85, in run_code
exec(code, run_globals)
File "C:\Users\luuka\Anaconda3\envs\wintest\Scripts\jupyter-book.exe_main.py", line 7, in
File “c:\users\luuka\anaconda3\envs\wintest\lib\site-packages\click\core.py”, line 829, in call
return self.main(*args, **kwargs)
File “c:\users\luuka\anaconda3\envs\wintest\lib\site-packages\click\core.py”, line 782, in main
rv = self.invoke(ctx)
File “c:\users\luuka\anaconda3\envs\wintest\lib\site-packages\click\core.py”, line 1259, in invoke
return process_result(sub_ctx.command.invoke(sub_ctx))
File “c:\users\luuka\anaconda3\envs\wintest\lib\site-packages\click\core.py”, line 1066, in invoke
return ctx.invoke(self.callback, **ctx.params)
File “c:\users\luuka\anaconda3\envs\wintest\lib\site-packages\click\core.py”, line 610, in invoke
return callback(*args, **kwargs)
File "c:\users\luuka\anaconda3\envs\wintest\lib\site-packages\jupyter_book\commands_init.py", line 199, in build
build_modified = max([os.stat(ii).st_mtime for ii in build_files])
ValueError: max() arg is an empty sequence

Does anybody have an idea what I could do to fix this?

Thanks in advance.

• Python Version: 3.7.9
• Package versions or output of jupyter-book --version:
  Jupyter Book: 0.8.3
  MyST-NB: 0.10.1
  Sphinx Book Theme: 0.0.39
  MyST-Parser: 0.12.10
  Jupyter-Cache: 0.4.1
  NbClient: 0.5.1
• Operating System: Windows 10

I realized the following when I tried to reproduce the example.

line 7: (a is missing in activate)
2. conda activte quantecon-mini-example

line 10:
jb build book/ -----> jb build mini_book/
jb clean book/ -----> jb clean mini_book/
jb clean --all book/ -----> jb clean --all mini_book/

line 14:
mni_ is missing like line 10

In here, the top-right corner On this page navigation menu does not open for md files with subsection heads even if a mouse cursor hovers over it.

I also cloned this repo, successfully reproduced the quantecon-mini-example, and then added a ipynb file with a section head and several subsection heads. But again the On this page menu is not "activated". Are there any option to activate it?

The tableofcontents directive is currently in progress. Once it has been finalized, we should include this directive under index.md.

Information regarding the progress of the directive can be found here.

Pressing the rocket button at the top of this website is supposed to show a corresponding Binder page. But it shows 404 : Not Found.