为什么 CSS 文件在 readthedocs 中不起作用？

Question

我在 readthedocs 网站上有我的应用程序的文档。我有一个 .css 文件可以改变侧边栏的外观。大约三个月前，这个 .css 文件运行良好，但现在不行了。这是 link.
这就是它的样子：

现在是这样：

.css 文件：

/* Fixes the size of the RTD flyout */
/* .rst-versions {
    width: 320px !important;
} */

/* Content area color */
.wy-nav-content {
    background: #dddddd;
}

/* Scroll Bar*/
.wy-side-scroll {
    width: auto;
    overflow-y: auto;
    margin-top: 0px;
}

/* width of the side panel */
.wy-nav-side {
    width: 320px;
}

/* content section full screen */
.wy-nav-content {
   max-width: none; 
}

/* set color of left side bar */
.wy-nav-side,.wy-side-nav-search,.wy-nav-top {
    /*background: #0079c1; /*005eb8 */
   background: #006464;
}

/* Change caption color to be more legible */
.wy-menu > .caption > span.caption-text {
   color: #ffcccc;
   font-size: 20px;
}

/* Change the version color to match caption color */
.wy-side-nav-search>div.version {
   color: #ffcccc;
}

/* Get rid of that ugly yellow highlight color and replace with something more appealing to the eye */
.highlight .hll {
   background-color: #fcfcfc;
}
/* 
@media screen and (max-width: 768px) {
    .wy-nav-content-wrap {
        margin-left: 0px;
    }
    .wy-nav-side {
        width: 500px;
    }
} */

这可能是什么原因？谢谢！

Answer 1

我部分确认@Steve Piercy 在评论中所说的内容。规则 .wy-menu > .caption > span.caption-text { 不再有效，因为 <span class="caption-text"> 周围的 <p> 不再有 caption class。您可以通过比较 latest with 1.3.4-branch.

来检查

但是，正如您从构建日志 (old, new) 中看到的那样，问题不在于 sphinx-rtd-theme（您在两者中都使用 0.5.0），而是 docutils 版本（旧版本为 0.16，新版本为 0.17）。您需要升级 Sphinx 版本或降级 docutils。

为什么 CSS 文件在 readthedocs 中不起作用？

why doesn't CSS file work in readthedocs?

css

documentation

read-the-docs