我已经为一本 jupyter 书籍构建了一个 github 存储库。 目前,我的重点是在开始写作之前将所有结构准备就绪。
当我从本地存储库(在 docs 文件夹中)查看 html 页面时,它们具有我想要的外观。 有一个有用的侧边栏,看起来像:
当我在 github 页面上查看它们时 侧边栏功能失调。 它缺少一些图像,并且出现在正文上方而不是旁边。看起来像:
我不知道如何修复 github 页面视图。 据我所知,每个相关文件都在 github 上(我的 .gitignore 只忽略 .log 和 _build)。
问题是 html 期望文件夹
_static
位于同一目录中。
但是,默认情况下,github 页面会忽略以下划线开头的文件夹。 所以没有找到任何
.css
文件。
解决方案是将一个名为
.nojekyll
的空文件放入 docs
文件夹(或 github 页面来自的任何文件夹)中。 这会导致 github 页面包含下划线文件夹。