使用 jupyter book 让侧边栏在 github 页面上工作

问题描述 投票:0回答:1

我已经为一本 jupyter 书籍构建了一个 github 存储库。 目前,我的重点是在开始写作之前将所有结构准备就绪。

当我从本地存储库(在 docs 文件夹中)查看 html 页面时,它们具有我想要的外观。 有一个有用的侧边栏,看起来像:

The html file from my local repository

当我在 github 页面上查看它们时 侧边栏功能失调。 它缺少一些图像,并且出现在正文上方而不是旁边。看起来像: the page as it appears on github pages

我不知道如何修复 github 页面视图。 据我所知,每个相关文件都在 github 上(我的 .gitignore 只忽略 .log 和 _build)。

css github-pages sidebar jupyterbook
1个回答
1
投票

问题是 html 期望文件夹

_static
位于同一目录中。

但是,默认情况下,github 页面会忽略以下划线开头的文件夹。 所以没有找到任何

.css
文件。

解决方案是将一个名为

.nojekyll
的空文件放入
docs
文件夹(或 github 页面来自的任何文件夹)中。 这会导致 github 页面包含下划线文件夹。

© www.soinside.com 2019 - 2024. All rights reserved.