python - 默认创建后 Jupyter Book 构建失败

Question

我仍在学习这一切是如何运作的，所以请多多包涵。

我在我的 Windows 10 机器上运行 conda 4.8.5。我认为我已经安装了所有必要的 Jupyter 扩展（Jupyter Lab、Jupyter Notebook、Jupyter Book、Node.js 及其依赖项）。

问题可能与我将 Miniconda 安装在单独的 (D:/) 驱动器上这一事实有关。

我已经设置了一个虚拟环境 (MyEnv)，其中包含该项目可能需要的所有包。这些是我遵循的步骤：

• 启动 CMD 窗口
• $ conda activate MyEnv
• $ jupyter-lab --notebook-dir "Documents/Jupyter Books"
• 此时会打开一个运行 Jupyter Lab 的浏览器选项卡
• 从 Jupyter Lab 的启动器中，打开一个终端
• $ cd "Documents/Jupyter Books"
• $ jb create MyCoolBook
• 在此目录中创建具有模板书内容的新文件夹（耶！）
• 无需编辑任何内容：$ jb build MyCoolBook
• 一个名为 _build 的文件夹被添加到MyCoolBook，但它只包含几个 CSS 文件。
• 终端抛出这个错误回溯，这对我没有多大帮助。对于有经验的用户来说，这个问题可能很明显。

我不确定如何进行。我已经重置了整个环境几次试图让它工作。你有什么建议？我正在考虑提交错误报告，但我想排除我很傻的非常合理的可能性。

标签： pythonjupyter-notebookjupyterpython-sphinxjupyter-lab

Answer 1

我在 Github 页面/论坛中询问了 Jupyter Book。原来这是 Windows 中的文本编码问题（我可以通过深入阅读文档来避免这种情况）。

如果有人遇到此问题，只需知道可以通过恢复到某个版本 Python 3.7.* 并设置环境变量 ( PYTHONUTF8=1) 来修复它，但我不建议这样做，因为其他一些包可能需要默认系统编码。相反，请按照文档本节中的说明进行操作。