You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

能否在sphinx_toolbox.collapse折叠块中添加文本格式?

Sphinx Toolbox Collapse扩展标题格式化解决方案
  • 问题核心:collapse扩展的标题默认遵循reStructuredText语法规则,Markdown风格的*/**标记无法直接解析,自定义角色需确保CSS生效且语法正确。

  • 可行解决办法:

    1. 使用reStructuredText原生内联角色
      直接借助Sphinx内置的:strong:(加粗)和:emphasis:(斜体)角色,无需额外配置:

      .. collapse:: :strong:`id`: :emphasis:`String`
          这里是折叠的内容
      
    2. 自定义角色配合CSS
      先在文档中声明自定义角色,同时在Sphinx主题的CSS文件中添加对应样式:

      .. role:: bold
         :class: bold
      
      .. role:: italic
         :class: italic
      
      .. collapse:: :bold:`id` :italic:`String`
          这里是折叠的内容
      

      CSS样式示例(添加到主题的自定义CSS中):

      .bold { font-weight: 700; }
      .italic { font-style: italic; }
      
    3. Markdown文档兼容(需m2r2等插件)
      若使用Markdown格式编写文档,可尝试用引号包裹标题,确保插件解析内联标记:

      .. collapse:: "**id**: *String*"
          这里是折叠的内容
      

内容的提问来源于stack exchange,提问作者Yerushalmi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.05 11:05:22