我面临着这个问题中讨论的同样的问题:Furo Sphinx 主题在 API 文档中大写过多 https://stackoverflow.com/questions/69873561/furo-sphinx-theme-uppercases-too-much-in-api-documentation/70085598?noredirect=1#comment123892117_70085598。然而,接受的解决方案不起作用,Furo 模板似乎以某种方式覆盖了custom.css
:
我感谢任何帮助在中实现这个简单的定制风吕狮身人面像主题 https://pradyunsg.me/furo/quickstart/.
Note:该问题已在 Furo 2022.1.2 中修复。
好吧,尽管上一个问题只有两周多一点,但已经有五个新问题了Furo 的发布 https://pypi.org/project/furo/#history自那以后。我假设您使用的是最新版本,截至撰写本文时为 2021 年 11 月 23 日。
之前答案中的解决方法实际上不再有效。这是因为 Furo 使 CSS 选择器更加具体这次提交 https://github.com/pradyunsg/furo/commit/8e5f49940eab0c93e5c762a43f05fec215b190b5#diff-8375a7d86372a32d2fec90c68d941fca829dc3e33f20a76d2bdbd9f58d314988, 意思是它优先 https://stackoverflow.com/a/25105841超过由自定义样式定义的不太具体的样式。
The custom.css
因此需要更多的魅力:
dl.py .field-list dt {
text-transform: none !important;
}
这只是一种解决方法,而且不一定是最好的方法。还应该有一种方法只选择参数和类型,但保持“参数”标题不变。
然而,Furo 的作者最好地解决了这个问题。我之前已经举报过here https://github.com/pradyunsg/furo/discussions/296,但尚未收到回复。正如我在那里指出的,您的另一个选择是使用以下命令呈现 NumPy 样式的文档字符串Napoleon https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html代替Numpydoc https://numpydoc.readthedocs.io。它们在页面上看起来会有所不同,但大小写问题将消失。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)