固定侧边栏内的狮身人面像雪花石膏主题滚动

Question

我制作了一个 sphinx 项目/文档（使用雪花石膏主题），其左侧有一个固定的侧边栏（包含目录），但屏幕上显示的内容太多。如何使该内容可滚动，同时仍允许右侧（主要文本）单独滚动？

我见过这个问题，它是类似的，但只涉及您自己的网站，而不是狮身人面像雪花石膏主题文档。

Answer 1

原来解决方案隐藏在这个github PR上。在

custom.css

文件夹中创建一个名为

_static

的文件。然后，在

conf.py

中添加以下代码：

html_static_path = ['_static']

它的作用是告诉 sphinx 覆盖默认的 CSS，允许您输入自己的 CSS。然后，在

custom.css

文件中添加以下代码：

div.sphinxsidebar {
    max-height: 100%;
    overflow-y: auto;
}

该代码使滚动条出现，这对我有用。最终结果如下：

Answer 2

由于 OP 使用

Alabaster

主题，因此使用主题选项

fixed_sidebar

有助于将侧边栏固定到顶部以及调用滚动条。

html_theme_options = {
    ...,
    'fixed_sidebar': True,
}

与 rel

0.7.16

检查，它有效。