导航栏遮挡的内部参考目标

Question

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

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

点击我的:ref:后进入下一章：

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

如您所见，当导航栏被隐藏时，它会将读者带到正确的位置（标题位于页面顶部）。

我正在使用 Sphinx 引导主题，但我也注意到默认主题会出现此问题。即使我删除了我的自定义 CSS，也是如此。

其他人可以重现这个问题吗？有人知道如何解决吗？

任何帮助将不胜感激！

Answer 1

这是基于 Twitter Bootstrap 主题的问题，并在其 issue tracker 中报告。没有“最佳”或“简单”的解决方案，因为这取决于您的偏好。