I Fixed It
Contents
14. I Fixed It¶
When something does not work as expected, be sure to read the error message carefully. Oftentimes, the problem has been encountered by others. A Google search for the quoted error message may lead to an existing solution.
This is a collection of questions and answers during this semester, which could be helpful for others with the same problems.
14.1. TypeError when trying to build the Jupyter Book¶
14.1.1. Error in Question:¶
TypeError: asdict() got an unexpected keyword argument 'value_serializer'
14.1.2. Solution: Upgrade a package¶
The solution that worked for me came from this forum:
https://githubhelp.com/executablebooks/sphinx-external-toc/issues/49.
In the forum, it’s suggested that the package sphinx-external-toc
may be outdated and the current version does not meet the requirements
to build the book.
To solve this, you can use pip to update this package. Enter the following into the command line:
pip install --upgrade sphinx-external-toc
In my case I had to use pip3 install, but the idea should be the
same. Then, run jb build . again and the book should build without
error. This solution worked for me so hopefully it works for anyone
else who runs into this error!
14.2. ModuleNotFoundError when importing Cartopy into Jupyter Notebook¶
14.2.1. Error in Question¶
Sometimes when importing Cartopy into jupyter notebook after installing it, we will have an error message:
ModuleNotFoundError: No module named 'cartopy'
This might be due to a conflict between different environments.
14.2.2. Solution: Enter into a new environment¶
The simplest way is to use conda activate base to enter into the base environment of conda and reinstall Cartopy into that environment. (Use conda install -c conda-forge cartopy instead of pip. pip won’t install all the required dependencies of Cartopy so it will be a mess.) Then you can launch Jupyter Notebook in that environment and hopefully Cartopy can be imported now.