使用Sphinx Alabaster主题如何在PC端扩大页面宽度？

针对你遇到的Alabaster主题内容宽度不足的问题，可按以下步骤排查解决：

• 确保自定义CSS正确加载
  默认conf.py可能未配置自定义CSS的加载，需添加以下配置：

  html_static_path = ['_static']
  html_css_files = ['custom.css']
  

  同时确保项目根目录下存在_static文件夹，custom.css文件放在该目录内。

• 使用Alabaster主题正确的CSS选择器
  .wy-nav-content是Read the Docs主题的选择器，Alabaster主题需用以下样式调整：

  /* 取消最大宽度限制，或自定义宽度 */
  .document {
      max-width: none;
      width: 90%; /* 可替换为你需要的百分比或固定值，比如1200px */
  }
  /* 或者直接调整内容主体 */
  div.body {
      max-width: 1200px;
  }
  

• 确认html_theme_options配置正确
  确保conf.py中html_theme_options是完整的字典格式，而非零散配置：

  html_theme_options = {
      'body_max_width': 'none',
      # 其他主题配置项可按需添加
  }
  

• 清理缓存并重新构建文档
  旧缓存可能导致样式不生效，执行以下命令后刷新浏览器（Ctrl+F5）：

  make clean
  make html
  

内容的提问来源于stack exchange，提问作者Andrew Frighi