Furo Sphinx 主题在 API 文档中保留过多的大写字母

2024-04-04

我面临着这个问题中讨论的同样的问题: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(使用前将#替换为@)

Furo Sphinx 主题在 API 文档中保留过多的大写字母 的相关文章

随机推荐

  • 更改文件长度时,是否需要重新映射所有关联的 MappedByteBuffer?

    我有一个小而简单的存储系统 可以通过内存映射文件进行访问 由于我需要处理超过 2GB 的空间 因此我需要一个具有固定大小 如 2GB 的 MappedByteBuffer 列表 由于不同原因 我使用的空间较少 那么一切都相对简单 一个缓冲区
  • Nuxt 3 中的深色模式切换器无法与官方 @nuxtjs/color-mode 配合使用

    我想使用 tailwind 和推荐的 nuxtjs color mdoe 模块在我的 Nuxt 应用程序上实现深色模式 测试顺风的黑暗 类运行良好并且按预期工作 但是我无法使按钮切换器以编程方式设置颜色模式 我在 devDeps 中安装了
  • 将 props 传递给包装在 withRouter() 函数中的 React 组件

    我正在使用 React Router v4 在我的 React 应用程序中导航 下面是包裹在withRouter 函数使其能够在单击时更改路线 const LogoName withRouter history props gt h1 gt
  • 如何使用perl脚本删除重复行

    如何删除重复行 我当前的代码 use strict use warnings my input input txt my output output txt my seen open OP gt output or die open IP
  • SSRS - 条件文本格式(使用 Switch 的表达式)

    我将首先说明这些表达式在报告中确实有效 问题是他们没有一起工作 我目前有一个基于两列值格式化的列标题 根据 Column1 的值使用斜体和下划线 基于 Column2 值的粗体和特定颜色 我通过在文本属性中使用 Switch 表达式来完成此
  • 在 Swift 中实例化并呈现 viewController

    Issue 我开始看Swift Programming Language 不知怎的 我无法正确输入 a 的初始化UIViewController从具体的UIStoryboard In Objective C我简单地写 UIStoryboar
  • 如何使用 FFmpeg 从图像创建视频? [关闭]

    Closed 这个问题是与编程或软件开发无关 help closed questions 目前不接受答案 Locked 这个问题及其答案是locked help locked posts因为这个问题是题外话 但却具有历史意义 目前不接受新的
  • Rails 应用程序在服务器上速度很快,但从另一台机器访问时速度很慢

    我有一个 Rails 应用程序托管在服务器计算机上 运行 Webrick 当我登录到这台计算机并访问该应用程序 通过 localhost 3000 时 该应用程序运行顺利 但是 当我尝试从另一台计算机 通过主机名 3000 访问该应用程序时
  • 删除一行中重复的相同字符

    我正在尝试创建一种方法 该方法可以从字符串中删除所有重复项 或者根据参数仅在一行中保留相同的 2 个字符 例如 helllllllo gt helo or helllllllo gt hello 这保留了双字母 目前我通过执行以下操作删除重
  • Django 使用 sqlite3 设置?

    我正在尝试按照 django 网站上的演练进行操作 我下载了 sqlite 并将其保存在C Windows System32文件夹 当我编辑settings py文件我该放什么Name场地 我必须建立数据库吗 django 文献说 API
  • 使用 postgres 窗口函数重复行

    postgres 文档 http www postgresql org docs 9 1 static tutorial window html http www postgresql org docs 9 1 static tutoria
  • Argparse:来自文件的默认值

    我有一个 Python 脚本 它需要很多参数 我目前使用的是configuration ini文件 使用读取configparser 但希望允许用户使用命令行覆盖特定参数 如果我只有两个参数 我会使用类似的东西 if not arg1 ar
  • Java 8中basic和url base64编码的区别

    Java 8Base64 http docs oracle com javase 8 docs api java util Base64 html库有两种可用于 URI 构建的变体 基本 变体和 URL 和文件名安全 变体 该文档指出RFC
  • 外部调用的 Lambda 函数超时

    我有一个 Lambda 函数 需要从中进行外部 API 调用 我已将 Lambda 函数添 加到一个安全组 一个 VPC 和 2 个子网 它为我提供了以下文本 当您启用 VPC 时 您的 Lambda 函数将失去默认互联网 使用权 如果您需
  • 如何将字符串转换为 android.net.Uri

    问题 我发现java net URI有一个 create String uri 选项 但是android net uri才不是 进一步来说 我正在尝试获取 RingtoneManager 的输出RingtonePicker并将其设置为默认铃
  • 导入数据和事件溯源

    我目前正在开发一个整体系统 我希望将其引入现代并结合 DDD 和 CQRS 我收到了重新编写解决方案的导入机制的请求 并认为这可能是开始此重新架构过程的好机会 目前流程是 用户上传 CSV 系统解析 CSV 并在屏幕上显示每一行 对每一行以
  • AsyncSupportListenerAdapter primefaces 异常

    我是 jsf 的新人 我正在尝试使用 inf primefaces 做一些示例 当我尝试运行这个示例时 http www primefaces org showcase labs push chat jsf http www primefa
  • Angular 4 HttpClient 查询参数

    我一直在寻找一种将查询参数传递到 API 调用中的方法HttpClientModule s HttpClient并尚未找到解决方案 与旧的Http模块你会写这样的东西 getNamespaceLogs logNamespace Setup
  • 无法读取 null 属性“样式” - Google 登录按钮

    我正在尝试为我的网站实施 Google 登录 登录按钮正确显示 并且最初可以很好地进行登录 当我在使用网站后注销并尝试移至登录页面 我使用的是 React 所以都是一页 时 就会出现问题 我使用完全相同的函数来呈现登录页面 但它给了我一个
  • Furo Sphinx 主题在 API 文档中保留过多的大写字母

    我面临着这个问题中讨论的同样的问题 Furo Sphinx 主题在 API 文档中大写过多 https stackoverflow com questions 69873561 furo sphinx theme uppercases to