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

Question

我制作了一个 sphinx 项目/文档（使用 alabaster 主题），左侧有一个固定的侧边栏（包含 TOC），但有太多内容无法在屏幕上显示。如何使该内容可滚动，同时仍允许右侧（正文）单独滚动？

我见过这个类似的问题，但只涉及您自己的网站，而不是 sphinx alabaster 主题文档。

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;
}

该代码使滚动条出现并且对我有用。这是最终结果的样子：