SQLLineage文档自定义sphinx_rtd_theme样式无效求助

• 确认静态文件路径
  Sphinx默认读取docs/source/static文件夹下的静态资源，需将custom.css放在这个路径下，而非项目根目录的static文件夹。

• 清理缓存后重新构建
  修改样式或配置后，先删除docs/_build文件夹，再执行构建命令（如sphinx-build -b html docs/source docs/_build/html），避免旧缓存导致样式不更新。

• 提高自定义CSS选择器优先级
  默认主题样式优先级较高，需用更具体的选择器强制覆盖。以下是匹配你需求的示例代码：

  /* 修改顶部导航栏为黑色背景 */
  .wy-nav-top {
      background-color: #000 !important;
  }
  
  /* 修改侧边栏搜索区域为黑色背景 */
  .wy-side-nav-search {
      background-color: #000 !important;
  }
  
  /* 修改DAG背景为黑色，节点为白色 */
  .sqllineage-dag svg {
      background-color: #000 !important;
  }
  .sqllineage-dag .node circle {
      fill: #fff !important;
  }
  

  添加!important可确保自定义样式覆盖默认规则。

• 检查conf.py配置正确性

  1. 确保html_css_files配置在html_theme之后设置：

     html_theme = "sphinx_rtd_theme"
     html_css_files = ['custom.css']
     

  2. 测试html_logo时，需保证图片路径正确。若图片放在docs/source/static/a.png，配置应为：

     html_logo = 'static/a.png'
     

     构建后可检查_build/html/_static目录，确认图片是否被正确复制。

• 注意主题配置项的有效性
  SQLLineage默认使用的sphinx_rtd_theme没有bgcolor这个配置项，因此之前的设置无效。导航栏和背景样式必须通过自定义CSS实现，而非html_theme_options。

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