导航栏遮盖的内部参考目的地

Internal reference destinations obscured by navbar

我一直在我的 Sphinx 文档中广泛使用 internal references 以使其更易于导航。

虽然引用工作正常,但我注意到它们没有将读者带到目标页面上的正确位置,因为它被导航栏遮挡了。

点击我的:ref:后进入以下章节:

点击我的 :ref: 到下面的章节后 隐藏导航栏:

如您所见,隐藏导航栏后,它会将读者带到正确的位置(页眉位于页面顶部)。

我使用的是 Sphinx bootstrap 主题,但我也注意到默认主题会出现此问题。即使我删除了自定义 CSS.

也是如此

其他人能重现这个问题吗?有人知道如何解决吗?

如有任何帮助,我们将不胜感激!

这是基于 Twitter Bootstrap 的主题的问题,已在其 issue tracker 中报告。没有 "best" 或 "easy" 解决方案,因为这取决于您的偏好。