Jupyter Book Installation on Windows win32api Not Found Error

[Baalkikhaal]

Hi all,
I installed Jupyter Book using anaconda. The version details are

> jupyter-book --version
Jupyter Book: 0.10.2
MyST-NB: 0.12.3
Sphinx Book Theme: 0.1.0
MyST-Parser: 0.13.7
Jupyter-Cache: 0.4.2
NbClient: 0.5.3

I cloned the qauntecon-mini-example repository. Upon building the book I get following Warnings

• win32api not found ERROR

WARNING: E:\Databases\JupyterBookProjects\quantecon-mini-example\mini_book\docs\about_py.md
Traceback (most recent call last):
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_cache\executors\basic.py", line 141, in execute
    yield self.execute_single(
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_cache\executors\basic.py", line 154, in execute_single
    result = single_nb_execution(
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_cache\executors\utils.py", line 51, in single_nb_execution
    executenb(
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\client.py", line 1112, in execute
    return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute()
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\util.py", line 74, in wrapped
    return just_run(coro(*args, **kwargs))
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\util.py", line 53, in just_run
    return loop.run_until_complete(coro)
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\asyncio\base_events.py", line 616, in run_until_complete
    return future.result()
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\client.py", line 537, in async_execute
    async with self.async_setup_kernel(**kwargs):
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\async_generator\_util.py", line 34, in __aenter__
    return await self._agen.asend(None)
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\client.py", line 495, in async_setup_kernel
    await self.async_start_new_kernel(**kwargs)
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\client.py", line 407, in async_start_new_kernel
    await ensure_async(self.km.start_kernel(extra_arguments=self.extra_arguments, **kwargs))
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\nbclient\util.py", line 85, in ensure_async
    result = await obj
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_client\manager.py", line 657, in start_kernel
    kernel_cmd, kw = self.pre_start_kernel(**kw)
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_client\manager.py", line 286, in pre_start_kernel
    self.write_connection_file()
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_client\connect.py", line 466, in write_connection_file
    self.connection_file, cfg = write_connection_file(self.connection_file,
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_client\connect.py", line 136, in write_connection_file
    with secure_write(fname) as f:
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\contextlib.py", line 113, in __enter__
    return next(self.gen)
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_core\paths.py", line 461, in secure_write
    win32_restrict_file_to_user(fname)
  File "c:\users\fubar\anaconda3\envs\qe-mini-example\lib\site-packages\jupyter_core\paths.py", line 387, in win32_restrict_file_to_user
    import win32api
ImportError: DLL load failed while importing win32api: The specified module could not be found.

Do I need to add pywin32 module to my environment.yml file?

[Baalkikhaal]

I can resolve the error after following the page on Working on Windows. I installed the Jupyter-Book on a WSL2 Ubuntu 18.04 Python virtual environment with Python 3.8 from deadsnakes PPA repository. The dependencies are installed via pip (instead of conda) with the following requirements.txt file

sphinx
pandas
matplotlib
quantecon
jupyter-book

``
However I still get the following role and directive warnings

/home/fubar/JupyterBookProjects/quantecon-mini-example/mini_book/docs/about_py.md:33: WARNING: Unknown interpreted text role "cite".
/home/fubar/JupyterBookProjects/quantecon-mini-example/mini_book/docs/about_py.md:33: WARNING: Unknown interpreted text role "cite".
/home/fubar/JupyterBookProjects/quantecon-mini-example/mini_book/docs/about_py.md:138: WARNING: Unknown directive type "bibliography".

The jupyter-book version is

$ jupyter-book --version
Jupyter Book: 0.10.2
MyST-NB: 0.12.3
Sphinx Book Theme: 0.1.0
MyST-Parser: 0.13.7
Jupyter-Cache: 0.4.2
NbClient: 0.5.3

Please suggest what to do to get a working citation tool.

[choldgraf]

I believe that the quantecon mini book may not have been updated to work with the latest Jupyter Book syntax - @mmcky could you confirm this one way or another?

[mmcky]

I have just pushed an update to the _config.yml file for the latest bibtex syntax

executablebooks/quantecon-mini-example@d1ca7ce

@Baalkikhaal this should fix those warnings for you.

@choldgraf we need to update https://jupyterbook.org/content/citations.html to include the new _config.yml settings to register a bibtex file. I will set this up after jupyter-book/jupyter-book#1321 is merged as there are a lot of changes to the docs coming.

[Baalkikhaal]

@Baalkikhaal this should fix those warnings for you.

@mmcky Cool... Now the citation issue is fixed 😃 .