不要在狭窄 Windows 中显示阅读文档 Sphinx TOC

Question

使用窄 window，完整的阅读文档 window 显示内容，但是当 window 加宽时，Table 的内容显示为侧边栏，内容小于 window 宽度的一半。如何更改设置，以便 window 在显示 TOC 之前必须更宽？

我希望这个 framework 带有样式表、conf.py 参考和自定义布局可以与 source/_static 样式表中的适当 css 一起使用。变化：

.wy-nav-content {
    max-width: 1200px !important;
}

我假设这涉及测试屏幕宽度是否小于特定值，然后将 display_toc 设置为 false。类似于：

/* Set to display toc */
body {
  display_toc: true;
}

/* On narrow screens, set don't display toc */
@media screen and (max-width: 959px) {
  body {
    display_toc: false;
  }
}

Answer 1

sphinx_rtd_theme版本0.4.3 theme.css好像支持：

最大宽度的小屏幕：480px
中等屏幕最大宽度：768px
和更大的屏幕

我提取了 @media screen and (max-width: 768px) 代码并添加了新的宽度，如下所示。（我不知道 css 所以可能会有更高效的代码。）

在process之后，将custom.css文件放入html_static_path文件夹（默认为_static) 只需要 css，例如

@media screen and (max-width: 950px){
    .wy-body-for-nav{background:#fcfcfc}
    .wy-nav-top{display:block}
    .wy-nav-side{left:-300px}
    .wy-nav-side.shift{width:85%;left:0}
    .wy-side-scroll{width:auto}
    .wy-side-nav-search{width:auto}
    .wy-menu.wy-menu-vertical{width:auto}
    .wy-nav-content-wrap{margin-left:0}
    .wy-nav-content-wrap
    .wy-nav-content{padding:1.618em}
    .wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}
}

更改 conf.py 为 custom.css 添加 html_css_files 选项:

html_css_files = ['custom.css']

不要在狭窄 Windows 中显示阅读文档 Sphinx TOC

Don't Display Read the Docs Sphinx TOC in Narrow Windows

html

windows

themes

width

python-sphinx